coreui / coreui / 28369216000

95%

push

github

docs: migrate to the shared @coreui/astro-docs engine (#1104)

* feat(docs): migrate documentation to the shared Astro docs engine

Replace the Hugo-based docs site with the @coreui/astro-docs engine:
Astro content collections, live component examples, generated API tables,
and config-driven CDN/SRI placeholders.

* fix(docs): declare docs dependencies and remove old-generator leftovers

- Declare the published packages the docs import (@coreui icons/utils/
  internal-links/icon-react|vue/icons-pro/chart add-ons, react-imask, date-fns)
  and add the docs package version, so a plain yarn install builds the docs
  without the workspace yarn-link step (findSource reads base styling from the
  sibling library repo).
- Resolve @coreui/chartjs via require.resolve so it survives dependency hoisting.
- Drop the unused Gatsby remark plugin packages and dependency overrides, and
  the stale docs-old lint ignores.

* fix(docs): replace leftover Hugo template shortcodes

The vanilla migration left raw Hugo readFile/findRE shortcodes in four pages:
- css-variables: render the :root / dark-mode CSS variables with <ScssDocs>
  (reads _root.scss, the same build-time mechanism used elsewhere).
- browsers-devices: inline the .browserslistrc contents.
- validation, color-modes: inline the example scripts (validate-forms.js /
  color-modes.js) as code blocks.

* refactor(docs): author vanilla examples as a single code source

Replace the migrated <Example code={[line, …]} html={[line, …]}> line arrays
(the same markup duplicated in both props) with one multi-line code={`…`}
string per example, matching Bootstrap's docs: the first line sits on the
code={` line and continuation lines carry +2 indentation to offset MDX's
JSX-attribute dedent, so the rendered code keeps its natural indentation.
The engine renders that markup as the demo and shows it as the code.

* refactor(docs): drop redundant <Example> attributes

The engine now supplies what was constant on every example... (continued)

961 of 1064 branches covered (90.32%)

Branch coverage included in aggregate %.

2871 of 2975 relevant lines covered (96.5%)

242.25 hits per line