@repraze/kernelkit 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/docs/doc-kit.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CodeBlock, CodeBlockActions, CodeBlockContent, CodeBlockCopyButton, CodeBlockHeader, CodeBlockTitle, } from "@repraze/kernelkit/components/code-block";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@repraze/kernelkit/components/table";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@repraze/kernelkit/components/tabs";
+import { useHighlightedCode } from "@repraze/kernelkit/hooks/use-highlighted-code";
+import { cn } from "cn";
+/**
+ * Declare a docs page. The site narrows the categories once:
+ *
+ * ```ts
+ * export const CATEGORIES = ["Foundations", "Components"] as const;
+ * export const defineDoc = (doc: DocDef<(typeof CATEGORIES)[number]>) => doc;
+ * ```
+ */
+export function defineDoc(doc) {
+    return doc;
+}
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+/** A highlighted, copyable code sample (the kit's CodeBlock), titled with its language by default. */
+export function Code({ code, language = "tsx", title, className, }) {
+    const lines = useHighlightedCode(code, language);
+    return (_jsxs(CodeBlock, { className: className, children: [_jsxs(CodeBlockHeader, { children: [_jsx(CodeBlockTitle, { children: title ?? language }), _jsx(CodeBlockActions, { children: _jsx(CodeBlockCopyButton, { value: code }) })] }), _jsx(CodeBlockContent, { className: "max-h-[480px] text-[13px]", children: lines.map((line, i) => (_jsx("span", { className: "block min-h-lh", children: line }, i))) })] }));
+}
+const layoutClass = {
+    center: "flex min-h-56 items-center justify-center p-8",
+    start: "flex min-h-56 items-start justify-start p-8",
+    full: "overflow-hidden",
+    tall: "flex min-h-[28rem] items-center justify-center p-8",
+};
+/** One demo: its title and description, then Preview and Code tabs. The section's id is the slugified title. */
+export function Demo({ demo, code }) {
+    const Component = demo.component;
+    return (_jsxs("section", { className: "flex scroll-mt-24 flex-col gap-3", id: slugify(demo.title), children: [_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("h3", { className: "font-mono text-sm font-medium", children: demo.title }), demo.description ? _jsx("p", { className: "text-sm text-muted-foreground", children: demo.description }) : null] }), _jsxs(Tabs, { defaultValue: "preview", children: [_jsxs(TabsList, { children: [_jsx(TabsTrigger, { value: "preview", children: "Preview" }), _jsx(TabsTrigger, { value: "code", children: "Code" })] }), _jsx(TabsContent, { value: "preview", children: _jsx("div", { "data-slot": "demo-frame", className: cn("rounded-xl border bg-card", layoutClass[demo.layout ?? "center"]), children: _jsx(Component, {}) }) }), _jsx(TabsContent, { value: "code", children: _jsx(Code, { code: code }) })] })] }));
+}
+/** A component's props: name, type, default and description. */
+export function PropsTable({ component, rows }) {
+    return (_jsxs("section", { className: "flex flex-col gap-3", children: [_jsx("h3", { className: "font-mono text-sm font-medium", children: component }), _jsx("div", { className: "overflow-hidden rounded-xl border bg-card", children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Prop" }), _jsx(TableHead, { children: "Type" }), _jsx(TableHead, { children: "Default" }), _jsx(TableHead, { children: "Description" })] }) }), _jsx(TableBody, { children: rows.map((row) => (_jsxs(TableRow, { children: [_jsx(TableCell, { className: "font-mono text-xs text-primary-text", children: row.name }), _jsx(TableCell, { className: "font-mono text-xs whitespace-normal", children: row.type }), _jsx(TableCell, { className: "font-mono text-xs text-muted-foreground", children: row.default ?? "-" }), _jsx(TableCell, { className: "text-sm whitespace-normal text-muted-foreground", children: row.description })] }, row.name))) })] }) })] }));
+}
+//# sourceMappingURL=doc-kit.js.map

package/dist/docs/doc-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-kit.js","sourceRoot":"","sources":["../../src/docs/doc-kit.tsx"],"names":[],"mappings":"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"}

package/dist/docs/doc-page.d.ts

@@ -0,0 +1,27 @@
+import type * as React from "react";
+import { type DocEntry } from "./doc-kit";
+import type { DocsIndex } from "./docs-index";
+/** A router link to a docs page, used as a `render` element: `(slug) => <Link to="/docs/$slug" params={{slug}} />`. */
+export type DocLinkFor = (slug: string) => React.ReactElement;
+/** The table of contents of a page: its demos, the notes' sections, then the API. */
+export declare function docToc(doc: DocEntry): {
+    id: string;
+    title: string;
+}[];
+export interface DocPageProps<Category extends string = string> {
+    /** The loaded page (`index.loadDoc(slug)`, usually from the route's loader). */
+    doc: DocEntry<Category>;
+    index: DocsIndex<Category>;
+    linkFor: DocLinkFor;
+}
+/**
+ * A docs page in the suite's layout (GUIDELINES §7b): PageHeader (category, source badge, title,
+ * description), the demos, the notes, the API tables and the Pager in SiteMain; the Toc in SiteAside.
+ */
+export declare function DocPage<Category extends string>({ doc, index, linkFor }: DocPageProps<Category>): React.JSX.Element;
+/** The suite's docs layout: SiteLayout with the docs nav in a sticky SiteSidebar, then the page (which adds its Toc). */
+export declare function DocsLayout({ nav, children }: {
+    nav: React.ReactNode;
+    children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=doc-page.d.ts.map

package/dist/docs/doc-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-page.d.ts","sourceRoot":"","sources":["../../src/docs/doc-page.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAO,KAAK,QAAQ,EAAsB,MAAM,WAAW,CAAC;AACnE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C,uHAAuH;AACvH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;AAE9D,qFAAqF;AACrF,wBAAgB,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,EAAE,CAMnE;AAED,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC1D,gFAAgF;IAChF,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,EAAE,UAAU,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,SAAS,MAAM,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,qBA0E7F;AAED,yHAAyH;AACzH,wBAAgB,UAAU,CAAC,EAAC,GAAG,EAAE,QAAQ,EAAC,EAAE;IAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,qBAO5F"}

package/dist/docs/doc-page.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Badge } from "@repraze/kernelkit/components/badge";
+import { PageHeader, PageHeaderDescription, PageHeaderEyebrow, PageHeaderTitle, } from "@repraze/kernelkit/components/page-header";
+import { Pager, PagerLink } from "@repraze/kernelkit/components/pager";
+import { SiteAside, SiteLayout, SiteMain, SiteSidebar } from "@repraze/kernelkit/components/site-layout";
+import { Toc, TocItem, TocList, TocTitle, useTocActive } from "@repraze/kernelkit/components/toc";
+import { ExternalLinkIcon } from "lucide-react";
+import { Demo, PropsTable, slugify } from "./doc-kit";
+/** The table of contents of a page: its demos, the notes' sections, then the API. */
+export function docToc(doc) {
+    return [
+        ...doc.demos.map((demo) => ({ id: slugify(demo.title), title: demo.title })),
+        ...(doc.sections ?? []),
+        ...(doc.props?.length ? [{ id: "api", title: "API" }] : []),
+    ];
+}
+/**
+ * A docs page in the suite's layout (GUIDELINES §7b): PageHeader (category, source badge, title,
+ * description), the demos, the notes, the API tables and the Pager in SiteMain; the Toc in SiteAside.
+ */
+export function DocPage({ doc, index, linkFor }) {
+    const { prev, next } = index.neighbours(doc.slug);
+    const Notes = doc.notes;
+    const sections = docToc(doc);
+    const active = useTocActive(sections.map((s) => s.id));
+    return (_jsxs(_Fragment, { children: [_jsxs(SiteMain, { children: [_jsxs(PageHeader, { children: [_jsxs(PageHeaderEyebrow, { children: [_jsx(Badge, { variant: "outline", children: doc.category }), doc.source ? (_jsxs(Badge, { variant: "secondary", className: "font-mono", render: _jsx("a", { href: doc.source.href, target: "_blank", rel: "noreferrer" }), children: [doc.source.label, " ", _jsx(ExternalLinkIcon, {})] })) : null] }), _jsx(PageHeaderTitle, { children: doc.title }), _jsx(PageHeaderDescription, { children: doc.description })] }), doc.demos.map((demo, i) => (_jsx(Demo, { demo: demo, code: doc.demoSources[i] ?? "" }, demo.title))), Notes ? (_jsx("div", { className: "flex flex-col gap-4", children: _jsx(Notes, {}) })) : null, doc.props?.length ? (_jsxs("section", { id: "api", className: "flex scroll-mt-24 flex-col gap-6", children: [_jsx("h2", { className: "font-heading text-xl font-semibold", children: "API" }), doc.props.map((p) => (_jsx(PropsTable, { ...p }, p.component)))] })) : null, _jsxs(Pager, { children: [prev ? (_jsx(PagerLink, { direction: "previous", render: linkFor(prev.slug), children: prev.title })) : null, next ? (_jsx(PagerLink, { direction: "next", render: linkFor(next.slug), children: next.title })) : null] })] }), sections.length > 1 ? (_jsx(SiteAside, { children: _jsxs(Toc, { children: [_jsx(TocTitle, { children: "On this page" }), _jsx(TocList, { children: sections.map((s) => (_jsx(TocItem, { href: `#${s.id}`, active: s.id === active, children: s.title }, s.id))) })] }) })) : null] }));
+}
+/** The suite's docs layout: SiteLayout with the docs nav in a sticky SiteSidebar, then the page (which adds its Toc). */
+export function DocsLayout({ nav, children }) {
+    return (_jsxs(SiteLayout, { children: [_jsx(SiteSidebar, { children: nav }), children] }));
+}
+//# sourceMappingURL=doc-page.js.map

package/dist/docs/doc-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-page.js","sourceRoot":"","sources":["../../src/docs/doc-page.tsx"],"names":[],"mappings":"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"}

package/dist/docs/docs-index.d.ts

@@ -0,0 +1,60 @@
+import type { DocDef, DocEntry } from "./doc-kit";
+/** What the nav, search and header need about a docs page, without loading its demos (`virtual:docs-meta`). */
+export interface DocMeta<Category extends string = string> {
+    slug: string;
+    title: string;
+    category: Category;
+    description: string;
+    order?: number;
+}
+/** A docs file's module: its `doc` and the demo components it exports. */
+export type DocModule<Category extends string = string> = {
+    doc: DocDef<Category>;
+} & Record<string, unknown>;
+/** What docsMetaPlugin serves for `<file>.tsx?demo-sources`: each top-level declaration's own source. */
+export interface DemoSources {
+    functions: Record<string, string>;
+}
+type Glob<T> = Record<string, () => Promise<T>>;
+export interface DocsIndexOptions<Category extends string> {
+    /** Category order: the sidebar, search groups and pager follow it. */
+    categories: readonly Category[];
+    /** `import META from "virtual:docs-meta"`. */
+    meta: readonly {
+        slug: string;
+        title: string;
+        category: string;
+        description: string;
+        order?: number;
+    }[];
+    /** `import.meta.glob("../docs/*.tsx")`: each page is its own chunk, loaded when opened. */
+    modules: Glob<unknown>;
+    /** `import.meta.glob("../docs/*.tsx", {query: "?demo-sources", import: "default"})`. */
+    sources: Glob<unknown>;
+    /** Where docs pages live, for `slugOf` (default "/docs"). */
+    basePath?: string;
+}
+export interface DocsIndex<Category extends string = string> {
+    categories: readonly Category[];
+    /** Every page, in category order, then `order`, then title. */
+    docs: DocMeta<Category>[];
+    bySlug: Map<string, DocMeta<Category>>;
+    /** Non-empty categories with their pages, for the sidebar and search. */
+    byCategory: {
+        category: Category;
+        docs: DocMeta<Category>[];
+    }[];
+    /** Load a page's module and its demos' sources; undefined for an unknown slug. */
+    loadDoc(slug: string): Promise<DocEntry<Category> | undefined>;
+    /** The pages before and after one, for the Pager. */
+    neighbours(slug: string): {
+        prev?: DocMeta<Category>;
+        next?: DocMeta<Category>;
+    };
+    /** The docs slug in a pathname ("/base/docs/button" → "button"), or undefined outside the docs. */
+    slugOf(pathname: string): string | undefined;
+}
+/** The site's docs index, from the build-time manifest and the per-page globs. */
+export declare function createDocsIndex<Category extends string>({ categories, meta, modules, sources, basePath, }: DocsIndexOptions<Category>): DocsIndex<Category>;
+export {};
+//# sourceMappingURL=docs-index.d.ts.map

package/dist/docs/docs-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../src/docs/docs-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAM,WAAW,CAAC;AAEhD,+GAA+G;AAC/G,MAAM,WAAW,OAAO,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,MAAM,SAAS,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI;IAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5G,yGAAyG;AACzG,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,KAAK,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhD,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,MAAM;IACrD,sEAAsE;IACtE,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,8CAA8C;IAC9C,IAAI,EAAE,SAAS;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,EAAE,CAAC;IACtG,2FAA2F;IAC3F,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,wFAAwF;IACxF,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IACvD,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,yEAAyE;IACzE,UAAU,EAAE;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAA;KAAC,EAAE,CAAC;IAC9D,kFAAkF;IAClF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/D,qDAAqD;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAC,CAAC;IAC/E,mGAAmG;IACnG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChD;AAID,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,QAAQ,SAAS,MAAM,EAAE,EACrD,UAAU,EACV,IAAI,EACJ,OAAO,EACP,OAAO,EACP,QAAkB,GACrB,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAiDlD"}

package/dist/docs/docs-index.js

@@ -0,0 +1,45 @@
+const slugOfFile = (path) => /([^/]+)\.tsx$/.exec(path)?.[1];
+/** The site's docs index, from the build-time manifest and the per-page globs. */
+export function createDocsIndex({ categories, meta, modules, sources, basePath = "/docs", }) {
+    const moduleBySlug = new Map(Object.entries(modules).map(([path, load]) => [slugOfFile(path), load]));
+    const sourcesBySlug = new Map(Object.entries(sources).map(([path, load]) => [slugOfFile(path), load]));
+    const docs = meta.toSorted((a, b) => categories.indexOf(a.category) - categories.indexOf(b.category) ||
+        (a.order ?? 50) - (b.order ?? 50) ||
+        a.title.localeCompare(b.title));
+    const bySlug = new Map(docs.map((d) => [d.slug, d]));
+    const byCategory = categories
+        .map((category) => ({ category, docs: docs.filter((d) => d.category === category) }))
+        .filter((group) => group.docs.length > 0);
+    const pathRe = new RegExp(`${basePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/([^/]+)`);
+    return {
+        categories,
+        docs,
+        bySlug,
+        byCategory,
+        async loadDoc(slug) {
+            const load = moduleBySlug.get(slug);
+            const loadSources = sourcesBySlug.get(slug);
+            if (!load || !loadSources) {
+                return undefined;
+            }
+            const [mod, demoSources] = (await Promise.all([load(), loadSources()]));
+            // Match demos to their export by identity: function names don't survive minification.
+            const exportName = (component) => Object.keys(mod).find((key) => mod[key] === component) ?? "";
+            return {
+                ...mod.doc,
+                slug,
+                demoSources: mod.doc.demos.map((demo) => demoSources.functions[exportName(demo.component)] ?? ""),
+            };
+        },
+        neighbours(slug) {
+            const doc = bySlug.get(slug);
+            const index = doc ? docs.indexOf(doc) : -1;
+            return index < 0 ? {} : { prev: docs[index - 1], next: docs[index + 1] };
+        },
+        slugOf(pathname) {
+            const slug = pathRe.exec(pathname)?.[1];
+            return slug && bySlug.has(slug) ? slug : undefined;
+        },
+    };
+}
+//# sourceMappingURL=docs-index.js.map

package/dist/docs/docs-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-index.js","sourceRoot":"","sources":["../../src/docs/docs-index.ts"],"names":[],"mappings":"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"}

package/dist/docs/docs-nav.d.ts

@@ -0,0 +1,13 @@
+import type { DocLinkFor } from "./doc-page";
+import type { DocsIndex } from "./docs-index";
+export interface DocsNavProps {
+    index: DocsIndex;
+    /** The open page's slug (`index.slugOf(pathname)`), marked current. */
+    current?: string;
+    linkFor: DocLinkFor;
+    /** Called when a link is clicked (the phone menu closes). */
+    onNavigate?: () => void;
+}
+/** Docs navigation, one Sidebar group per category: the desktop SiteSidebar and the phone menu share it. */
+export declare function DocsNav({ index, current, linkFor, onNavigate }: DocsNavProps): import("react").JSX.Element;
+//# sourceMappingURL=docs-nav.d.ts.map

package/dist/docs/docs-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-nav.d.ts","sourceRoot":"","sources":["../../src/docs/docs-nav.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,4GAA4G;AAC5G,wBAAgB,OAAO,CAAC,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAC,EAAE,YAAY,+BAuB1E"}

package/dist/docs/docs-nav.js

@@ -0,0 +1,8 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SidebarGroup, SidebarGroupLabel, SidebarMenu, SidebarMenuButton, SidebarMenuItem, } from "@repraze/kernelkit/components/sidebar";
+/** Docs navigation, one Sidebar group per category: the desktop SiteSidebar and the phone menu share it. */
+export function DocsNav({ index, current, linkFor, onNavigate }) {
+    return (_jsx("nav", { "aria-label": "Docs", className: "flex flex-col", children: index.byCategory.map(({ category, docs }) => (_jsxs(SidebarGroup, { children: [_jsx(SidebarGroupLabel, { className: "font-mono uppercase", children: category }), _jsx(SidebarMenu, { children: docs.map((doc) => (_jsx(SidebarMenuItem, { children: _jsx(SidebarMenuButton, { isActive: doc.slug === current, render: linkFor(doc.slug), onClick: onNavigate, children: _jsx("span", { children: doc.title }) }) }, doc.slug))) })] }, category))) }));
+}
+//# sourceMappingURL=docs-nav.js.map

package/dist/docs/docs-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-nav.js","sourceRoot":"","sources":["../../src/docs/docs-nav.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,eAAe,GAClB,MAAM,uCAAuC,CAAC;AAc/C,4GAA4G;AAC5G,MAAM,UAAU,OAAO,CAAC,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe;IACvE,OAAO,CACH,4BAAgB,MAAM,EAAC,SAAS,EAAC,eAAe,YAC3C,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAC,EAAE,EAAE,CAAC,CACxC,MAAC,YAAY,eACT,KAAC,iBAAiB,IAAC,SAAS,EAAC,qBAAqB,YAAE,QAAQ,GAAqB,EACjF,KAAC,WAAW,cACP,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACf,KAAC,eAAe,cACZ,KAAC,iBAAiB,IACd,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO,EAC9B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,UAAU,YAEnB,yBAAO,GAAG,CAAC,KAAK,GAAQ,GACR,IAPF,GAAG,CAAC,IAAI,CAQZ,CACrB,CAAC,GACQ,KAdC,QAAQ,CAeZ,CAClB,CAAC,GACA,CACT,CAAC;AACN,CAAC"}

package/dist/docs/docs-search.d.ts

@@ -0,0 +1,19 @@
+import { type LucideIcon } from "lucide-react";
+import type { DocsIndex } from "./docs-index";
+export interface DocsSearchProps {
+    index: DocsIndex;
+    /** One icon per category, so a result's kind reads at a glance; `fallbackIcon` for the others. */
+    icons?: Record<string, LucideIcon>;
+    fallbackIcon?: LucideIcon;
+    /** Slugs shown before the first keystroke, in a "Suggested" group. */
+    suggested?: string[];
+    placeholder?: string;
+    /** Go to a page (the router's navigate). */
+    onSelect: (slug: string) => void;
+}
+/**
+ * The suite's docs search: SearchTrigger + hotkeys (Ctrl/⌘ K, `/`) opening a SearchDialog over the docs
+ * index, grouped by category, with a plain substring filter.
+ */
+export declare function DocsSearch({ index, icons, fallbackIcon, suggested, placeholder, onSelect, }: DocsSearchProps): import("react").JSX.Element;
+//# sourceMappingURL=docs-search.d.ts.map

package/dist/docs/docs-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-search.d.ts","sourceRoot":"","sources":["../../src/docs/docs-search.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,UAAU,EAAC,MAAM,cAAc,CAAC;AAG3D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACvB,KAAK,EACL,KAAU,EACV,YAA2B,EAC3B,SAAc,EACd,WAAgC,EAChC,QAAQ,GACX,EAAE,eAAe,+BAsDjB"}

package/dist/docs/docs-search.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Command, CommandEmpty, CommandGroup, CommandInput, CommandList } from "@repraze/kernelkit/components/command";
+import { SearchDialog, SearchFooter, SearchItem, substringFilter } from "@repraze/kernelkit/components/search-dialog";
+import { SearchTrigger, useSearchHotkeys } from "@repraze/kernelkit/components/search-trigger";
+import { FileTextIcon } from "lucide-react";
+import { useCallback, useState } from "react";
+/**
+ * The suite's docs search: SearchTrigger + hotkeys (Ctrl/⌘ K, `/`) opening a SearchDialog over the docs
+ * index, grouped by category, with a plain substring filter.
+ */
+export function DocsSearch({ index, icons = {}, fallbackIcon = FileTextIcon, suggested = [], placeholder = "Search the docs…", onSelect, }) {
+    const [open, setOpen] = useState(false);
+    const [query, setQuery] = useState("");
+    useSearchHotkeys(useCallback((toggle) => setOpen((o) => (toggle ? !o : true)), []));
+    const groups = query.trim()
+        ? index.byCategory
+        : [{ category: "Suggested", docs: suggested.flatMap((slug) => index.docs.filter((d) => d.slug === slug)) }];
+    return (_jsxs(_Fragment, { children: [_jsx(SearchTrigger, { onClick: () => setOpen(true), "aria-label": "Search docs" }), _jsx(SearchDialog, { open: open, onOpenChange: (next) => {
+                    setOpen(next);
+                    if (!next) {
+                        setQuery("");
+                    }
+                }, description: "Search the docs", children: _jsxs(Command, { filter: substringFilter, loop: true, children: [_jsx(CommandInput, { value: query, onValueChange: setQuery, placeholder: placeholder }), _jsxs(CommandList, { children: [_jsxs(CommandEmpty, { children: ["No results for \u201C", query, "\u201D."] }), groups.map(({ category, docs }) => (_jsx(CommandGroup, { heading: category, children: docs.map((doc) => {
+                                        const Icon = icons[doc.category] ?? fallbackIcon;
+                                        return (_jsx(SearchItem, { value: doc.title, keywords: [doc.category, doc.slug], icon: _jsx(Icon, {}), title: doc.title, description: doc.description, onSelect: () => {
+                                                setOpen(false);
+                                                setQuery("");
+                                                onSelect(doc.slug);
+                                            } }, doc.slug));
+                                    }) }, category)))] }), _jsx(SearchFooter, {})] }) })] }));
+}
+//# sourceMappingURL=docs-search.js.map

package/dist/docs/docs-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-search.js","sourceRoot":"","sources":["../../src/docs/docs-search.tsx"],"names":[],"mappings":"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"}

package/dist/docs/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./doc-kit";
+export * from "./doc-page";
+export * from "./docs-index";
+export * from "./docs-nav";
+export * from "./docs-search";
+export * from "./review-matrix";
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,7 @@
+export * from "./doc-kit";
+export * from "./doc-page";
+export * from "./docs-index";
+export * from "./docs-nav";
+export * from "./docs-search";
+export * from "./review-matrix";
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/docs/review-matrix.d.ts

@@ -0,0 +1,25 @@
+import type { Accent, Radius, ResolvedMode } from "@repraze/kernelkit/provider";
+import { type ThemeScopeProps } from "@repraze/kernelkit/provider";
+import type { DocEntry } from "./doc-kit";
+export interface ReviewScope {
+    label: string;
+    scope: Omit<ThemeScopeProps, "children">;
+}
+/**
+ * The GUIDELINES §8 scopes: dark, light and both high-contrast modes in the site's own accent and radius,
+ * then two variants (by default dark · radius-none · cyan and light · radius-xl · yellow).
+ */
+export declare function reviewScopes(site: {
+    accent: Accent;
+    radius: Radius;
+}, variants?: {
+    mode: ResolvedMode;
+    accent: Accent;
+    radius: Radius;
+}[]): ReviewScope[];
+/** Every demo of a page in each scope, side by side, for visual review (GUIDELINES §8). */
+export declare function ReviewMatrix({ doc, scopes }: {
+    doc: DocEntry;
+    scopes: ReviewScope[];
+}): import("react").JSX.Element;
+//# sourceMappingURL=review-matrix.d.ts.map

package/dist/docs/review-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-matrix.d.ts","sourceRoot":"","sources":["../../src/docs/review-matrix.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAC,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAa,KAAK,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAG7E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,IAAI,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,EACtC,QAAQ,GAAE;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,EAG7D,GACF,WAAW,EAAE,CAWf;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,EAAC,GAAG,EAAE,MAAM,EAAC,EAAE;IAAC,GAAG,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAC,+BA6BjF"}

package/dist/docs/review-matrix.js

@@ -0,0 +1,31 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { ThemeScope } from "@repraze/kernelkit/provider";
+import { cn } from "cn";
+/**
+ * The GUIDELINES §8 scopes: dark, light and both high-contrast modes in the site's own accent and radius,
+ * then two variants (by default dark · radius-none · cyan and light · radius-xl · yellow).
+ */
+export function reviewScopes(site, variants = [
+    { mode: "dark", accent: "cyan", radius: "none" },
+    { mode: "light", accent: "yellow", radius: "xl" },
+]) {
+    return [
+        { label: "dark", scope: { mode: "dark", contrast: "normal", ...site } },
+        { label: "light", scope: { mode: "light", contrast: "normal", ...site } },
+        { label: "dark · hc", scope: { mode: "dark", contrast: "high", ...site } },
+        { label: "light · hc", scope: { mode: "light", contrast: "high", ...site } },
+        ...variants.map(({ mode, accent, radius }) => ({
+            label: `${mode} · radius-${radius} · ${accent}`,
+            scope: { mode, contrast: "normal", accent, radius },
+        })),
+    ];
+}
+/** Every demo of a page in each scope, side by side, for visual review (GUIDELINES §8). */
+export function ReviewMatrix({ doc, scopes }) {
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-6", "data-slot": "review", children: [_jsxs("h1", { className: "font-mono text-lg font-semibold", children: [doc.title, " \u00B7 review"] }), doc.demos.map((demo) => {
+                const Component = demo.component;
+                return (_jsxs("section", { className: "flex flex-col gap-2", children: [_jsx("h2", { className: "font-mono text-sm text-muted-foreground", children: demo.title }), _jsx("div", { className: "grid grid-cols-2 gap-px overflow-hidden border bg-border", children: scopes.map(({ label, scope }) => (_jsxs(ThemeScope, { ...scope, className: "flex flex-col gap-3 p-4", children: [_jsx("span", { className: "font-mono text-[10px] text-muted-foreground", children: label }), _jsx("div", { className: cn("flex min-h-24 flex-1", demo.layout === "full" ? "" : "items-center justify-center"), children: _jsx(Component, {}) })] }, label))) })] }, demo.title));
+            })] }));
+}
+//# sourceMappingURL=review-matrix.js.map

package/dist/docs/review-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-matrix.js","sourceRoot":"","sources":["../../src/docs/review-matrix.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAC,UAAU,EAAuB,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAC,EAAE,EAAC,MAAM,IAAI,CAAC;AAStB;;;GAGG;AACH,MAAM,UAAU,YAAY,CACxB,IAAsC,EACtC,WAAmE;IAC/D,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAC;IAC9C,EAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAC;CAClD;IAED,OAAO;QACH,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAC,EAAC;QACnE,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAC,EAAC;QACrE,EAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAC,EAAC;QACtE,EAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAC,EAAC;QACxE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;YACzC,KAAK,EAAE,GAAG,IAAI,aAAa,MAAM,MAAM,MAAM,EAAE;YAC/C,KAAK,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,QAAiB,EAAE,MAAM,EAAE,MAAM,EAAC;SAC7D,CAAC,CAAC;KACN,CAAC;AACN,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,EAAC,GAAG,EAAE,MAAM,EAAyC;IAC9E,OAAO,CACH,eAAK,SAAS,EAAC,yBAAyB,eAAW,QAAQ,aACvD,cAAI,SAAS,EAAC,iCAAiC,aAAE,GAAG,CAAC,KAAK,sBAAe,EACxE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACpB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBACjC,OAAO,CACH,mBAA0B,SAAS,EAAC,qBAAqB,aACrD,aAAI,SAAS,EAAC,yCAAyC,YAAE,IAAI,CAAC,KAAK,GAAM,EACzE,cAAK,SAAS,EAAC,0DAA0D,YACpE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAC,KAAK,EAAE,KAAK,EAAC,EAAE,EAAE,CAAC,CAC5B,MAAC,UAAU,OAAiB,KAAK,EAAE,SAAS,EAAC,yBAAyB,aAClE,eAAM,SAAS,EAAC,6CAA6C,YAAE,KAAK,GAAQ,EAC5E,cACI,SAAS,EAAE,EAAE,CACT,sBAAsB,EACtB,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,6BAA6B,CAC9D,YAED,KAAC,SAAS,KAAG,GACX,KATO,KAAK,CAUT,CAChB,CAAC,GACA,KAhBI,IAAI,CAAC,KAAK,CAiBd,CACb,CAAC;YACN,CAAC,CAAC,IACA,CACT,CAAC;AACN,CAAC"}

package/dist/hooks/use-theme-palette.d.ts

@@ -0,0 +1,8 @@
+import { type Mode } from "@repraze/termicolor";
+/**
+ * The TermiColor mode that applies here (nearest ThemeScope, else the ThemeProvider): neutrals, accents
+ * and roles as hex strings, with `roles.accent` & co. in the current accent. For canvas, chart and WebGPU
+ * code that can't read CSS variables. Memoised per mode, contrast and accent.
+ */
+export declare function useThemePalette(): Mode;
+//# sourceMappingURL=use-theme-palette.d.ts.map

package/dist/hooks/use-theme-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme-palette.d.ts","sourceRoot":"","sources":["../../src/hooks/use-theme-palette.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAKvE;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAatC"}

package/dist/hooks/use-theme-palette.js

@@ -0,0 +1,24 @@
+import { useResolvedTheme } from "@repraze/kernelkit/provider";
+import { allModes, createPalette } from "@repraze/termicolor";
+import { useMemo } from "react";
+const cache = new Map();
+/**
+ * The TermiColor mode that applies here (nearest ThemeScope, else the ThemeProvider): neutrals, accents
+ * and roles as hex strings, with `roles.accent` & co. in the current accent. For canvas, chart and WebGPU
+ * code that can't read CSS variables. Memoised per mode, contrast and accent.
+ */
+export function useThemePalette() {
+    const { mode, contrast, accent } = useResolvedTheme();
+    return useMemo(() => {
+        const id = `${mode}${contrast === "high" ? "-hc" : ""}`;
+        const key = `${id}:${accent}`;
+        let found = cache.get(key);
+        if (!found) {
+            const modes = allModes(createPalette({ accent }));
+            found = modes.find((m) => m.id === id) ?? modes[0];
+            cache.set(key, found);
+        }
+        return found;
+    }, [mode, contrast, accent]);
+}
+//# sourceMappingURL=use-theme-palette.js.map

package/dist/hooks/use-theme-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme-palette.js","sourceRoot":"","sources":["../../src/hooks/use-theme-palette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAY,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAE9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC3B,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,GAAG,gBAAgB,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,EAAE;QAChB,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QAC9B,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC;YAChD,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC;YACpD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/hooks/use-time-format.d.ts

@@ -0,0 +1,23 @@
+/** `"auto"` follows the locale: 12 in en-US, 24 in fr-FR, en-GB or ja-JP. */
+type HourCyclePreference = 12 | 24 | "auto";
+interface TimeFormat {
+    locale: string;
+    hourCycle: 12 | 24;
+    /** Localized day periods: "AM" / "PM" in en-US, "a.m." / "p.m." in en-CA, "오전" / "오후" in ko. */
+    am: string;
+    pm: string;
+    /** The day period comes before the hour (ko, zh). */
+    periodFirst: boolean;
+    /** "09:30" (24h) or "9:30 AM" / "오전 9:30" (12h), in the locale's own pattern. */
+    format: (minutes: number) => string;
+    /** A two-digit segment in the locale's digits: "05", "٠٥" in ar-EG. */
+    digits: (n: number) => string;
+}
+/**
+ * Hour cycle, day-period labels and a formatter, from `Intl` for the resolved locale (see `useLocale`:
+ * prop › LocaleProvider › browser, hydration-safe). An explicit 12 / 24 overrides the locale's cycle.
+ */
+declare function useTimeFormat(preference?: HourCyclePreference, explicitLocale?: string): TimeFormat;
+export { useTimeFormat };
+export type { HourCyclePreference, TimeFormat };
+//# sourceMappingURL=use-time-format.d.ts.map

package/dist/hooks/use-time-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-time-format.d.ts","sourceRoot":"","sources":["../../src/hooks/use-time-format.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,KAAK,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;AAE5C,UAAU,UAAU;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC;IACnB,gGAAgG;IAChG,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,iFAAiF;IACjF,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,uEAAuE;IACvE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAID;;;GAGG;AACH,iBAAS,aAAa,CAAC,UAAU,GAAE,mBAA4B,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,CAwCpG;AAED,OAAO,EAAC,aAAa,EAAC,CAAC;AACvB,YAAY,EAAC,mBAAmB,EAAE,UAAU,EAAC,CAAC"}

package/dist/hooks/use-time-format.js

@@ -0,0 +1,52 @@
+"use client";
+import { useLocale } from "@repraze/kernelkit/components/locale";
+import * as React from "react";
+const pad = (n) => String(n).padStart(2, "0");
+/**
+ * Hour cycle, day-period labels and a formatter, from `Intl` for the resolved locale (see `useLocale`:
+ * prop › LocaleProvider › browser, hydration-safe). An explicit 12 / 24 overrides the locale's cycle.
+ */
+function useTimeFormat(preference = "auto", explicitLocale) {
+    const locale = useLocale(explicitLocale);
+    return React.useMemo(() => {
+        let hourCycle = preference === "auto" ? 24 : preference;
+        let am = "AM";
+        let pm = "PM";
+        let periodFirst = false;
+        let formatter = null;
+        let numbers = null;
+        try {
+            numbers = new Intl.NumberFormat(locale, { minimumIntegerDigits: 2, useGrouping: false });
+            if (preference === "auto") {
+                const hc = new Intl.DateTimeFormat(locale, { hour: "numeric" }).resolvedOptions().hourCycle;
+                hourCycle = hc === "h11" || hc === "h12" ? 12 : 24;
+            }
+            const f = new Intl.DateTimeFormat(locale, { hour: "numeric", hourCycle: "h12" });
+            const parts = (h) => f.formatToParts(new Date(2000, 0, 1, h));
+            am = parts(9).find((p) => p.type === "dayPeriod")?.value ?? am;
+            pm = parts(21).find((p) => p.type === "dayPeriod")?.value ?? pm;
+            const types = parts(9).map((p) => p.type);
+            periodFirst = types.includes("dayPeriod") && types.indexOf("dayPeriod") < types.indexOf("hour");
+            formatter = new Intl.DateTimeFormat(locale, {
+                hour: hourCycle === 24 ? "2-digit" : "numeric",
+                minute: "2-digit",
+                hourCycle: hourCycle === 24 ? "h23" : "h12",
+            });
+        }
+        catch {
+            formatter = null;
+        }
+        const format = (minutes) => {
+            const h = Math.floor(minutes / 60);
+            const m = minutes % 60;
+            if (formatter) {
+                return formatter.format(new Date(2000, 0, 1, h, m));
+            }
+            return hourCycle === 24 ? `${pad(h)}:${pad(m)}` : `${h % 12 || 12}:${pad(m)} ${h < 12 ? am : pm}`;
+        };
+        const digits = (n) => (numbers ? numbers.format(n) : pad(n));
+        return { locale, hourCycle, am, pm, periodFirst, format, digits };
+    }, [preference, locale]);
+}
+export { useTimeFormat };
+//# sourceMappingURL=use-time-format.js.map

package/dist/hooks/use-time-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-time-format.js","sourceRoot":"","sources":["../../src/hooks/use-time-format.ts"],"names":[],"mappings":"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"}

package/dist/lib/color.d.ts

@@ -6,9 +6,13 @@
  * - `--c-tint` opaque wash behind foreground text
  * - `--c-fill` / `--c-fill-fg` vivid solid surface and its text (TermiColor "fills are the brand":
  *   in light mode the text tier is darkened for contrast, the fill tier stays vivid)
+ * - `--c-soft-text` text on a wash of its own color (soft variants, soft status surfaces): `--c` mixed 25%
+ *   toward the foreground with its chroma restored, which keeps hue and saturation and passes WCAG AA
+ *   4.5:1 for every color, in light, dark and both hc modes, on background, card and popover (plain `--c`
+ *   on its own wash fell to ~3.6)
  *
  * Spread `colorVariants` into a cva `variants.color` map, then write variants against the vars
- * (`bg-(--c) text-(--c-fg)`, `bg-(--c)/12 text-(--c)`, …).
+ * (`bg-(--c) text-(--c-fg)`, `bg-(--c)/12 text-(--c-soft-text)`, …).
  */
 export declare const STATUS_COLORS: readonly ["danger", "warning", "success", "info"];
 export declare const HUES: readonly ["red", "orange", "yellow", "green", "cyan", "blue", "purple", "pink"];