@nanisoft/prism-llms 0.4.0 → 0.5.0

package/dist/llms.txt

@@ -1,106 +1,110 @@
 # Prism
 
-> One design language, many expressions — Ant Design v6 components, blocks, and pages under the Prism theme. Apps always import from '@nanisoft/prism-ui', never from antd directly.
+> Prism is NaniSoft's design system: a token pipeline, a React component library, a documentation site and an agent surface. Import from '@nanisoft/prism-ui'; internal dependencies are never consumer imports.
 
-## Guides
+- [Full reference](https://prism.nanisoft.com/llms-full.txt): every page in this index expanded to its full specification.
+- [Agent skill](https://prism.nanisoft.com/prism-skill.md): the one-screen fast path.
 
-- [Brand policy](https://prism.nanisoft.com/md/docs/brand.md): What the MIT license covers, what it doesn't, and how the Prism and NaniSoft names may be used.
+## Overview
+
+- [Architecture](https://prism.nanisoft.com/overview/architecture.md): How Prism keeps tokens, the component library, the docs site and the agent surface on one source of truth.
+- [Brand policy](https://prism.nanisoft.com/overview/brand.md): What the MIT licence covers, what it does not, and how the Prism and NaniSoft names may be used.
+- [Composition](https://prism.nanisoft.com/overview/composition.md): Choose the smallest Prism layer that owns the job, and promote repetition upward only when it earns it.
+- [Quickstart](https://prism.nanisoft.com/overview/quickstart.md): Install Prism, load one stylesheet, choose a pack, and render your first Component and Block.
+- [Theming](https://prism.nanisoft.com/overview/theming.md): Packs and modes are two independent axes, delivered as markup attributes with no override path.
+- [Using LLMs](https://prism.nanisoft.com/overview/using-llms.md): Using LLMs against Prism: the corpus, the Markdown mirror and the read-only MCP endpoint, so an agent reads the same source the human documentation does.
+
+## Foundation
+
+- [Colors](https://prism.nanisoft.com/foundation/colors.md): The semantic colour contract and the foundation ramps behind it.
+- [Iconography](https://prism.nanisoft.com/foundation/iconography.md): Prism uses Lucide for interface icons, sized on the spacing scale.
+- [Motion](https://prism.nanisoft.com/foundation/motion.md): State feedback only, by token, with no entrance or scroll animation.
+- [Radii](https://prism.nanisoft.com/foundation/radii.md): One base radius drives the whole scale, derived as calc() multipliers.
+- [Shadows](https://prism.nanisoft.com/foundation/shadows.md): Exactly three authored elevation steps, all mode-independent.
+- [Spacings](https://prism.nanisoft.com/foundation/spacings.md): The authored spacing scale both layout and section rhythm use.
+- [Typography](https://prism.nanisoft.com/foundation/typography.md): Inter for the interface, the platform monospace stack for machine values.
+- [Variables](https://prism.nanisoft.com/foundation/variables.md): The full token browser: every semantic custom property and every foundation group.
+
+## Content
+
+- [About content](https://prism.nanisoft.com/content/about-content.md): What "content" means at NaniSoft, and the scope of this section.
+- [Audience](https://prism.nanisoft.com/content/audience.md): The three people NaniSoft product copy serves, and what each one needs from a sentence.
+- [Glossary](https://prism.nanisoft.com/content/glossary.md): Definitions for the terms used across Prism. The terms come from CONTEXT.md and this page hosts them.
+- [Product vocabulary](https://prism.nanisoft.com/content/product-vocabulary.md): The preferred spelling and casing of NaniSoft product terms, and the terms to avoid.
+- [Voice](https://prism.nanisoft.com/content/voice.md): NaniSoft's fixed voice qualities, and how tone shifts by context.
+- [Writing mechanics](https://prism.nanisoft.com/content/writing-mechanics.md): Capitalisation, punctuation, grammar and structure rules for NaniSoft product copy.
 
 ## Components
 
-- [Affix](https://prism.nanisoft.com/md/components/affix.md): antd Affix, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Alert](https://prism.nanisoft.com/md/components/alert.md): antd Alert, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Anchor](https://prism.nanisoft.com/md/components/anchor.md): antd Anchor, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [AutoComplete](https://prism.nanisoft.com/md/components/auto-complete.md): antd AutoComplete, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Avatar](https://prism.nanisoft.com/md/components/avatar.md): antd Avatar, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [BackTop](https://prism.nanisoft.com/md/components/back-top.md): antd BackTop, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Badge](https://prism.nanisoft.com/md/components/badge.md): antd Badge, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [BorderBeam](https://prism.nanisoft.com/md/components/border-beam.md): antd BorderBeam, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Breadcrumb](https://prism.nanisoft.com/md/components/breadcrumb.md): antd Breadcrumb, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Button](https://prism.nanisoft.com/md/components/button.md): antd Button, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Calendar](https://prism.nanisoft.com/md/components/calendar.md): antd Calendar, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Card](https://prism.nanisoft.com/md/components/card.md): antd Card, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Carousel](https://prism.nanisoft.com/md/components/carousel.md): antd Carousel, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Cascader](https://prism.nanisoft.com/md/components/cascader.md): antd Cascader, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Checkbox](https://prism.nanisoft.com/md/components/checkbox.md): antd Checkbox, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Col](https://prism.nanisoft.com/md/components/col.md): antd Col, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Collapse](https://prism.nanisoft.com/md/components/collapse.md): antd Collapse, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [ColorPicker](https://prism.nanisoft.com/md/components/color-picker.md): antd ColorPicker, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [DatePicker](https://prism.nanisoft.com/md/components/date-picker.md): antd DatePicker, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Descriptions](https://prism.nanisoft.com/md/components/descriptions.md): antd Descriptions, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [DisplayTitle](https://prism.nanisoft.com/md/components/display-title.md): Prism wrapper around antd Typography.Title (brand-behavior).
-- [Divider](https://prism.nanisoft.com/md/components/divider.md): antd Divider, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Drawer](https://prism.nanisoft.com/md/components/drawer.md): antd Drawer, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Dropdown](https://prism.nanisoft.com/md/components/dropdown.md): antd Dropdown, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Empty](https://prism.nanisoft.com/md/components/empty.md): antd Empty, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Flex](https://prism.nanisoft.com/md/components/flex.md): antd Flex, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [FloatButton](https://prism.nanisoft.com/md/components/float-button.md): antd FloatButton, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Form](https://prism.nanisoft.com/md/components/form.md): antd Form, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Grid](https://prism.nanisoft.com/md/components/grid.md): antd Grid, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Image](https://prism.nanisoft.com/md/components/image.md): antd Image, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Input](https://prism.nanisoft.com/md/components/input.md): antd Input, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [InputNumber](https://prism.nanisoft.com/md/components/input-number.md): antd InputNumber, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Layout](https://prism.nanisoft.com/md/components/layout.md): antd Layout, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [List](https://prism.nanisoft.com/md/components/list.md): antd List, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Listy](https://prism.nanisoft.com/md/components/listy.md): antd Listy, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Masonry](https://prism.nanisoft.com/md/components/masonry.md): antd Masonry, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Mentions](https://prism.nanisoft.com/md/components/mentions.md): antd Mentions, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Menu](https://prism.nanisoft.com/md/components/menu.md): antd Menu, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Modal](https://prism.nanisoft.com/md/components/modal.md): antd Modal, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Pagination](https://prism.nanisoft.com/md/components/pagination.md): antd Pagination, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Popconfirm](https://prism.nanisoft.com/md/components/popconfirm.md): antd Popconfirm, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Popover](https://prism.nanisoft.com/md/components/popover.md): antd Popover, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Progress](https://prism.nanisoft.com/md/components/progress.md): antd Progress, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [QRCode](https://prism.nanisoft.com/md/components/qrcode.md): antd QRCode, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Radio](https://prism.nanisoft.com/md/components/radio.md): antd Radio, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Rate](https://prism.nanisoft.com/md/components/rate.md): antd Rate, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Result](https://prism.nanisoft.com/md/components/result.md): antd Result, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Row](https://prism.nanisoft.com/md/components/row.md): antd Row, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Segmented](https://prism.nanisoft.com/md/components/segmented.md): antd Segmented, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Select](https://prism.nanisoft.com/md/components/select.md): antd Select, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Skeleton](https://prism.nanisoft.com/md/components/skeleton.md): antd Skeleton, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Slider](https://prism.nanisoft.com/md/components/slider.md): antd Slider, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Space](https://prism.nanisoft.com/md/components/space.md): antd Space, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Spin](https://prism.nanisoft.com/md/components/spin.md): antd Spin, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Splitter](https://prism.nanisoft.com/md/components/splitter.md): antd Splitter, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Statistic](https://prism.nanisoft.com/md/components/statistic.md): antd Statistic, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Steps](https://prism.nanisoft.com/md/components/steps.md): antd Steps, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Switch](https://prism.nanisoft.com/md/components/switch.md): antd Switch, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Table](https://prism.nanisoft.com/md/components/table.md): antd Table, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Tabs](https://prism.nanisoft.com/md/components/tabs.md): antd Tabs, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Tag](https://prism.nanisoft.com/md/components/tag.md): antd Tag, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Timeline](https://prism.nanisoft.com/md/components/timeline.md): antd Timeline, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [TimePicker](https://prism.nanisoft.com/md/components/time-picker.md): antd TimePicker, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Tooltip](https://prism.nanisoft.com/md/components/tooltip.md): antd Tooltip, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Tour](https://prism.nanisoft.com/md/components/tour.md): antd Tour, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Transfer](https://prism.nanisoft.com/md/components/transfer.md): antd Transfer, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Tree](https://prism.nanisoft.com/md/components/tree.md): antd Tree, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [TreeSelect](https://prism.nanisoft.com/md/components/tree-select.md): antd TreeSelect, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Typography](https://prism.nanisoft.com/md/components/typography.md): antd Typography, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Upload](https://prism.nanisoft.com/md/components/upload.md): antd Upload, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
-- [Watermark](https://prism.nanisoft.com/md/components/watermark.md): antd Watermark, unchanged — a pass-through re-export. Import from '@nanisoft/prism-ui'.
+- [Accordion](https://prism.nanisoft.com/components/accordion.md): The stack of headers that each reveal a panel in place.
+- [Alert](https://prism.nanisoft.com/components/alert.md): A static callout that carries an important message to the reader.
+- [Avatar](https://prism.nanisoft.com/components/avatar.md): The person or entity image with an initials fallback.
+- [Badge](https://prism.nanisoft.com/components/badge.md): A compact status or category label.
+- [Breadcrumb](https://prism.nanisoft.com/components/breadcrumb.md): The trail of ancestor links that shows where the current page sits.
+- [Button](https://prism.nanisoft.com/components/button.md): The action control for commands, links and loading states.
+- [Card](https://prism.nanisoft.com/components/card.md): A bordered surface for a small group of related content.
+- [Checkbox](https://prism.nanisoft.com/components/checkbox.md): The control for an independent yes-or-no choice, with an optional mixed state.
+- [CtaLink](https://prism.nanisoft.com/components/cta-link.md): The call to action that goes somewhere: a native link carrying the weight of a button.
+- [Diagram](https://prism.nanisoft.com/components/diagram.md): Named things and the labelled relations between them, drawn as inline vector markup whose every stroke and fill is a token.
+- [Dialog](https://prism.nanisoft.com/components/dialog.md): The modal surface for a decision or a short task, with a side-anchored sheet variant.
+- [DropdownMenu](https://prism.nanisoft.com/components/dropdown-menu.md): The menu of actions and choices opened from one trigger.
+- [FactList](https://prism.nanisoft.com/components/fact-list.md): A short list of named facts as a definition list, where a value may be a link and the term column stays aligned down its length.
+- [Field](https://prism.nanisoft.com/components/field.md): The labelled wrapper that pairs a form control with its label, description and error.
+- [Input](https://prism.nanisoft.com/components/input.md): The single-line text control for a form.
+- [Kbd](https://prism.nanisoft.com/components/kbd.md): The inline label for a keyboard key or shortcut.
+- [Pagination](https://prism.nanisoft.com/components/pagination.md): The control that moves between pages of a paged collection.
+- [Popover](https://prism.nanisoft.com/components/popover.md): The anchored floating surface for content richer than a tooltip.
+- [ProductMark](https://prism.nanisoft.com/components/product-mark.md): A product's two-part colour mark: a brand-ink ring around the pack's own fill, beside the product's name in the brand ink.
+- [ProductSwitcher](https://prism.nanisoft.com/components/product-switcher.md): A switch between the members of a set of products, each drawn with its own ProductMark and the current one marked aria-current.
+- [Progress](https://prism.nanisoft.com/components/progress.md): The bar that reports how far a task has progressed.
+- [Prose](https://prism.nanisoft.com/components/prose.md): Consumer-authored body copy held to the reading measure and to the block rhythm, so a document does not restate either.
+- [RadioGroup](https://prism.nanisoft.com/components/radio-group.md): The control that chooses exactly one option from a small visible set.
+- [Section](https://prism.nanisoft.com/components/section.md): The container and heading primitives every Block composes for rhythm.
+- [Select](https://prism.nanisoft.com/components/select.md): The control that chooses one option from a list that opens on demand.
+- [Separator](https://prism.nanisoft.com/components/separator.md): A hairline rule that divides content, horizontally or vertically.
+- [Skeleton](https://prism.nanisoft.com/components/skeleton.md): A placeholder surface that mirrors the shape of content while it loads.
+- [Slider](https://prism.nanisoft.com/components/slider.md): The control that chooses a number along a range.
+- [Switch](https://prism.nanisoft.com/components/switch.md): The control that turns a setting on or off immediately.
+- [Table](https://prism.nanisoft.com/components/table.md): The semantic table components for rows, columns and captions.
+- [Tabs](https://prism.nanisoft.com/components/tabs.md): The set of peer views shown one at a time.
+- [Textarea](https://prism.nanisoft.com/components/textarea.md): The multi-line text control for a form.
+- [Tooltip](https://prism.nanisoft.com/components/tooltip.md): The short label shown on hover or focus beside a control.
+- [Typography](https://prism.nanisoft.com/components/typography.md): The text and heading components that apply the type scale.
 
 ## Blocks
 
-- [ComponentDemo](https://prism.nanisoft.com/md/blocks/component-demo.md): Prism block — full documentation pending.
-- [PageHeader](https://prism.nanisoft.com/md/blocks/page-header.md): Prism block — full documentation pending.
-- [SiteFooter](https://prism.nanisoft.com/md/blocks/site-footer.md): Prism block — full documentation pending.
-- [SiteHeader](https://prism.nanisoft.com/md/blocks/site-header.md): Prism block — full documentation pending.
+- [AppShell01](https://prism.nanisoft.com/blocks/app-shell-01.md): A navigation shell with a desktop rail, a top bar and a mobile navigation sheet.
+- [AuthForm01](https://prism.nanisoft.com/blocks/auth-form-01.md): A sign-in card with labelled credential fields, a remember control and an error slot.
+- [Cta01](https://prism.nanisoft.com/blocks/cta-01.md): A closing call to action on a filled primary surface.
+- [DataTable01](https://prism.nanisoft.com/blocks/data-table-01.md): A table section with a toolbar, filters, row selection and pagination.
+- [FeatureGrid01](https://prism.nanisoft.com/blocks/feature-grid-01.md): A feature grid with optional icon tiles and a section heading.
+- [Hero01](https://prism.nanisoft.com/blocks/hero-01.md): A centered marketing hero with an optional eyebrow and one or two actions.
+- [InstrumentPanel01](https://prism.nanisoft.com/blocks/instrument-panel-01.md): A bordered panel with a titled bar, a state dot with the words beside it, and a slot for the instrument.
+- [LogoStrip01](https://prism.nanisoft.com/blocks/logo-strip-01.md): A single line of short phrases: the transition band between a hero and the section that follows it.
+- [NoteGrid01](https://prism.nanisoft.com/blocks/note-grid-01.md): A grid of short points: a title and a sentence or two, with no tile and no icon.
+- [PageHeader01](https://prism.nanisoft.com/blocks/page-header-01.md): A page title band with a breadcrumb trail, a supporting line and a row of actions.
+- [Pricing01](https://prism.nanisoft.com/blocks/pricing-01.md): A plan comparison with one highlighted tier.
+- [ProcessRail01](https://prism.nanisoft.com/blocks/process-rail-01.md): A process drawn as a rail: two, three or four steps on one line, each with an ordinal, a name and one caption.
+- [ProductGrid01](https://prism.nanisoft.com/blocks/product-grid-01.md): A set of products as hairline rows: a two-part ProductMark, a name, one tagline and a destination per row.
+- [SettingsPanel01](https://prism.nanisoft.com/blocks/settings-panel-01.md): A settings form grouped into sections of text, select and switch fields.
+- [SiteFooter](https://prism.nanisoft.com/blocks/site-footer.md): The block at the foot of a product site: a brand lockup, grouped destinations, the links that leave the site and a slot for the legal line.
+- [SiteHeader](https://prism.nanisoft.com/blocks/site-header.md): The bar at the top of a product site: a brand lockup, an optional product switcher, the site navigation and a slot for application controls.
+- [StackGrid01](https://prism.nanisoft.com/blocks/stack-grid-01.md): A survey of what a product is assembled from, and a second grid of what it built itself.
+- [Stats01](https://prism.nanisoft.com/blocks/stats-01.md): A KPI row with optional directional deltas.
+- [StatusLedger01](https://prism.nanisoft.com/blocks/status-ledger-01.md): A ledger of things and the state each is in: a name, one of four status tiers and the words for that tier.
 
 ## Pages
 
-- [BlogLayout](https://prism.nanisoft.com/md/pages/blog-layout.md): Prism page — full documentation pending.
-- [DocsShell](https://prism.nanisoft.com/md/pages/docs-shell.md): Prism page — full documentation pending.
-
-## Theming
-
-- [Blue pack · beam-dark](https://prism.nanisoft.com/md/theme/blue-dark.md): Theming reference for the blue pack in dark mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Blue pack · light](https://prism.nanisoft.com/md/theme/blue-light.md): Theming reference for the blue pack in light mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Green pack · beam-dark](https://prism.nanisoft.com/md/theme/green-dark.md): Theming reference for the green pack in dark mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Green pack · light](https://prism.nanisoft.com/md/theme/green-light.md): Theming reference for the green pack in light mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Lavender pack · beam-dark](https://prism.nanisoft.com/md/theme/lavender-dark.md): Theming reference for the lavender pack in dark mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Lavender pack · light](https://prism.nanisoft.com/md/theme/lavender-light.md): Theming reference for the lavender pack in light mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Peach pack · beam-dark](https://prism.nanisoft.com/md/theme/peach-dark.md): Theming reference for the peach pack in dark mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Peach pack · light](https://prism.nanisoft.com/md/theme/peach-light.md): Theming reference for the peach pack in light mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Rose pack · beam-dark](https://prism.nanisoft.com/md/theme/rose-dark.md): Theming reference for the rose pack in dark mode — the createPrismTheme snippet, token tiers, and the antd token lane.
-- [Rose pack · light](https://prism.nanisoft.com/md/theme/rose-light.md): Theming reference for the rose pack in light mode — the createPrismTheme snippet, token tiers, and the antd token lane.
+- [AuthPage](https://prism.nanisoft.com/pages/auth-page.md): A full authentication screen composing a sign-in form with an optional supporting card.
+- [BlogPostPage](https://prism.nanisoft.com/pages/blog-post-page.md): A complete blog post screen: title, standfirst, byline with both the display and the machine date, the body at the measure and the trail to the neighbouring posts.
+- [DashboardPage](https://prism.nanisoft.com/pages/dashboard-page.md): A full dashboard screen composing the app shell, a page header, a KPI row and a data table.
+- [MarketingPage](https://prism.nanisoft.com/pages/marketing-page.md): A complete marketing page composing a hero, a feature grid, a KPI row, a plan comparison and a closing call to action.
+- [NotFoundPage](https://prism.nanisoft.com/pages/not-found-page.md): A complete not-found screen: the status code as the heading of the page, one sentence about what happened, and the ways out.
+- [SettingsPage](https://prism.nanisoft.com/pages/settings-page.md): A full settings screen composing the app shell, a page header and tabs of grouped settings forms.
+
+## Changelogs
+
+- [@nanisoft/prism-llms](https://prism.nanisoft.com/changelogs/prism-llms.md): 0.5.0, 0.2.0, 0.1.0
+- [@nanisoft/prism-mcp-server](https://prism.nanisoft.com/changelogs/prism-mcp-server.md): 0.4.0, 0.2.0, 0.1.0
+- [@nanisoft/prism-tokens](https://prism.nanisoft.com/changelogs/prism-tokens.md): 0.6.0, 0.5.1, 0.5.0
+- [@nanisoft/prism-ui](https://prism.nanisoft.com/changelogs/prism-ui.md): 0.6.0, 0.5.1, 0.5.0

package/dist/markdown.d.ts

@@ -1,11 +1,16 @@
 /**
- * The MDX → Markdown lane (ticket 16 §2): the docs MDX is authoritative prose,
- * emitted to `.md` by stripping frontmatter and MDX machinery and replacing
- * each `ComponentDemo` element with that example's fenced TSX — lossless
- * because ticket 12's self-contained contract makes every demo one file.
+ * The MDX to Markdown lane and the fixed per-item spec renderers.
+ *
+ * The corpus reads raw MDX (ticket 12 section 2), strips mechanics itself, and
+ * emits one generated item spec into both the mirror file and `llms-full.txt`.
+ * The `## Props` body is a line-oriented definition list, not a table, because
+ * the MCP server's regular expression keys on the literal `## Props` heading.
+ *
+ * The separator between the definition-list fields is an em dash, which ticket
+ * 12 fixes as format. It is written as an escape so the source stays free of the
+ * typographic dash the repository bans in reader-facing copy.
  */
 import type { ExtractedInterface } from './extractor.js';
-/** Frontmatter prism-llms consumes — fumadocs defaults only (ticket 12 §3). */
 export interface DocMeta {
     title?: string;
     description?: string;
@@ -14,29 +19,70 @@ export interface ParsedMdx {
     data: DocMeta;
     body: string;
 }
-/** Parse `---`-delimited `key: value` frontmatter (the fumadocs default schema — no nesting). */
+/** Parse `---`-delimited `key: value` frontmatter (the fumadocs default schema). */
 export declare function parseMdx(raw: string): ParsedMdx;
-/** Inline code fences in the emitted Markdown. */
+/** A fenced code block; the trailing newline of the source is normalised away. */
 export declare function fence(code: string, language: string): string;
 /**
- * Replace every `<ComponentDemo id="…" [title="…"] />` element outside code
- * fences with that example's fenced TSX. `readDemo` returns the example source
- * (or undefined for an unknown id — a hard error: the cross-ref would be dead).
+ * Strip MDX machinery: top-level import statements and JSX comment markers.
+ * Fence-aware: a fenced import line is content (the page's own snippet), an
+ * MDX top-level import is machinery.
  */
-export declare function renderComponentDemos(body: string, readDemo: (id: string) => string | undefined): string;
+export declare function stripMdxMechanics(body: string): string;
 /**
- * Strip MDX machinery for the `.md` lane: import statements and JSX comment
- * markers. Fence-aware — fenced import lines are content (the copyable import
- * line of the page skeleton), MDX top-level imports are machinery.
+ * Drop one `## <heading>` section from a body, up to the next H2 heading. The
+ * `## Usage` section is dropped from the prose body because the import fence
+ * and the demo replace it in the fixed spec shape.
  */
-export declare function stripMdxMechanics(body: string): string;
-/** Render a Markdown table; cells are pipe-escaped and flattened. */
-export declare function renderTable(headers: readonly string[], rows: readonly (readonly string[])[]): string;
+export declare function stripSection(body: string, heading: string): string;
+/** The demo section: the title line, then the verbatim source in a `tsx` fence. */
+export declare function renderDemoSection(title: string, code: string): string;
+/**
+ * The `## Props` definition-list line, the fixed shape the MCP server parses:
+ * a bold-backtick prop name, its type in backticks, middle-dot separated
+ * `optional` or `required`, the default in backticks or an em dash, then a
+ * prose description.
+ */
+export declare function renderPropLine(prop: ExtractedInterface['props'][number]): string;
+export interface ParsedPropLine {
+    name: string;
+    typeText: string;
+    required: boolean;
+    defaultValue?: string;
+    description?: string;
+}
+/** Parse one definition-list line back into its four fields (the round-trip). */
+export declare function parsePropLine(line: string): ParsedPropLine | null;
+/**
+ * The aggregated definition-list body for an item's exports, one entry per
+ * line, de-duplicated by prop name across compound parts, with no blank lines.
+ */
+export declare function renderPropsBody(interfaces: readonly ExtractedInterface[]): string;
+/**
+ * The literal `## Props` section. When the item declares no own props, the
+ * documented seam line is emitted instead of an empty list.
+ */
+export declare function renderPropsSection(interfaces: readonly ExtractedInterface[], seam: string): string;
+export interface CompositionField {
+    key: string;
+    value: string;
+    description: string;
+}
+/** The `## Composition` section for a Block or a Page. */
+export declare function renderCompositionSection(fields: readonly CompositionField[]): string;
+export interface CrossReference {
+    heading: 'Blocks' | 'Pages';
+    links: ReadonlyArray<{
+        name: string;
+        href: string;
+    }>;
+}
+/** The `## Blocks` / `## Pages` cross-references, emitted last. */
+export declare function renderCrossReferences(references: readonly CrossReference[]): string;
 /**
- * The generated props section (ticket 12: API tables from the extractor, never
- * hand-written). Interfaces with no own props collapse to the antd seam line —
- * which is what a wrapper that adds nothing documents. Pass-throughs never
- * reach this function; their MDX carries the Extends pointer instead.
+ * The first line of the JSDoc block immediately preceding the default export,
+ * used as the demo's title. Falls back to a stable generated title.
  */
-export declare function renderPropsSection(interfaces: readonly ExtractedInterface[]): string;
-//# sourceMappingURL=markdown.d.ts.map
+export declare function demoTitle(source: string, fallback: string): string;
+/** Join the fixed per-item sections with the stable blank-line separator. */
+export declare function assembleDoc(sections: readonly (string | undefined)[]): string;

package/dist/markdown.js

@@ -1,4 +1,6 @@
-/** Parse `---`-delimited `key: value` frontmatter (the fumadocs default schema — no nesting). */
+const FIELD_SEPARATOR = ' \u2014 ';
+const NO_DEFAULT = '\u2014';
+/** Parse `---`-delimited `key: value` frontmatter (the fumadocs default schema). */
 export function parseMdx(raw) {
     const normalized = raw.replace(/\r\n/g, '\n');
     if (!normalized.startsWith('---\n'))
@@ -12,57 +14,23 @@ export function parseMdx(raw) {
         const match = /^(\w+):\s*(.*)$/.exec(line);
         if (!match)
             continue;
-        const value = (match[2] ?? '').replace(/^['"]|['"]$/g, '');
+        const value = (match[2] ?? '')
+            .replace(/^['"]|['"]$/g, '')
+            .replace(/\\"/g, '"')
+            .replace(/\\'/g, "'");
         if (match[1] === 'title' || match[1] === 'description')
             data[match[1]] = value;
     }
     return { data, body: normalized.slice(close + 4).replace(/^\n+/, '') };
 }
-/** Inline code fences in the emitted Markdown. */
+/** A fenced code block; the trailing newline of the source is normalised away. */
 export function fence(code, language) {
     return `\`\`\`${language}\n${code.replace(/\r\n/g, '\n').replace(/\n$/, '')}\n\`\`\``;
 }
 /**
- * Replace every `<ComponentDemo id="…" [title="…"] />` element outside code
- * fences with that example's fenced TSX. `readDemo` returns the example source
- * (or undefined for an unknown id — a hard error: the cross-ref would be dead).
- */
-export function renderComponentDemos(body, readDemo) {
-    const lines = body.replace(/\r\n/g, '\n').split('\n');
-    const out = [];
-    let inFence = false;
-    for (const line of lines) {
-        if (/^\s*```/.test(line)) {
-            inFence = !inFence;
-            out.push(line);
-            continue;
-        }
-        if (inFence) {
-            out.push(line);
-            continue;
-        }
-        const demo = /^\s*<ComponentDemo\s+([^>]*?)\/>\s*$/.exec(line);
-        if (!demo) {
-            out.push(line);
-            continue;
-        }
-        const id = /\bid=["']([^"']+)["']/.exec(demo[1] ?? '')?.[1];
-        if (!id)
-            throw new Error(`ComponentDemo element without an id attribute: ${line.trim()}`);
-        const code = readDemo(id);
-        if (code === undefined)
-            throw new Error(`ComponentDemo references unknown example id '${id}'`);
-        const title = /\btitle=["']([^"']+)["']/.exec(demo[1] ?? '')?.[1];
-        if (title)
-            out.push(`**${title}**`);
-        out.push(fence(code, 'tsx'));
-    }
-    return out.join('\n');
-}
-/**
- * Strip MDX machinery for the `.md` lane: import statements and JSX comment
- * markers. Fence-aware — fenced import lines are content (the copyable import
- * line of the page skeleton), MDX top-level imports are machinery.
+ * Strip MDX machinery: top-level import statements and JSX comment markers.
+ * Fence-aware: a fenced import line is content (the page's own snippet), an
+ * MDX top-level import is machinery.
  */
 export function stripMdxMechanics(body) {
     const kept = [];
@@ -82,37 +50,128 @@ export function stripMdxMechanics(body) {
         .replace(/^\n+/, '')
         .replace(/\s+$/, '');
 }
-/** Render a Markdown table; cells are pipe-escaped and flattened. */
-export function renderTable(headers, rows) {
-    const escape = (cell) => cell.replace(/\|/g, '\\|').replace(/\n+/g, ' ').trim();
-    const head = `| ${headers.map(escape).join(' | ')} |`;
-    const rule = `| ${headers.map(() => '---').join(' | ')} |`;
-    const body = rows.map((row) => `| ${row.map(escape).join(' | ')} |`);
-    return [head, rule, ...body].join('\n');
+/**
+ * Drop one `## <heading>` section from a body, up to the next H2 heading. The
+ * `## Usage` section is dropped from the prose body because the import fence
+ * and the demo replace it in the fixed spec shape.
+ */
+export function stripSection(body, heading) {
+    const lines = body.replace(/\r\n/g, '\n').split('\n');
+    const target = new RegExp(`^##\\s+${escapeRegExp(heading)}\\s*$`);
+    const kept = [];
+    let skipping = false;
+    for (const line of lines) {
+        if (target.test(line)) {
+            skipping = true;
+            continue;
+        }
+        if (skipping && /^##\s+/.test(line))
+            skipping = false;
+        if (!skipping)
+            kept.push(line);
+    }
+    return kept
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/^\n+/, '')
+        .replace(/\s+$/, '');
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** The demo section: the title line, then the verbatim source in a `tsx` fence. */
+export function renderDemoSection(title, code) {
+    return `**${title}**\n\n${fence(code, 'tsx')}`;
 }
-const NO_ADDITIONAL_PROPS = '_No additional props beyond the antd base component._';
 /**
- * The generated props section (ticket 12: API tables from the extractor, never
- * hand-written). Interfaces with no own props collapse to the antd seam line —
- * which is what a wrapper that adds nothing documents. Pass-throughs never
- * reach this function; their MDX carries the Extends pointer instead.
+ * The `## Props` definition-list line, the fixed shape the MCP server parses:
+ * a bold-backtick prop name, its type in backticks, middle-dot separated
+ * `optional` or `required`, the default in backticks or an em dash, then a
+ * prose description.
  */
-export function renderPropsSection(interfaces) {
-    const withProps = interfaces.filter((iface) => iface.props.length > 0);
-    if (withProps.length === 0)
-        return `## Props\n\n${NO_ADDITIONAL_PROPS}`;
-    const parts = ['## Props'];
-    for (const iface of withProps) {
-        if (withProps.length > 1)
-            parts.push(`### ${iface.typeName}`);
-        const rows = iface.props.map((prop) => [
-            `\`${prop.name}\`${prop.required ? '' : ' (optional)'}`,
-            prop.typeText,
-            prop.defaultValue ? `\`${prop.defaultValue}\`` : '—',
-            prop.description ?? '—',
-        ]);
-        parts.push(renderTable(['Prop', 'Type', 'Default', 'Description'], rows));
+export function renderPropLine(prop) {
+    const requirement = prop.required ? 'required' : 'optional';
+    const defaultValue = prop.defaultValue ? `\`${prop.defaultValue}\`` : NO_DEFAULT;
+    const description = prop.description ? `${FIELD_SEPARATOR}${prop.description}` : '';
+    return `**\`${prop.name}\`** \`${prop.typeText}\` · ${requirement} · default: ${defaultValue}${description}`;
+}
+/** Parse one definition-list line back into its four fields (the round-trip). */
+export function parsePropLine(line) {
+    const match = /^\*\*`([^`]+)`\*\* `([^`]+)` · (required|optional) · default: (?:`([^`]*)`|\u2014)(?:\s+\u2014\s+(.*))?$/.exec(line);
+    if (!match)
+        return null;
+    return {
+        name: match[1] ?? '',
+        typeText: match[2] ?? '',
+        required: match[3] === 'required',
+        ...(match[4] !== undefined ? { defaultValue: match[4] } : {}),
+        ...(match[5] !== undefined ? { description: match[5] } : {}),
+    };
+}
+/**
+ * The aggregated definition-list body for an item's exports, one entry per
+ * line, de-duplicated by prop name across compound parts, with no blank lines.
+ */
+export function renderPropsBody(interfaces) {
+    const seen = new Set();
+    const lines = [];
+    for (const iface of interfaces) {
+        for (const prop of iface.props) {
+            if (seen.has(prop.name))
+                continue;
+            seen.add(prop.name);
+            lines.push(renderPropLine(prop));
+        }
     }
-    return parts.join('\n\n');
+    return lines.join('\n');
+}
+/**
+ * The literal `## Props` section. When the item declares no own props, the
+ * documented seam line is emitted instead of an empty list.
+ */
+export function renderPropsSection(interfaces, seam) {
+    const body = renderPropsBody(interfaces);
+    return `## Props\n\n${body || seam}`;
+}
+/** The `## Composition` section for a Block or a Page. */
+export function renderCompositionSection(fields) {
+    const lines = fields.map((field) => `**\`${field.key}\`** \`${field.value}\`${FIELD_SEPARATOR}${field.description}`);
+    return `## Composition\n\n${lines.join('\n')}`;
+}
+/** The `## Blocks` / `## Pages` cross-references, emitted last. */
+export function renderCrossReferences(references) {
+    return references
+        .filter((reference) => reference.links.length > 0)
+        .map((reference) => `## ${reference.heading}\n\n${reference.links
+        .map((link) => `- [${link.name}](${link.href})`)
+        .join('\n')}`)
+        .join('\n\n');
+}
+/**
+ * The first line of the JSDoc block immediately preceding the default export,
+ * used as the demo's title. Falls back to a stable generated title.
+ */
+export function demoTitle(source, fallback) {
+    const exportIndex = source.search(/export\s+default/);
+    const before = source.slice(0, exportIndex >= 0 ? exportIndex : source.length);
+    const blocks = [...before.matchAll(/\/\*\*([\s\S]*?)\*\//g)];
+    const block = blocks.at(-1);
+    if (block) {
+        const first = (block[1] ?? '')
+            .split('\n')
+            .map((line) => line.replace(/^\s*\*?\s?/, '').trim())
+            .find(Boolean);
+        if (first)
+            return first;
+    }
+    return fallback;
+}
+/** Join the fixed per-item sections with the stable blank-line separator. */
+export function assembleDoc(sections) {
+    const joined = sections
+        .filter((section) => Boolean(section && section.trim()))
+        .join('\n\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/\s+$/, '');
+    return joined ? `${joined}\n` : '';
 }
-//# sourceMappingURL=markdown.js.map