@rtkelly-labs/design-system 0.0.0-bootstrap.0 → 0.16.0-dev.0.37dedac

package/dist/index.js

@@ -0,0 +1,117 @@
+// src/index.ts
+
+export { DEFAULT_LEVEL, FIXED_COLOURS, INK_WEIGHT, LEVELS, PALETTE_HUES, SYSTEM_LEVEL, THEME_LEVELS, assertNever, isThemeLevel, nextLevel } from "./theme/levels.js";
+import {
+  MEDIA,
+  CSS_MEDIUM,
+  MEDIA_DEFINITIONS,
+  isMedium
+} from "./theme/media.js";
+export { MAXIMUM_NEUTRAL_CHROMA, MINIMUM_RATIO, WEB_FLOOR, apcaContrast, auditContrast, auditHueAgreement, auditSelectionDevices, auditTextHierarchy, composite, contrastRatio, parseColor, relativeLuminance } from "./theme/contrast.js";
+import { ANSI_SLOTS, SLOTS, ansiScheme } from "./theme/ansi.js";
+export { HEADING_EMPHASIS, accentVar, borderVar, fontVar, semanticTokens, surfaceVar, textVar } from "./lib/theme.js";
+export { RECOMMENDED_COLOURS, RECOMMENDED_COLOUR_CLASSES, RECOMMENDED_COLOUR_NAMESPACES, RECOMMENDED_COLOUR_PROPERTIES, RECOMMENDED_COLOUR_ROLES, RECOMMENDED_COLOUR_VARS, getRecommendedColours, isRecommendedColourClass } from "./theme/recommended.js";
+import { cn } from "./lib/recipe.js";
+export { Slugger, childrenToText, slugify } from "./lib/slug.js";
+export { useCopyToClipboard } from "./hooks/useCopyToClipboard.js";
+export { useActiveHeading } from "./hooks/useActiveHeading.js";
+export { Button } from "./components/Button.js";
+export { Card } from "./components/Card.js";
+export { Badge } from "./components/Badge.js";
+export { ReportDetails, ReportDocument, ReportSection } from "./components/ReportDocument.js";
+import { TOKEN_RULES, scanRules, scanTokenRules } from "./lib/tokenRules.js";
+export { Avatar } from "./components/Avatar.js";
+export { PageTitle } from "./components/PageTitle.js";
+export { PageHeader } from "./components/PageHeader.js";
+export { Tag } from "./components/Tag.js";
+export { Pagination } from "./components/Pagination.js";
+export { Tabs, TabsList, TabsPanel, TabsTab } from "./components/Tabs.js";
+export { SectionContainer } from "./components/SectionContainer.js";
+export { DIVIDER_PATTERNS, Divider } from "./components/Divider.js";
+export { AsciiDivider } from "./components/AsciiDivider.js";
+export { ThemeProvider, useOptionalTheme, useTheme } from "./components/ThemeProvider.js";
+export { THEME_ATTRIBUTE, THEME_STORAGE_KEY, getThemeInitScript } from "./components/themeInitScript.js";
+export { BracketText } from "./components/BracketText.js";
+export { NoteBlock } from "./components/NoteBlock.js";
+export { TLDR } from "./components/TLDR.js";
+import { Input, TextArea } from "./components/Input.js";
+export { Select } from "./components/Select.js";
+export { Checkbox } from "./components/Checkbox.js";
+export { Switch } from "./components/Switch.js";
+export { Fieldset, Legend } from "./components/Fieldset.js";
+export { Radio, RadioGroup } from "./components/RadioGroup.js";
+export { ErrorSummary } from "./components/ErrorSummary.js";
+export { Swatch, SwatchGroup } from "./components/Swatch.js";
+export { StatCard } from "./components/StatCard.js";
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./components/Table.js";
+export { DataTable } from "./components/DataTable.js";
+export { Modal } from "./components/Modal.js";
+export { AlertDialog } from "./components/AlertDialog.js";
+export { Drawer } from "./components/Drawer.js";
+export { AppMain, AppShell, AppSidebar, AppSidebarNav, AppTopbar } from "./components/AppShell.js";
+export { Spinner } from "./components/Spinner.js";
+export { Skeleton } from "./components/Skeleton.js";
+export { Progress } from "./components/Progress.js";
+export { EmptyState } from "./components/EmptyState.js";
+export { NotFoundPage, ServerErrorPage, StatusPage } from "./components/StatusPage.js";
+export { Tooltip } from "./components/Tooltip.js";
+export { Popover } from "./components/Popover.js";
+export { Menu, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator } from "./components/Menu.js";
+import {
+  LinkProvider,
+  SiteLink,
+  isExternalHref,
+  useIsCurrentHref,
+  useLinkComponent
+} from "./components/LinkProvider.js";
+export { SiteHeader } from "./components/SiteHeader.js";
+export { SiteNav, SiteNavItem } from "./components/SiteNav.js";
+export { MobileNav } from "./components/MobileNav.js";
+export { SiteFooter } from "./components/SiteFooter.js";
+export { Hero } from "./components/marketing/Hero.js";
+export { Feature, FeatureGrid } from "./components/marketing/FeatureGrid.js";
+export { PricingGrid, PricingTier } from "./components/marketing/PricingGrid.js";
+export { CTASection } from "./components/marketing/CTASection.js";
+export { ToastProvider, useOptionalToast, useToast } from "./components/Toast.js";
+export { NERD_GLYPHS, NerdIcon } from "./components/NerdIcon.js";
+export { BlueskyIcon, GitHubIcon, LinkedInIcon, MailIcon, SocialIcon, XIcon } from "./components/SocialIcon.js";
+export { Glyph } from "./components/Glyph.js";
+export { AsciiGauge } from "./components/AsciiGauge.js";
+export { TelemetryGauge } from "./components/TelemetryGauge.js";
+export { TickerTape } from "./components/TickerTape.js";
+export { BarChart, ResponsiveChartContainer } from "./components/BarChart.js";
+export { Sparkline } from "./components/Sparkline.js";
+export { ChartTooltip, useChartTooltip } from "./components/ChartTooltip.js";
+export { BulletChart } from "./components/BulletChart.js";
+export { Slide } from "./components/slides/Slide.js";
+export { SLIDE_DECK_HOTKEYS, SlideDeck } from "./components/slides/SlideDeck.js";
+export { BlogPost } from "./components/blog/BlogPost.js";
+export { LoremIpsumPost } from "./components/blog/LoremIpsumPost.js";
+export { MetadataGrid } from "./components/MetadataGrid.js";
+export { TrackCard } from "./components/TrackCard.js";
+export { ColophonCard } from "./components/ColophonCard.js";
+export { DEFAULT_EXPERIMENTS, ExperimentsView } from "./components/experiments/ExperimentsView.js";
+export { DesignSandbox } from "./components/experiments/DesignSandbox.js";
+export { DEFAULT_DEPLOY_LOG, DEFAULT_PRICING_TIERS, SaasLandingPage } from "./components/saas/SaasLandingPage.js";
+export { ActivityGrid, AnchorHeading, BeforeAfter, Breadcrumbs, ChangeSummary, CodeBlock, CodeBlockAttachment, CodeTab, CodeTabs, Decision, DocPager, DocsHeader, DocsLayout, DocsLink, DocsLinkProvider, DocsSidebar, DrawingSheet, Event, FigureFrame, FileChangeTree, FlowDiagram, GanttChart, IndexedSection, Line, MetricStrip, Node, Option, Path, Prose, Slope, Step, Steps, SwatchCompare, TableOfContents, Term, TermGrid, Terminal, Timeline, TokenTable, TreeDiagram, UptimeStrip, collectHeadings, createAnchorHeading, mdxComponents, useDocsLinkComponent } from "./components/docs/index.js";
+export {
+  ANSI_SLOTS,
+  CSS_MEDIUM,
+  Input,
+  LinkProvider,
+  MEDIA,
+  MEDIA_DEFINITIONS,
+  SLOTS,
+  SiteLink,
+  TOKEN_RULES,
+  TextArea,
+  ansiScheme,
+  cn,
+  isExternalHref,
+  isMedium,
+  scanRules,
+  scanTokenRules,
+  useIsCurrentHref,
+  useLinkComponent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @rtkelly-labs/design-system main entrypoint\n\nexport * from './tokens';\n\n// The theme ladder — the single source for level names, level colours, and the\n// contrast arithmetic that gates them.\nexport * from './theme/levels';\nexport {\n  MEDIA,\n  CSS_MEDIUM,\n  MEDIA_DEFINITIONS,\n  isMedium,\n} from './theme/media';\nexport type {\n  Medium,\n  MediumDefinition,\n  TypeStep,\n  TypeStepName,\n  Motion,\n} from './theme/media';\nexport * from './theme/contrast';\nexport { ANSI_SLOTS, SLOTS, ansiScheme } from './theme/ansi';\nexport type { AnsiSlot, AnsiScheme, AnsiChrome } from './theme/ansi';\n\n// Semantic theming — prefer these over the raw palette in `tokens`.\nexport * from './lib/theme';\nexport * from './theme/recommended';\n// Only `cn` is public. `recipe`'s type comes from the library that implements\n// it, so exporting it would put that library back into the published .d.ts and\n// make replacing it a breaking change. Components import it directly.\nexport { cn } from './lib/recipe';\nexport type { ClassInput } from './lib/recipe';\nexport * from './lib/slug';\n\n// Hooks\nexport * from './hooks/useCopyToClipboard';\nexport * from './hooks/useActiveHeading';\n\n// Primitives & Callouts\nexport * from './components/Button';\nexport * from './components/Card';\nexport * from './components/Badge';\n// The report frame — the page a generated report is built in. Separate from\n// the docs components because a report is written by a tool and read once,\n// where a docs page is written by a person and read often: the frame owns the\n// measure, the header strip and the print behaviour, and everything inside it\n// is ordinary composition.\nexport * from './components/ReportDocument';\n\n// The colour-instead-of-role rules, and the scanner over them. Published\n// because a tool generating markup against this system should be able to hold\n// itself to the same rule the system holds itself to — the report generator\n// lints at budget zero with exactly these.\nexport { TOKEN_RULES, scanRules, scanTokenRules } from './lib/tokenRules';\nexport type { Finding, TokenRule } from './lib/tokenRules';\nexport * from './components/Avatar';\nexport * from './components/PageTitle';\nexport * from './components/PageHeader';\nexport * from './components/Tag';\nexport * from './components/Pagination';\n// The tablist. There is exactly one in this tree: `CodeTabs` renders through\n// it rather than hand-rolling a second keyboard model — see #240, and #163 for\n// why it is first-party rather than a wrapper over Base UI.\nexport * from './components/Tabs';\nexport * from './components/SectionContainer';\nexport * from './components/Divider';\nexport * from './components/AsciiDivider';\nexport * from './components/ThemeProvider';\n// Server-safe: a root layout calls `getThemeInitScript`, and that layout is a\n// server component under the Next App Router. See the module's header.\nexport * from './components/themeInitScript';\nexport * from './components/BracketText';\nexport * from './components/NoteBlock';\nexport * from './components/TLDR';\n// Named rather than `export *`: `Input.tsx` also exports the field recipe\n// `Select` draws its trigger with, and a recipe's type is `tailwind-variants`'.\nexport { Input, TextArea } from './components/Input';\nexport type { InputProps, TextAreaProps } from './components/Input';\n// One of a fixed set (#164): the same field as `Input`, with a listbox this\n// system paints instead of the operating system's, and `native` for the\n// platform picker when that is the better phone experience.\nexport * from './components/Select';\n// The booleans, added together: one capability in two presentations,\n// composing the same Field as the text controls above.\nexport * from './components/Checkbox';\nexport * from './components/Switch';\n// The groups (#239): `Fieldset` and `Legend` are the set's label, description\n// and error on the same Field contract, and `RadioGroup` / `Radio` are the\n// choose-one control built on that frame rather than beside it.\nexport * from './components/Fieldset';\nexport * from './components/RadioGroup';\n// The form-level half of validation (issue 50): the field errors above,\n// gathered at the top of the form as links that move focus to each field.\nexport * from './components/ErrorSummary';\nexport * from './components/Swatch';\nexport * from './components/StatCard';\nexport * from './components/Table';\nexport * from './components/DataTable';\nexport * from './components/Modal';\nexport * from './components/AlertDialog';\nexport * from './components/Drawer';\n\n// The application layout (#247): sidebar, topbar and main as five composable\n// pieces, with the sidebar off-canvas in a `Drawer` below desktop width.\nexport * from './components/AppShell';\n\n// System feedback — the three states an application has besides \"loaded\".\n// One vocabulary on purpose: the same motion tokens, the same reduced-motion\n// rule, the same muted surface, so a loading card and an empty table read as\n// the same system rather than as two consumers' guesses.\nexport * from './components/Spinner';\nexport * from './components/Skeleton';\nexport * from './components/Progress';\nexport * from './components/EmptyState';\n// The page-level states (#251) — 404, 500, maintenance, offline, unauthorized\n// — as `EmptyState` in a page frame, not a component family of their own.\nexport * from './components/StatusPage';\n\n// The floating set (#166): anchored to a trigger, positioned by the same\n// engine, dismissed by the same stack as the dialogs above. `Tooltip` labels,\n// `Popover` shows content, `Menu` offers actions.\nexport * from './components/Tooltip';\nexport * from './components/Popover';\nexport * from './components/Menu';\n\n// Site chrome (issue 246): the banner, the navigation in its two widths, and\n// the footer — layouts and landmarks that hold no items of their own. The\n// link adapter is the package's one, shared with the docs chrome: a router's\n// `Link` and its current-route test are injected once and reach both.\nexport {\n  LinkProvider,\n  SiteLink,\n  isExternalHref,\n  useIsCurrentHref,\n  useLinkComponent,\n} from './components/LinkProvider';\nexport type {\n  LinkComponentProps,\n  LinkProviderProps,\n  SiteLinkProps,\n} from './components/LinkProvider';\nexport * from './components/SiteHeader';\nexport * from './components/SiteNav';\nexport * from './components/MobileNav';\nexport * from './components/SiteFooter';\n\n// Marketing sections (issue 248): the parts a landing page is composed from.\n// Layouts that hold no copy — `SaasLandingPage` below is one composition of\n// them, and the `SaaS/LandingPage` stories build two more.\nexport * from './components/marketing/Hero';\nexport * from './components/marketing/FeatureGrid';\nexport * from './components/marketing/PricingGrid';\nexport * from './components/marketing/CTASection';\n\n// Transient notifications. Not an overlay: a toast shares neither the\n// positioning nor the dismissal model of Tooltip/Popover/Menu — it is a queue,\n// a live region and a lifetime (#243).\nexport * from './components/Toast';\n\nexport * from './components/NerdIcon';\nexport * from './components/SocialIcon';\nexport * from './components/Glyph';\n\n// Terminal & Monospace Telemetry Primitives\nexport * from './components/AsciiGauge';\nexport * from './components/TelemetryGauge';\nexport * from './components/TickerTape';\n\n// Chart Primitives & Trend Visualizers\nexport * from './components/BarChart';\nexport * from './components/Sparkline';\nexport * from './components/ChartTooltip';\nexport * from './components/BulletChart';\n\n// Slides & Presentation Deck Engine\nexport * from './components/slides/Slide';\nexport * from './components/slides/SlideDeck';\n\n// Blog & Editorial Post Foundations\nexport * from './components/blog/BlogPost';\nexport * from './components/blog/LoremIpsumPost';\nexport * from './components/MetadataGrid';\nexport * from './components/TrackCard';\nexport * from './components/ColophonCard';\n\n// Experiments Page & Design System Sandbox\nexport * from './components/experiments/ExperimentsView';\nexport * from './components/experiments/DesignSandbox';\n\n// SaaS Landing Pages\nexport * from './components/saas/SaasLandingPage';\n\n// Documentation Portal Chrome & MDX Rendering\nexport * from './components/docs';\n"],"mappings":";AAEA,cAAc;AAId,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,cAAc;AACd,SAAS,YAAY,OAAO,kBAAkB;AAI9C,cAAc;AACd,cAAc;AAId,SAAS,UAAU;AAEnB,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAMd,cAAc;AAMd,SAAS,aAAa,WAAW,sBAAsB;AAEvD,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,SAAS,OAAO,gBAAgB;AAKhC,cAAc;AAGd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AAMd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAKd,cAAc;AACd,cAAc;AACd,cAAc;AAMd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAKd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAKd,cAAc;AAEd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;","names":[]}

package/dist/lib/accentClasses.js

@@ -0,0 +1,87 @@
+// src/lib/accentClasses.ts
+var CANONICAL = {
+  primary: "accent-primary",
+  secondary: "accent-secondary",
+  tertiary: "accent-tertiary",
+  quiet: "accent-quiet",
+  info: "intent-info",
+  success: "intent-success",
+  warning: "intent-warning",
+  danger: "intent-danger"
+};
+function canonicalAccent(token, fallback = "primary") {
+  return CANONICAL[token ?? fallback] ?? CANONICAL.primary;
+}
+var TEXT = {
+  "accent-primary": "text-accent-primary",
+  "accent-secondary": "text-accent-secondary",
+  "accent-tertiary": "text-accent-tertiary",
+  "accent-quiet": "text-accent-quiet",
+  "intent-info": "text-intent-info",
+  "intent-success": "text-intent-success",
+  "intent-warning": "text-intent-warning",
+  "intent-danger": "text-intent-danger"
+};
+var FOCUS_RING = {
+  "accent-primary": "focus:border-accent-primary focus:ring-accent-primary",
+  "accent-secondary": "focus:border-accent-secondary focus:ring-accent-secondary",
+  "accent-tertiary": "focus:border-accent-tertiary focus:ring-accent-tertiary",
+  "accent-quiet": "focus:border-accent-quiet focus:ring-accent-quiet",
+  "intent-info": "focus:border-intent-info focus:ring-intent-info",
+  "intent-success": "focus:border-intent-success focus:ring-intent-success",
+  "intent-warning": "focus:border-intent-warning focus:ring-intent-warning",
+  "intent-danger": "focus:border-intent-danger focus:ring-intent-danger"
+};
+var FILL = {
+  "accent-primary": "bg-accent-primary text-content-inverse",
+  "accent-secondary": "bg-accent-secondary text-content-inverse",
+  "accent-tertiary": "bg-accent-tertiary text-content-inverse",
+  "accent-quiet": "bg-accent-quiet text-content-inverse",
+  "intent-info": "bg-intent-info text-content-inverse",
+  "intent-success": "bg-intent-success text-content-inverse",
+  "intent-warning": "bg-intent-warning text-content-inverse",
+  "intent-danger": "bg-intent-danger text-content-inverse"
+};
+var FILL_HOVER = {
+  "accent-primary": "hover:bg-accent-secondary",
+  "accent-secondary": "hover:bg-accent-tertiary",
+  "accent-tertiary": "hover:bg-accent-primary",
+  "accent-quiet": "hover:bg-accent-primary",
+  "intent-info": "hover:bg-accent-secondary",
+  "intent-success": "hover:bg-accent-secondary",
+  "intent-warning": "hover:bg-accent-tertiary",
+  "intent-danger": "hover:bg-accent-primary"
+};
+var HOVER_EDGE = {
+  "accent-primary": "hover:border-accent-primary hover:shadow-hard-accent-primary",
+  "accent-secondary": "hover:border-accent-secondary hover:shadow-hard-accent-secondary",
+  "accent-tertiary": "hover:border-accent-tertiary hover:shadow-hard-accent-tertiary",
+  "accent-quiet": "hover:border-accent-quiet hover:shadow-hard-accent-quiet",
+  "intent-info": "hover:border-intent-info hover:shadow-hard-intent-info",
+  "intent-success": "hover:border-intent-success hover:shadow-hard-intent-success",
+  "intent-warning": "hover:border-intent-warning hover:shadow-hard-intent-warning",
+  "intent-danger": "hover:border-intent-danger hover:shadow-hard-intent-danger"
+};
+function accentTextClass(token, fallback) {
+  return TEXT[canonicalAccent(token, fallback)];
+}
+function accentFocusClass(token, fallback) {
+  return FOCUS_RING[canonicalAccent(token, fallback)];
+}
+function accentHoverEdgeClass(token, fallback) {
+  return HOVER_EDGE[canonicalAccent(token, fallback)];
+}
+function accentFillClass(token, fallback) {
+  const role = canonicalAccent(token, fallback);
+  return `${FILL[role]} ${FILL_HOVER[role]}`;
+}
+var ACCENT_CLASS_MAPS = { TEXT, FOCUS_RING, HOVER_EDGE, FILL, FILL_HOVER };
+export {
+  ACCENT_CLASS_MAPS,
+  accentFillClass,
+  accentFocusClass,
+  accentHoverEdgeClass,
+  accentTextClass,
+  canonicalAccent
+};
+//# sourceMappingURL=accentClasses.js.map

package/dist/lib/accentClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/accentClasses.ts"],"sourcesContent":["/**\n * Accent tokens as Tailwind utility classes.\n *\n * `accentVar()` in `./theme` covers inline styles. Components built from\n * utility classes need the same mapping as literal class strings, because\n * Tailwind's scanner reads source text — a template literal like\n * `text-${role}` produces no CSS at all. Every class below is therefore\n * spelled out, and the 12 accepted tokens collapse onto 8 canonical roles\n * first so each map stays one entry per role rather than one per alias.\n */\n\nimport type { AccentToken } from './theme';\n\n/** The role an accent token names, as it appears in Tailwind class names. */\nexport type CanonicalAccent =\n  | 'accent-primary'\n  | 'accent-secondary'\n  | 'accent-tertiary'\n  | 'accent-quiet'\n  | 'intent-info'\n  | 'intent-success'\n  | 'intent-warning'\n  | 'intent-danger';\n\n/** Every accepted token mapped to its role. */\nconst CANONICAL: Record<AccentToken, CanonicalAccent> = {\n  primary: 'accent-primary',\n  secondary: 'accent-secondary',\n  tertiary: 'accent-tertiary',\n  quiet: 'accent-quiet',\n  info: 'intent-info',\n  success: 'intent-success',\n  warning: 'intent-warning',\n  danger: 'intent-danger',\n};\n\n/**\n * Resolve any accent token to its role. Mirrors `accentVar()`: an unrecognised\n * token degrades to the primary accent rather than throwing, so a mistyped prop\n * renders something legible instead of dropping the class entirely.\n */\nexport function canonicalAccent(\n  token: AccentToken | undefined,\n  fallback: AccentToken = 'primary',\n): CanonicalAccent {\n  return CANONICAL[token ?? fallback] ?? CANONICAL.primary;\n}\n\nconst TEXT: Record<CanonicalAccent, string> = {\n  'accent-primary': 'text-accent-primary',\n  'accent-secondary': 'text-accent-secondary',\n  'accent-tertiary': 'text-accent-tertiary',\n  'accent-quiet': 'text-accent-quiet',\n  'intent-info': 'text-intent-info',\n  'intent-success': 'text-intent-success',\n  'intent-warning': 'text-intent-warning',\n  'intent-danger': 'text-intent-danger',\n};\n\nconst FOCUS_RING: Record<CanonicalAccent, string> = {\n  'accent-primary': 'focus:border-accent-primary focus:ring-accent-primary',\n  'accent-secondary': 'focus:border-accent-secondary focus:ring-accent-secondary',\n  'accent-tertiary': 'focus:border-accent-tertiary focus:ring-accent-tertiary',\n  'accent-quiet': 'focus:border-accent-quiet focus:ring-accent-quiet',\n  'intent-info': 'focus:border-intent-info focus:ring-intent-info',\n  'intent-success': 'focus:border-intent-success focus:ring-intent-success',\n  'intent-warning': 'focus:border-intent-warning focus:ring-intent-warning',\n  'intent-danger': 'focus:border-intent-danger focus:ring-intent-danger',\n};\n\n/**\n * A filled chip: the role as a background, with `text.inverse` on it.\n *\n * `text.inverse` is why this is a map and not a template — `check:contrast`\n * measures `text.inverse` against every accent and intent precisely because\n * this pairing exists, so the two must not be able to disagree.\n */\nconst FILL: Record<CanonicalAccent, string> = {\n  'accent-primary': 'bg-accent-primary text-content-inverse',\n  'accent-secondary': 'bg-accent-secondary text-content-inverse',\n  'accent-tertiary': 'bg-accent-tertiary text-content-inverse',\n  'accent-quiet': 'bg-accent-quiet text-content-inverse',\n  'intent-info': 'bg-intent-info text-content-inverse',\n  'intent-success': 'bg-intent-success text-content-inverse',\n  'intent-warning': 'bg-intent-warning text-content-inverse',\n  'intent-danger': 'bg-intent-danger text-content-inverse',\n};\n\n/**\n * The hover fill, which deliberately names a *different* role from the one it\n * hovers off — `Tag` rotates through the emphasis accents so a row of chips\n * animates rather than merely dimming.\n *\n * Kept separate from {@link FILL} for that reason: every other map here emits\n * one role per token and is tested for it, and folding the rotation in would\n * have to relax that test for all of them. This is the one map where naming a\n * second role is the point rather than a bug.\n *\n * The rotation itself is a visual choice with no deeper rationale, which is\n * worth stating — it came from `Tag`, was the only table in the repo that had\n * it, and is now written once instead of being re-derived.\n */\nconst FILL_HOVER: Record<CanonicalAccent, string> = {\n  'accent-primary': 'hover:bg-accent-secondary',\n  'accent-secondary': 'hover:bg-accent-tertiary',\n  'accent-tertiary': 'hover:bg-accent-primary',\n  'accent-quiet': 'hover:bg-accent-primary',\n  'intent-info': 'hover:bg-accent-secondary',\n  'intent-success': 'hover:bg-accent-secondary',\n  'intent-warning': 'hover:bg-accent-tertiary',\n  'intent-danger': 'hover:bg-accent-primary',\n};\n\nconst HOVER_EDGE: Record<CanonicalAccent, string> = {\n  'accent-primary': 'hover:border-accent-primary hover:shadow-hard-accent-primary',\n  'accent-secondary': 'hover:border-accent-secondary hover:shadow-hard-accent-secondary',\n  'accent-tertiary': 'hover:border-accent-tertiary hover:shadow-hard-accent-tertiary',\n  'accent-quiet': 'hover:border-accent-quiet hover:shadow-hard-accent-quiet',\n  'intent-info': 'hover:border-intent-info hover:shadow-hard-intent-info',\n  'intent-success': 'hover:border-intent-success hover:shadow-hard-intent-success',\n  'intent-warning': 'hover:border-intent-warning hover:shadow-hard-intent-warning',\n  'intent-danger': 'hover:border-intent-danger hover:shadow-hard-intent-danger',\n};\n\n/** Foreground colour for an accent token. */\nexport function accentTextClass(token: AccentToken | undefined, fallback?: AccentToken): string {\n  return TEXT[canonicalAccent(token, fallback)];\n}\n\n/** Focus border + ring for form controls. */\nexport function accentFocusClass(token: AccentToken | undefined, fallback?: AccentToken): string {\n  return FOCUS_RING[canonicalAccent(token, fallback)];\n}\n\n/** Hover border + hard offset shadow, for cards that lift on hover. */\nexport function accentHoverEdgeClass(\n  token: AccentToken | undefined,\n  fallback?: AccentToken,\n): string {\n  return HOVER_EDGE[canonicalAccent(token, fallback)];\n}\n\n/** Exposed for tests, which assert every role is spelled out in every map. */\n/** Filled chip, with the hover rotation. */\nexport function accentFillClass(token: AccentToken | undefined, fallback?: AccentToken): string {\n  const role = canonicalAccent(token, fallback);\n  return `${FILL[role]} ${FILL_HOVER[role]}`;\n}\n\nexport const ACCENT_CLASS_MAPS = { TEXT, FOCUS_RING, HOVER_EDGE, FILL, FILL_HOVER } as const;\n"],"mappings":";AAyBA,IAAM,YAAkD;AAAA,EACtD,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,OAAO;AAAA,EACP,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AACV;AAOO,SAAS,gBACd,OACA,WAAwB,WACP;AACjB,SAAO,UAAU,SAAS,QAAQ,KAAK,UAAU;AACnD;AAEA,IAAM,OAAwC;AAAA,EAC5C,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAEA,IAAM,aAA8C;AAAA,EAClD,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AASA,IAAM,OAAwC;AAAA,EAC5C,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAgBA,IAAM,aAA8C;AAAA,EAClD,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAEA,IAAM,aAA8C;AAAA,EAClD,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAGO,SAAS,gBAAgB,OAAgC,UAAgC;AAC9F,SAAO,KAAK,gBAAgB,OAAO,QAAQ,CAAC;AAC9C;AAGO,SAAS,iBAAiB,OAAgC,UAAgC;AAC/F,SAAO,WAAW,gBAAgB,OAAO,QAAQ,CAAC;AACpD;AAGO,SAAS,qBACd,OACA,UACQ;AACR,SAAO,WAAW,gBAAgB,OAAO,QAAQ,CAAC;AACpD;AAIO,SAAS,gBAAgB,OAAgC,UAAgC;AAC9F,QAAM,OAAO,gBAAgB,OAAO,QAAQ;AAC5C,SAAO,GAAG,KAAK,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC;AAC1C;AAEO,IAAM,oBAAoB,EAAE,MAAM,YAAY,YAAY,MAAM,WAAW;","names":[]}

package/dist/lib/recipe.js

@@ -0,0 +1,33 @@
+// src/lib/recipe.ts
+import { createTV, cn as merge } from "tailwind-variants";
+var mergeConfig = {
+  extend: {
+    theme: {
+      shadow: [
+        "hard-sm",
+        "hard-md",
+        "hard-lg",
+        // The role-named hard shadows belong in the same group: a card that
+        // sets `shadow-hard-accent-primary` on hover still needs
+        // `shadow-none` to be able to clear it.
+        "hard-accent-primary",
+        "hard-accent-secondary",
+        "hard-accent-tertiary",
+        "hard-accent-quiet",
+        "hard-intent-info",
+        "hard-intent-success",
+        "hard-intent-warning",
+        "hard-intent-danger"
+      ]
+    }
+  }
+};
+var recipe = createTV({ twMergeConfig: mergeConfig });
+function cn(...inputs) {
+  return merge(...inputs) ?? "";
+}
+export {
+  cn,
+  recipe
+};
+//# sourceMappingURL=recipe.js.map

package/dist/lib/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/recipe.ts"],"sourcesContent":["/**\n * The style recipe builder every component uses.\n *\n * A *recipe* is the set of class strings one component needs: a base, one entry\n * per element it renders (a \"slot\"), and the variants that switch between them.\n * `src/components/Input.tsx` is the worked example.\n *\n * ## Why a builder at all\n *\n * Components used to compose classes by appending the consumer's `className` to\n * the end of a template string. That does nothing. Tailwind decides which of two\n * conflicting utilities wins by **CSS source order**, not by the order they\n * appear in the class attribute — so a consumer passing `bg-surface-raised` to a\n * component whose base is `bg-surface-base` got whichever the stylesheet\n * happened to emit later. Every `className` prop in this package was unreliable\n * in exactly that way.\n *\n * A recipe resolves conflicts before the class string reaches the DOM, so the\n * caller's value genuinely wins. That is a correctness fix, not an ergonomic one.\n *\n * ## The engine is an implementation detail\n *\n * `tailwind-variants` is what currently builds these, chosen because most\n * components here style more than one element — a field is a label, a control\n * and a message — and the alternatives model one element per recipe. It is not\n * part of this package's vocabulary or its public types: components import\n * `recipe` from here, and nothing downstream names the library. Swapping it is\n * then an edit to this file rather than to thirty components.\n */\n\nimport { createTV, cn as merge } from 'tailwind-variants';\n\n/**\n * Almost nothing needs declaring here, which is worth knowing before anyone\n * adds to it: the class merger classifies our semantic tokens correctly with no\n * configuration at all. `bg-surface-raised` beats `bg-surface-base`,\n * `text-accent-primary` beats `text-content-primary`, and — the case that\n * actually matters — a colour and a size in the same `text-*` position are\n * recognised as different properties, so `text-content-primary text-sm`\n * survives intact.\n *\n * The hard shadows are the exception. `shadow-hard-md` is read as a custom\n * shadow value while `shadow-none` is read as box-shadow, so without this the\n * two would both survive and the CSS would arbitrate — meaning `shadow-none`\n * could not reliably clear a hard shadow. Declaring the scale puts them in one\n * group.\n *\n * Not exported from the package: it describes the merger's config format, which\n * is exactly the detail this module exists to contain.\n */\nconst mergeConfig = {\n  extend: {\n    theme: {\n      shadow: [\n        'hard-sm',\n        'hard-md',\n        'hard-lg',\n        // The role-named hard shadows belong in the same group: a card that\n        // sets `shadow-hard-accent-primary` on hover still needs\n        // `shadow-none` to be able to clear it.\n        'hard-accent-primary',\n        'hard-accent-secondary',\n        'hard-accent-tertiary',\n        'hard-accent-quiet',\n        'hard-intent-info',\n        'hard-intent-success',\n        'hard-intent-warning',\n        'hard-intent-danger',\n      ],\n    },\n  },\n} as const;\n\n/**\n * Build a component's styles.\n *\n * ```ts\n * const field = recipe({\n *   slots: { root: 'flex flex-col', label: 'text-xs uppercase' },\n *   variants: { invalid: { true: { label: 'text-intent-danger' } } },\n * });\n *\n * const styles = field({ invalid: true });\n * <label className={styles.label({ class: className })} />\n * ```\n *\n * Deliberately not re-exported from the package entrypoint. Its type comes from\n * the underlying library, so exporting it would put that library back into the\n * published `.d.ts` and make it a breaking change to replace.\n */\nexport const recipe = createTV({ twMergeConfig: mergeConfig });\n\n/** Anything accepted as a class: strings, falsy values, arrays, or nested ones. */\nexport type ClassInput = string | number | null | undefined | false | ClassInput[];\n\n/**\n * Join class names, resolving Tailwind conflicts so the last value wins.\n *\n * For one-off composition outside a recipe — and for consumers building their\n * own components on this system, which is why the signature is written out here\n * rather than inherited from the library.\n */\nexport function cn(...inputs: ClassInput[]): string {\n  // The underlying merger returns `undefined` when everything is filtered out.\n  // A `className` of `undefined` is legal in React but awkward to compose with,\n  // so this narrows to a string — which is also why the signature is written\n  // here rather than inherited.\n  return merge(...(inputs as Parameters<typeof merge>)) ?? '';\n}\n"],"mappings":";AA8BA,SAAS,UAAU,MAAM,aAAa;AAoBtC,IAAM,cAAc;AAAA,EAClB,QAAQ;AAAA,IACN,OAAO;AAAA,MACL,QAAQ;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA;AAAA;AAAA;AAAA,QAIA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAmBO,IAAM,SAAS,SAAS,EAAE,eAAe,YAAY,CAAC;AAYtD,SAAS,MAAM,QAA8B;AAKlD,SAAO,MAAM,GAAI,MAAmC,KAAK;AAC3D;","names":[]}

package/dist/lib/slug.js

@@ -0,0 +1,39 @@
+// src/lib/slug.ts
+var STRIP = /[ -⸀-⹿\\'!"#$%&()*+,./:;<=>?@[\]^`{|}~–—‘’“”]/g;
+function slugify(value) {
+  return value.trim().toLowerCase().replace(STRIP, "").replace(/\s/g, "-");
+}
+var Slugger = class {
+  seen = /* @__PURE__ */ new Map();
+  slug(value) {
+    const base = slugify(value);
+    const count = this.seen.get(base);
+    if (count === void 0) {
+      this.seen.set(base, 0);
+      return base;
+    }
+    const next = count + 1;
+    this.seen.set(base, next);
+    return `${base}-${next}`;
+  }
+  reset() {
+    this.seen.clear();
+  }
+};
+function childrenToText(node) {
+  if (node === null || node === void 0 || typeof node === "boolean") return "";
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  if (Array.isArray(node)) return node.map(childrenToText).join("");
+  if (typeof node === "object" && "props" in node) {
+    const props = node.props;
+    if (props && "children" in props) return childrenToText(props.children);
+  }
+  return "";
+}
+export {
+  Slugger,
+  childrenToText,
+  slugify
+};
+//# sourceMappingURL=slug.js.map

package/dist/lib/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/slug.ts"],"sourcesContent":["/**\n * Heading slug generation, kept deliberately compatible with `github-slugger`\n * (the slugger behind `rehype-slug`).\n *\n * The docs pipeline generates heading `id`s at build time via `rehype-slug`,\n * but the same ids have to be derivable on the client — the table of contents,\n * the scroll-spy observer, and the copy-link affordance all need to agree on\n * what `#some-heading` refers to. Reimplementing the same rules here means a\n * runtime-built TOC lands on the same anchors as a remark-built one.\n */\n\n/**\n * Characters github-slugger strips outright. Kept as an explicit class rather\n * than a `\\W` negation so that accented latin, CJK, and emoji-adjacent glyphs\n * survive the same way they do on GitHub.\n */\nconst STRIP =\n  /[ -⸀-⹿\\\\'!\"#$%&()*+,./:;<=>?@[\\]^`{|}~–—‘’“”]/g;\n\n/** Slugify a single heading string. Does not deduplicate — see {@link Slugger}. */\nexport function slugify(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(STRIP, '')\n    .replace(/\\s/g, '-');\n}\n\n/**\n * Stateful slugger that appends `-1`, `-2`, … to repeated headings, matching\n * `github-slugger`. Create one per document; reuse across documents would leak\n * counts between pages and desynchronise the anchors from the rendered HTML.\n */\nexport class Slugger {\n  private readonly seen = new Map<string, number>();\n\n  slug(value: string): string {\n    const base = slugify(value);\n    const count = this.seen.get(base);\n\n    if (count === undefined) {\n      this.seen.set(base, 0);\n      return base;\n    }\n\n    const next = count + 1;\n    this.seen.set(base, next);\n    return `${base}-${next}`;\n  }\n\n  reset(): void {\n    this.seen.clear();\n  }\n}\n\n/**\n * Extract the plain text of a React child tree so a heading rendered as\n * `<h2>The <code>tvs</code> CLI</h2>` still slugs to `the-tvs-cli`.\n *\n * Only walks strings, numbers, arrays, and elements with `children` in props —\n * anything else (a component that renders text internally) is invisible here,\n * which is why {@link AnchorHeading} also accepts an explicit `id`.\n */\nexport function childrenToText(node: unknown): string {\n  if (node === null || node === undefined || typeof node === 'boolean') return '';\n  if (typeof node === 'string') return node;\n  if (typeof node === 'number') return String(node);\n  if (Array.isArray(node)) return node.map(childrenToText).join('');\n\n  if (typeof node === 'object' && 'props' in node) {\n    const props = (node as { props?: { children?: unknown } }).props;\n    if (props && 'children' in props) return childrenToText(props.children);\n  }\n\n  return '';\n}\n"],"mappings":";AAgBA,IAAM,QACJ;AAGK,SAAS,QAAQ,OAAuB;AAC7C,SAAO,MACJ,KAAK,EACL,YAAY,EACZ,QAAQ,OAAO,EAAE,EACjB,QAAQ,OAAO,GAAG;AACvB;AAOO,IAAM,UAAN,MAAc;AAAA,EACF,OAAO,oBAAI,IAAoB;AAAA,EAEhD,KAAK,OAAuB;AAC1B,UAAM,OAAO,QAAQ,KAAK;AAC1B,UAAM,QAAQ,KAAK,KAAK,IAAI,IAAI;AAEhC,QAAI,UAAU,QAAW;AACvB,WAAK,KAAK,IAAI,MAAM,CAAC;AACrB,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,QAAQ;AACrB,SAAK,KAAK,IAAI,MAAM,IAAI;AACxB,WAAO,GAAG,IAAI,IAAI,IAAI;AAAA,EACxB;AAAA,EAEA,QAAc;AACZ,SAAK,KAAK,MAAM;AAAA,EAClB;AACF;AAUO,SAAS,eAAe,MAAuB;AACpD,MAAI,SAAS,QAAQ,SAAS,UAAa,OAAO,SAAS,UAAW,QAAO;AAC7E,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,OAAO,SAAS,SAAU,QAAO,OAAO,IAAI;AAChD,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,IAAI,cAAc,EAAE,KAAK,EAAE;AAEhE,MAAI,OAAO,SAAS,YAAY,WAAW,MAAM;AAC/C,UAAM,QAAS,KAA4C;AAC3D,QAAI,SAAS,cAAc,MAAO,QAAO,eAAe,MAAM,QAAQ;AAAA,EACxE;AAEA,SAAO;AACT;","names":[]}

package/dist/lib/theme.js

@@ -0,0 +1,76 @@
+// src/lib/theme.ts
+var EMPHASIS_VARS = {
+  primary: "var(--ds-accent-primary)",
+  secondary: "var(--ds-accent-secondary)",
+  tertiary: "var(--ds-accent-tertiary)",
+  quiet: "var(--ds-accent-quiet)"
+};
+var INTENT_VARS = {
+  info: "var(--ds-intent-info)",
+  success: "var(--ds-intent-success)",
+  warning: "var(--ds-intent-warning)",
+  danger: "var(--ds-intent-danger)"
+};
+var SURFACE_VARS = {
+  base: "var(--ds-surface-base)",
+  raised: "var(--ds-surface-raised)",
+  sunken: "var(--ds-surface-sunken)",
+  overlay: "var(--ds-surface-overlay)"
+};
+var TEXT_VARS = {
+  primary: "var(--ds-text-primary)",
+  secondary: "var(--ds-text-secondary)",
+  muted: "var(--ds-text-muted)",
+  inverse: "var(--ds-text-inverse)"
+};
+var BORDER_VARS = {
+  strong: "var(--ds-border-strong)",
+  default: "var(--ds-border-default)",
+  subtle: "var(--ds-border-subtle)"
+};
+function accentVar(token, fallback = "primary") {
+  const resolved = token ?? fallback;
+  return EMPHASIS_VARS[resolved] ?? INTENT_VARS[resolved] ?? EMPHASIS_VARS.primary;
+}
+function surfaceVar(token = "base") {
+  return SURFACE_VARS[token] ?? SURFACE_VARS.base;
+}
+function textVar(token = "primary") {
+  return TEXT_VARS[token] ?? TEXT_VARS.primary;
+}
+function borderVar(token = "strong") {
+  return BORDER_VARS[token] ?? BORDER_VARS.strong;
+}
+var fontVar = {
+  display: "var(--ds-font-display)",
+  body: "var(--ds-font-body)",
+  mono: "var(--ds-font-mono)",
+  pixel: "var(--ds-font-pixel)"
+};
+var HEADING_EMPHASIS = {
+  1: "primary",
+  2: "primary",
+  3: "secondary",
+  4: "tertiary",
+  5: "quiet",
+  6: "quiet"
+};
+var semanticTokens = {
+  accent: EMPHASIS_VARS,
+  intent: INTENT_VARS,
+  surface: SURFACE_VARS,
+  text: TEXT_VARS,
+  border: BORDER_VARS,
+  font: fontVar,
+  shadowColor: "var(--ds-shadow-color)"
+};
+export {
+  HEADING_EMPHASIS,
+  accentVar,
+  borderVar,
+  fontVar,
+  semanticTokens,
+  surfaceVar,
+  textVar
+};
+//# sourceMappingURL=theme.js.map

package/dist/lib/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/theme.ts"],"sourcesContent":["/**\n * Semantic theming layer.\n *\n * Components should describe *what a thing is* — a primary accent, a danger\n * state, a raised surface — never which colour it happens to be. The brutalist\n * palette (cyan/pink/yellow/green) is one mapping of those roles; `.dim` and\n * `.sketch` are others, and a future mode is a third. Referencing\n * `var(--brutalist-cyan)` directly hard-codes today's mapping into every\n * component and makes retheming a find-and-replace across the package.\n *\n * The CSS variables below are declared in `theme.css` and resolve through the\n * raw palette, so they follow every mode swap automatically.\n */\n\n/**\n * Visual weight within a hierarchy. Use for decorative and navigational\n * emphasis — which of several things should draw the eye first — not for\n * meaning. `quiet` is the de-emphasised step, not a fifth colour.\n */\nexport type Emphasis = 'primary' | 'secondary' | 'tertiary' | 'quiet';\n\n/**\n * Communicated meaning. Use when the colour carries information the reader\n * must act on; these survive retheming because their semantics are fixed even\n * when their hues are not.\n */\nexport type Intent = 'info' | 'success' | 'warning' | 'danger';\n\n/**\n * Background elevation. `base` is the page, `raised` sits above it (cards,\n * header, drawers), `sunken` is inset (code wells), `overlay` is modal.\n */\nexport type Surface = 'base' | 'raised' | 'sunken' | 'overlay';\n\n/** Text prominence, coarsest to faintest. */\nexport type TextTone = 'primary' | 'secondary' | 'muted' | 'inverse';\n\n/** Rule weight. `strong` is the full-contrast brutalist border. */\nexport type BorderTone = 'strong' | 'default' | 'subtle';\n\n/**\n * Palette names accepted by components predating the semantic layer.\n *\n * @deprecated Pass an {@link Emphasis} or {@link Intent} instead. These remain\n * accepted so existing consumers keep compiling, and they resolve to the same\n * values, but they defeat the point of the abstraction.\n */\n/**\n * A colour's *appearance*, independent of any job — the vocabulary a Target\n * addresses when it has no notion of jobs. A terminal has sixteen positions\n * named by colour and no concept of a keyword.\n *\n * Declared below the Role vocabulary and referenced by it, never the reverse:\n * Hue -> Role is a declared lookup, Role -> Hue is a guess. See\n * `docs/adr/0001-hues-declared-below-roles.md`.\n *\n * **A Hue in component code is a defect.** Components address Roles only.\n * Ten is the ceiling rather than a comfortable middle — the tightest pair\n * already sits at deltaE 0.049. See `docs/palette-provenance.md`.\n */\nexport type Hue =\n  | 'red'\n  | 'orange'\n  | 'yellow'\n  | 'green'\n  | 'teal'\n  | 'cyan'\n  | 'blue'\n  | 'violet'\n  | 'magenta'\n  | 'pink';\n\n/**\n * The eight ANSI base slots a terminal needs, beyond which `bright` variants\n * fill the upper eight. `black` and `white` come from `FIXED_COLOURS`.\n */\nexport type AnsiHue = Extract<Hue, 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan'>;\n\n/**\n * What a Role points at in the Hue vocabulary.\n *\n * `'neutral'` is not a cop-out: some Roles genuinely are not hues.\n * `accent.quiet` is a warm or cool grey by design, and the palette has no\n * neutral ramp to point it at. Saying so explicitly keeps the map exhaustive —\n * a new Emphasis is still a compile error — while letting the gate distinguish\n * \"declared as not-a-hue\" from \"forgot to wire it up\", which a `Partial` could\n * not.\n */\nexport type HueRef = Hue | 'neutral';\n\n\n/** Anything a component's `accent`-style prop will take. */\nexport type AccentToken = Emphasis | Intent;\n\nconst EMPHASIS_VARS: Record<Emphasis, string> = {\n  primary: 'var(--ds-accent-primary)',\n  secondary: 'var(--ds-accent-secondary)',\n  tertiary: 'var(--ds-accent-tertiary)',\n  quiet: 'var(--ds-accent-quiet)',\n};\n\nconst INTENT_VARS: Record<Intent, string> = {\n  info: 'var(--ds-intent-info)',\n  success: 'var(--ds-intent-success)',\n  warning: 'var(--ds-intent-warning)',\n  danger: 'var(--ds-intent-danger)',\n};\n\nconst SURFACE_VARS: Record<Surface, string> = {\n  base: 'var(--ds-surface-base)',\n  raised: 'var(--ds-surface-raised)',\n  sunken: 'var(--ds-surface-sunken)',\n  overlay: 'var(--ds-surface-overlay)',\n};\n\nconst TEXT_VARS: Record<TextTone, string> = {\n  primary: 'var(--ds-text-primary)',\n  secondary: 'var(--ds-text-secondary)',\n  muted: 'var(--ds-text-muted)',\n  inverse: 'var(--ds-text-inverse)',\n};\n\nconst BORDER_VARS: Record<BorderTone, string> = {\n  strong: 'var(--ds-border-strong)',\n  default: 'var(--ds-border-default)',\n  subtle: 'var(--ds-border-subtle)',\n};\n\n/**\n * Resolve any accent token to the CSS variable expression that renders it.\n *\n * Unknown values fall back to the primary accent rather than throwing —\n * a mistyped prop should degrade to something legible, not blank out a\n * component's colour and leave `color: undefined` on the element.\n */\nexport function accentVar(token: AccentToken | undefined, fallback: AccentToken = 'primary'): string {\n  const resolved = token ?? fallback;\n  return (\n    EMPHASIS_VARS[resolved as Emphasis] ??\n    INTENT_VARS[resolved as Intent] ??\n    EMPHASIS_VARS.primary\n  );\n}\n\nexport function surfaceVar(token: Surface = 'base'): string {\n  return SURFACE_VARS[token] ?? SURFACE_VARS.base;\n}\n\nexport function textVar(token: TextTone = 'primary'): string {\n  return TEXT_VARS[token] ?? TEXT_VARS.primary;\n}\n\nexport function borderVar(token: BorderTone = 'strong'): string {\n  return BORDER_VARS[token] ?? BORDER_VARS.strong;\n}\n\n/** Semantic font roles. */\nexport const fontVar = {\n  display: 'var(--ds-font-display)',\n  body: 'var(--ds-font-body)',\n  mono: 'var(--ds-font-mono)',\n  pixel: 'var(--ds-font-pixel)',\n} as const;\n\n/**\n * Default emphasis per heading level, so a document's colour hierarchy follows\n * its structural hierarchy without every call site restating it.\n */\nexport const HEADING_EMPHASIS: Record<1 | 2 | 3 | 4 | 5 | 6, Emphasis> = {\n  1: 'primary',\n  2: 'primary',\n  3: 'secondary',\n  4: 'tertiary',\n  5: 'quiet',\n  6: 'quiet',\n};\n\n/**\n * The full semantic token surface, as CSS variable expressions. Useful for\n * inline styles and for consumers building their own components on the system.\n */\nexport const semanticTokens = {\n  accent: EMPHASIS_VARS,\n  intent: INTENT_VARS,\n  surface: SURFACE_VARS,\n  text: TEXT_VARS,\n  border: BORDER_VARS,\n  font: fontVar,\n  shadowColor: 'var(--ds-shadow-color)',\n} as const;\n"],"mappings":";AA8FA,IAAM,gBAA0C;AAAA,EAC9C,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,OAAO;AACT;AAEA,IAAM,cAAsC;AAAA,EAC1C,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AACV;AAEA,IAAM,eAAwC;AAAA,EAC5C,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEA,IAAM,YAAsC;AAAA,EAC1C,SAAS;AAAA,EACT,WAAW;AAAA,EACX,OAAO;AAAA,EACP,SAAS;AACX;AAEA,IAAM,cAA0C;AAAA,EAC9C,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AACV;AASO,SAAS,UAAU,OAAgC,WAAwB,WAAmB;AACnG,QAAM,WAAW,SAAS;AAC1B,SACE,cAAc,QAAoB,KAClC,YAAY,QAAkB,KAC9B,cAAc;AAElB;AAEO,SAAS,WAAW,QAAiB,QAAgB;AAC1D,SAAO,aAAa,KAAK,KAAK,aAAa;AAC7C;AAEO,SAAS,QAAQ,QAAkB,WAAmB;AAC3D,SAAO,UAAU,KAAK,KAAK,UAAU;AACvC;AAEO,SAAS,UAAU,QAAoB,UAAkB;AAC9D,SAAO,YAAY,KAAK,KAAK,YAAY;AAC3C;AAGO,IAAM,UAAU;AAAA,EACrB,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAMO,IAAM,mBAA4D;AAAA,EACvE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAMO,IAAM,iBAAiB;AAAA,EAC5B,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,aAAa;AACf;","names":[]}

package/dist/lib/tokenRules.js

@@ -0,0 +1,51 @@
+// src/lib/tokenRules.ts
+var TOKEN_RULES = [
+  {
+    id: "hex",
+    label: "Hex literals",
+    pattern: /#[0-9a-fA-F]{3,8}\b/g,
+    fix: "Use a --ds-* token or a semantic utility (bg-surface-raised, text-accent-primary)."
+  },
+  {
+    id: "rawPalette",
+    label: "Literal Tailwind palette utilities",
+    pattern: /\b(?:bg|text|border|divide|placeholder|ring|from|to|via)-(?:white|black|zinc|gray|slate|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)(?:-\d{2,3})?(?:\/\d{1,3})?\b/g,
+    fix: "Use the semantic utilities: bg-surface-*, text-content-*, border-edge-*, text-intent-*."
+  },
+  {
+    id: "legacyAlias",
+    label: "Legacy brutalist-* colour aliases",
+    // `brutalist-card` / `-btn` / `-badge` are component classes in styles.css,
+    // already written against roles — they are not colour names and stay.
+    pattern: /\bbrutalist-(?:cyan|neonCyan|pink|yellow|neonGreen|green|cyberOrange|darkBg|shadow-color)\b/g,
+    fix: "Use accent-*/intent-* utilities or --ds-* tokens. Blocks removing the compat block in theme.css."
+  },
+  {
+    id: "darkVariant",
+    label: "dark: colour variants",
+    pattern: /\bdark:(?:bg|text|border|divide|placeholder|ring|from|to|via)-/g,
+    fix: 'Tokens switch on their own. dark: is only for non-colour utilities, and means "midnight or dim" now.'
+  }
+];
+function scanRules(source, rules) {
+  const findings = [];
+  source.split("\n").forEach((line, index) => {
+    const text = line.trim();
+    if (text.startsWith("*") || text.startsWith("//") || text.startsWith("/*")) return;
+    for (const rule of rules) {
+      for (const match of text.match(rule.pattern) ?? []) {
+        findings.push({ ruleId: rule.id, line: index + 1, match, text });
+      }
+    }
+  });
+  return findings;
+}
+function scanTokenRules(source) {
+  return scanRules(source, TOKEN_RULES);
+}
+export {
+  TOKEN_RULES,
+  scanRules,
+  scanTokenRules
+};
+//# sourceMappingURL=tokenRules.js.map

package/dist/lib/tokenRules.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/tokenRules.ts"],"sourcesContent":["/**\n * The rules that say a colour must be addressed as a role.\n *\n * These live here, in one place, because two very different things enforce them:\n *\n *   - `scripts/check-tokens.mjs` runs them over `src/components` and\n *     `src/stories` as a **ratchet**. Those files carry pre-existing debt, so\n *     each rule has a budget and CI fails only when a number rises.\n *   - `@rtkelly-labs/design-system-report`'s linter runs them over a report's TSX\n *     at **budget zero**. A\n *     report is new code written today; there is no debt to grandfather, and a\n *     hex literal in one renders identically on `midnight` and on `white`, which\n *     is the whole failure the ladder exists to prevent.\n *\n * The check script imports this `.ts` file directly — Node strips the types.\n * That is worth preserving: the previous arrangement had the rules written out\n * in a script, so anything else wanting them had to copy the regexes, and a copy\n * is a rule that silently stops matching the original.\n */\n\nexport interface TokenRule {\n  id: 'hex' | 'rawPalette' | 'legacyAlias' | 'darkVariant';\n  label: string;\n  /** Global, so callers must use `match`/`matchAll`, which reset `lastIndex`. */\n  pattern: RegExp;\n  fix: string;\n}\n\nexport const TOKEN_RULES: readonly TokenRule[] = [\n  {\n    id: 'hex',\n    label: 'Hex literals',\n    pattern: /#[0-9a-fA-F]{3,8}\\b/g,\n    fix: 'Use a --ds-* token or a semantic utility (bg-surface-raised, text-accent-primary).',\n  },\n  {\n    id: 'rawPalette',\n    label: 'Literal Tailwind palette utilities',\n    pattern:\n      /\\b(?:bg|text|border|divide|placeholder|ring|from|to|via)-(?:white|black|zinc|gray|slate|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)(?:-\\d{2,3})?(?:\\/\\d{1,3})?\\b/g,\n    fix: 'Use the semantic utilities: bg-surface-*, text-content-*, border-edge-*, text-intent-*.',\n  },\n  {\n    id: 'legacyAlias',\n    label: 'Legacy brutalist-* colour aliases',\n    // `brutalist-card` / `-btn` / `-badge` are component classes in styles.css,\n    // already written against roles — they are not colour names and stay.\n    pattern: /\\bbrutalist-(?:cyan|neonCyan|pink|yellow|neonGreen|green|cyberOrange|darkBg|shadow-color)\\b/g,\n    fix: 'Use accent-*/intent-* utilities or --ds-* tokens. Blocks removing the compat block in theme.css.',\n  },\n  {\n    id: 'darkVariant',\n    label: 'dark: colour variants',\n    pattern: /\\bdark:(?:bg|text|border|divide|placeholder|ring|from|to|via)-/g,\n    fix: 'Tokens switch on their own. dark: is only for non-colour utilities, and means \"midnight or dim\" now.',\n  },\n];\n\nexport interface Finding<Id extends string = string> {\n  ruleId: Id;\n  line: number;\n  match: string;\n  /** The trimmed source line, for pointing at the offence. */\n  text: string;\n}\n\n/**\n * Line-by-line rule matching, shared by the ratchet and the report linter.\n *\n * Comment lines are skipped, and that is not a loophole being left open: this\n * very file, `AGENTS.md`'s examples and the rules' own `fix` strings all name\n * the forbidden patterns in prose. Without the skip the checker's first finding\n * would be itself.\n *\n * Matching against the *trimmed* line rather than the raw one is safe because no\n * rule can match leading whitespace, and it means the reported `text` is what\n * gets printed under the finding.\n */\nexport function scanRules<Id extends string>(\n  source: string,\n  rules: readonly { id: Id; pattern: RegExp }[],\n): Finding<Id>[] {\n  const findings: Finding<Id>[] = [];\n  source.split('\\n').forEach((line, index) => {\n    const text = line.trim();\n    if (text.startsWith('*') || text.startsWith('//') || text.startsWith('/*')) return;\n    for (const rule of rules) {\n      for (const match of text.match(rule.pattern) ?? []) {\n        findings.push({ ruleId: rule.id, line: index + 1, match, text });\n      }\n    }\n  });\n  return findings;\n}\n\n/** Every colour-instead-of-role violation in one file's source. */\nexport function scanTokenRules(source: string): Finding<TokenRule['id']>[] {\n  return scanRules(source, TOKEN_RULES);\n}\n"],"mappings":";AA4BO,IAAM,cAAoC;AAAA,EAC/C;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,SAAS;AAAA,IACT,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,SACE;AAAA,IACF,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA;AAAA;AAAA,IAGP,SAAS;AAAA,IACT,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,SAAS;AAAA,IACT,KAAK;AAAA,EACP;AACF;AAsBO,SAAS,UACd,QACA,OACe;AACf,QAAM,WAA0B,CAAC;AACjC,SAAO,MAAM,IAAI,EAAE,QAAQ,CAAC,MAAM,UAAU;AAC1C,UAAM,OAAO,KAAK,KAAK;AACvB,QAAI,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,IAAI,EAAG;AAC5E,eAAW,QAAQ,OAAO;AACxB,iBAAW,SAAS,KAAK,MAAM,KAAK,OAAO,KAAK,CAAC,GAAG;AAClD,iBAAS,KAAK,EAAE,QAAQ,KAAK,IAAI,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAGO,SAAS,eAAe,QAA4C;AACzE,SAAO,UAAU,QAAQ,WAAW;AACtC;","names":[]}