Skip to content

Conversation

@adrianschmidt
Copy link
Contributor

🚨 Test-PR for updates in Kompendium.

See jgroth/kompendium#150

@coderabbitai summary

Review:

  • Commits are atomic
  • Commits have the correct type for the changes made
  • Commits with breaking changes are marked as such

Browsers tested:

(Check any that applies, it's ok to leave boxes unchecked if testing something didn't seem relevant.)

Windows:

  • Chrome
  • Edge
  • Firefox

Linux:

  • Chrome
  • Firefox

macOS:

  • Chrome
  • Firefox
  • Safari

Mobile:

  • Chrome on Android
  • iOS

@coderabbitai
Copy link

coderabbitai bot commented Oct 19, 2025

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update-kompendium

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@adrianschmidt adrianschmidt force-pushed the update-kompendium branch 2 times, most recently from 9d7703d to 88e506c Compare November 2, 2025 22:57
After upgrading Kompendium (which upgraded TypeDoc from 0.17 to 0.23),
many types were missing from documentation. TypeDoc 0.23 changed how it
follows exports and removed the `isExported` flag.

Root cause:
- Examples import from '@limetech/lime-elements' causing circular imports
- Stencil's generated components.d.ts included these circular imports
- TypeDoc couldn't parse the entry point when tsconfig excluded dist/

Solution: Two-step build process
1. Build dist with stencil.config.dist.ts (excludes examples via tsconfig.dist.json)
2. Build docs with stencil.config.docs.ts (uses clean dist/types from step 1)

Changes:
- Update tsconfig.docs.json to include dist/types in TypeScript program
- Update docs:build script to run dist build before docs build
- Point both configs to dist/types/index.d.ts for consistent type resolution
- Remove duplicate exports from interface.ts already in components.d.ts
  (FormError, ValidationError, ValidationStatus, ListSeparator)
- Add explanatory comments to config files documenting the architecture

Result:
All public API types now documented (ChartItem, Tab, ListItem, FormSchema,
PickerValue, CustomColorSwatch, Link, etc.)

Dev build (npm start) will have imperfect docs due to circular imports
from examples, but production docs (npm run docs:build) are complete.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants