@fairgarden/design 0.1.0-alpha.1 → 0.1.0-alpha.2

package/page/section-header/section-header.module.css

@@ -9,7 +9,7 @@
  *
  * Gaps are visual gaps [D74]: text parts trim their half-leading where the
  * browser supports `text-box`, so eyebrow → rule → content measure 14 / 19
- * (--ds-space-eyebrow-rule / --ds-space-eyebrow-content) [D100].
+ * (--fgd-space-eyebrow-rule / --fgd-space-eyebrow-content) [D100].
  */
 
 /* Composition sits in top-level rules, outside the layers: Lightning CSS
@@ -66,7 +66,7 @@
   .eyebrowRule {
     grid-area: rule;
     justify-self: stretch;
-    margin-block: var(--ds-space-eyebrow-rule) var(--ds-space-eyebrow-content);
+    margin-block: var(--fgd-space-eyebrow-rule) var(--fgd-space-eyebrow-content);
     border-width: 0;
     border-block-start-width: var(--border-size-1);
     border-color: var(--role-hairline);
@@ -81,7 +81,7 @@
 
   .lede {
     grid-area: lede;
-    max-inline-size: var(--ds-measure-reading);
+    max-inline-size: var(--fgd-measure-reading);
     margin: var(--size-px-5) 0 0;
     color: var(--primary12);
     text-box: trim-both cap alphabetic;
@@ -92,7 +92,7 @@
     display: flex;
     flex-wrap: wrap;
     align-items: center;
-    gap: var(--ds-space-12);
+    gap: var(--size-px-2-5);
     margin-block-start: var(--size-px-5);
   }
 
@@ -101,7 +101,7 @@
     display: flex;
     flex-wrap: wrap;
     align-items: baseline;
-    gap: var(--ds-space-12);
+    gap: var(--size-px-2-5);
     margin: 0;
     color: var(--primary12);
     text-box: trim-both cap alphabetic;
@@ -111,13 +111,13 @@
     color: var(--primary12);
   }
 
-  /* Trail kicker: the kicker threaded by the trail, --ds-space-halo either side. */
+  /* Trail kicker: the kicker threaded by the trail, --fgd-space-halo either side. */
   .kickerRow {
     display: flex;
     align-items: center;
-    gap: var(--ds-space-halo);
+    gap: var(--fgd-space-halo);
     max-inline-size: 100%;
-    margin-block-end: var(--ds-space-56);
+    margin-block-end: var(--size-px-8-5);
   }
 
   .kicker {
@@ -138,15 +138,15 @@
 
   .marker {
     fill: none;
-    stroke-width: var(--ds-stroke-1-5);
+    stroke-width: var(--border-size-1-5);
     stroke-dasharray: none;
     stroke-linecap: round;
     stroke-linejoin: round;
   }
 
-  /* Anchored: the sticker at --ds-size-art-s; its halo touches the cap tops, no gap. */
+  /* Anchored: the sticker at --fgd-size-art-s; its halo touches the cap tops, no gap. */
   .art {
-    inline-size: var(--ds-size-art-s);
+    inline-size: var(--fgd-size-art-s);
   }
 
   .art > * {
@@ -159,13 +159,13 @@
     margin-block-end: var(--size-px-3);
   }
 
-  /* "See all →": a standalone link, underlined at rest, --ds-size-hit tall. */
+  /* "See all →": a standalone link, underlined at rest, --fgd-size-hit tall. */
   .seeAll {
     grid-area: seeAll;
     display: inline-flex;
     align-items: center;
     gap: var(--size-px-2);
-    min-block-size: var(--ds-size-hit);
+    min-block-size: var(--fgd-size-hit);
     margin-block-start: var(--size-px-5);
     border-radius: var(--radius-1);
     color: var(--primary12);
@@ -175,7 +175,7 @@
   .seeAllLabel {
     text-decoration-line: underline;
     text-decoration-color: var(--role-accent);
-    text-decoration-thickness: var(--ds-stroke-1-5);
+    text-decoration-thickness: var(--border-size-1-5);
     text-underline-offset: 0.15em;
     text-decoration-skip-ink: none;
   }
@@ -190,7 +190,7 @@
 
   @media (prefers-reduced-motion: no-preference) {
     .seeAllLabel {
-      transition: color var(--ds-duration-quick) var(--ease-out-3);
+      transition: color var(--fgd-duration-quick) var(--ease-out-3);
     }
   }
 
@@ -213,7 +213,7 @@
     .seeAll {
       align-self: last baseline;
       margin-block-start: 0;
-      margin-inline-start: var(--ds-space-40);
+      margin-inline-start: var(--size-px-7-5);
     }
   }
 }

package/utils/Ornament.d.ts

@@ -81,7 +81,7 @@ export type OrnamentBlobProps = Omit<React.ComponentPropsWithRef<'span'>, 'child
     secondary?: RadixScale;
 };
 /**
- * `ornament-blob` (§6.6, §1.5.16): the LTA blob mount, a flat hand-cut disc
+ * `ornament-blob` (§6.6, §1.5.16): the blob mount, a flat hand-cut disc
  * in `--secondary9` over a larger, turned under-disc in `--secondary7`,
  * holding a centred mark in `--secondary-contrast`. Once per page, at a
  * fixed 136 × 130 px. On `forest` and the solid fields the mount is omitted

package/utils/Ornament.js

@@ -84,7 +84,7 @@ export function MarkerRank(props) {
  * wanders and turns down into its terminal, pointing at what follows below
  * (the empty state's action). `entry` (176 × 56) loops once near its start
  * (≈ 22 × 40 px), then runs level into a label at its inline end; the label
- * sits --ds-space-halo past the terminal.
+ * sits --fgd-space-halo past the terminal.
  */
 const trails = {
     'short-tail': {
@@ -132,7 +132,7 @@ const BLOB_UNDER = 'translate(68 65) rotate(8) scale(1.04) translate(-68 -65)';
 /** The grounds that take the mount (§6.6, §1.5.16): the page grounds and the night band. */
 const MOUNT_TONES = new Set(['light-base', 'tinted', 'dark-base']);
 /**
- * `ornament-blob` (§6.6, §1.5.16): the LTA blob mount, a flat hand-cut disc
+ * `ornament-blob` (§6.6, §1.5.16): the blob mount, a flat hand-cut disc
  * in `--secondary9` over a larger, turned under-disc in `--secondary7`,
  * holding a centred mark in `--secondary-contrast`. Once per page, at a
  * fixed 136 × 130 px. On `forest` and the solid fields the mount is omitted

package/utils/assignRef.d.ts

@@ -1,7 +1,13 @@
-import type * as React from 'react';
+import * as React from 'react';
 /**
  * Writes a node to a consumer's ref (callback or object), for a component
  * that also keeps its own ref to the same node. Not exported from any index.
  */
 export declare function assignRef<T>(ref: React.Ref<T> | undefined, value: T | null): void;
+/**
+ * One ref for two: either alone when the other is missing, else a callback
+ * that writes both, whose identity changes only with theirs. Not exported
+ * from any index.
+ */
+export declare function useMergedRef<T>(a: React.Ref<T> | undefined, b: React.Ref<T> | undefined): React.Ref<T> | undefined;
 //# sourceMappingURL=assignRef.d.ts.map

package/utils/assignRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assignRef.d.ts","sourceRoot":"","sources":["../src/utils/assignRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,QAG1E"}
+{"version":3,"file":"assignRef.d.ts","sourceRoot":"","sources":["../src/utils/assignRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,QAG1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3B,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAS1B"}

package/utils/assignRef.js

@@ -1,3 +1,4 @@
+import * as React from 'react';
 /**
  * Writes a node to a consumer's ref (callback or object), for a component
  * that also keeps its own ref to the same node. Not exported from any index.
@@ -8,4 +9,21 @@ export function assignRef(ref, value) {
     else if (ref)
         ref.current = value;
 }
+/**
+ * One ref for two: either alone when the other is missing, else a callback
+ * that writes both, whose identity changes only with theirs. Not exported
+ * from any index.
+ */
+export function useMergedRef(a, b) {
+    return React.useMemo(() => {
+        if (!a)
+            return b;
+        if (!b)
+            return a;
+        return (node) => {
+            assignRef(a, node);
+            assignRef(b, node);
+        };
+    }, [a, b]);
+}
 //# sourceMappingURL=assignRef.js.map

package/utils/assignRef.js.map

@@ -1 +1 @@
-{"version":3,"file":"assignRef.js","sourceRoot":"","sources":["../src/utils/assignRef.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,GAA6B,EAAE,KAAe;IACzE,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,GAAG,CAAC,KAAK,CAAC,CAAA;SACpC,IAAI,GAAG;QAAG,GAAiC,CAAC,OAAO,GAAG,KAAK,CAAA;AAClE,CAAC"}
+{"version":3,"file":"assignRef.js","sourceRoot":"","sources":["../src/utils/assignRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,GAA6B,EAAE,KAAe;IACzE,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,GAAG,CAAC,KAAK,CAAC,CAAA;SACpC,IAAI,GAAG;QAAG,GAAiC,CAAC,OAAO,GAAG,KAAK,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,CAA2B,EAC3B,CAA2B;IAE3B,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACxB,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAA;QAChB,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAA;QAChB,OAAO,CAAC,IAAc,EAAE,EAAE;YACxB,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;YAClB,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QACpB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACZ,CAAC"}

package/utils/docs/DemoTitle.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+/** Props the demo factories hand their `DemoTitle`. */
+export type DemoTitleProps = {
+    slug?: string;
+    children?: string;
+};
+/**
+ * The heading the demo factories render for `<DemoX.Title />`: an H3 in
+ * type-subhead that links to itself, so a demo can be linked by its slug.
+ */
+export declare function DemoTitle({ slug, children }: DemoTitleProps): React.JSX.Element;
+//# sourceMappingURL=DemoTitle.d.ts.map

package/utils/docs/DemoTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoTitle.d.ts","sourceRoot":"","sources":["../../src/utils/docs/DemoTitle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,cAAc,qBAU3D"}

package/utils/docs/DemoTitle.js

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import styles from './mdx.module.css';
+/**
+ * The heading the demo factories render for `<DemoX.Title />`: an H3 in
+ * type-subhead that links to itself, so a demo can be linked by its slug.
+ */
+export function DemoTitle({ slug, children }) {
+    return slug ? (React.createElement("h3", { id: slug, className: styles.demoTitle },
+        React.createElement("a", { href: `#${slug}`, className: styles.anchor }, children))) : (React.createElement("h3", { className: styles.demoTitle }, children));
+}
+//# sourceMappingURL=DemoTitle.js.map

package/utils/docs/DemoTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoTitle.js","sourceRoot":"","sources":["../../src/utils/docs/DemoTitle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,MAAM,MAAM,kBAAkB,CAAA;AAKrC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAkB;IAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,CACZ,4BAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS;QACvC,2BAAG,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,IAC1C,QAAQ,CACP,CACD,CACN,CAAC,CAAC,CAAC,CACF,4BAAI,SAAS,EAAE,MAAM,CAAC,SAAS,IAAG,QAAQ,CAAM,CACjD,CAAA;AACH,CAAC"}

package/utils/docs/Pre.d.ts

@@ -0,0 +1,39 @@
+import * as React from 'react';
+import type { CodeHighlighterProps } from '@fairgarden/docs/CodeHighlighter/types';
+/** What the docs pipeline puts on a fenced block's `pre`, plus the slots. */
+export type PreProps = {
+    'data-name'?: string;
+    'data-slug'?: string;
+    'data-precompute'?: string;
+    'data-content-props'?: string;
+    /** CodeHighlighter's `Content`. Default: `CodeBlockLazy`. */
+    Content?: CodeHighlighterProps<object>['Content'];
+    /** CodeHighlighter's `ContentLoading`. Default: `CodeBlockLoading`. */
+    ContentLoading?: CodeHighlighterProps<object>['ContentLoading'];
+    /**
+     * When the code highlights. Default: the engine's own (`'idle'`: the server
+     * HTML carries the plain code, highlighted once the browser is idle). Pass
+     * `'init'` only to show server-side highlighting: the HTML then arrives
+     * highlighted, at the cost of server work and page weight.
+     */
+    highlightAfter?: CodeHighlighterProps<object>['highlightAfter'];
+    /**
+     * The source enhancers the server runs on code it parses. Default
+     * `serverSourceEnhancers` (the engine's emphasis enhancer, with the
+     * options demos get), so the emphasis window is in the server HTML and
+     * nothing changes size after hydration [D201]. A fence the build
+     * precomputed already carries its window; this covers any code the server
+     * still parses. Pass `[]` to run none.
+     */
+    sourceEnhancers?: CodeHighlighterProps<object>['sourceEnhancers'];
+};
+/**
+ * The MDX `pre` override, as fg-docs' own `Pre`: the docs pipeline
+ * (`transformHtmlCodeBlock`) replaces every fenced code block with
+ * `<pre data-precompute=…>`, which only CodeHighlighter can render. Each
+ * renders as a Code Block, code-split, with its loading state until the
+ * chunk loads, and its emphasis window in the server HTML. A fence's flags
+ * (` ```tsx collapse `) arrive in `data-content-props`.
+ */
+export declare function Pre(props: PreProps): React.JSX.Element;
+//# sourceMappingURL=Pre.d.ts.map

package/utils/docs/Pre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pre.d.ts","sourceRoot":"","sources":["../../src/utils/docs/Pre.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAA;AAMlF,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAA;IACjD,uEAAuE;IACvE,cAAc,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAA;IAC/D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAA;IAC/D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAA;CAClE,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,qBAmClC"}

package/utils/docs/Pre.js

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import { CodeHighlighter } from '@fairgarden/docs/CodeHighlighter';
+import { CodeBlockLazy } from '../../content/code-block/CodeBlockLazy';
+import { CodeBlockLoading } from '../../content/code-block/CodeBlockLoading';
+import { serverSourceEnhancers } from './serverSourceEnhancers';
+/**
+ * The MDX `pre` override, as fg-docs' own `Pre`: the docs pipeline
+ * (`transformHtmlCodeBlock`) replaces every fenced code block with
+ * `<pre data-precompute=…>`, which only CodeHighlighter can render. Each
+ * renders as a Code Block, code-split, with its loading state until the
+ * chunk loads, and its emphasis window in the server HTML. A fence's flags
+ * (` ```tsx collapse `) arrive in `data-content-props`.
+ */
+export function Pre(props) {
+    const { Content = CodeBlockLazy, ContentLoading = CodeBlockLoading, highlightAfter, sourceEnhancers = serverSourceEnhancers, } = props;
+    if (!props['data-precompute']) {
+        return (React.createElement("div", null, "Expected precompute data. Ensure the transformHtmlCodeBlock rehype plugin is used."));
+    }
+    const precompute = JSON.parse(props['data-precompute']);
+    const contentProps = props['data-content-props'] ? JSON.parse(props['data-content-props']) : {};
+    // A fence with variants hands the loading state every variant, so it draws
+    // the variant Select the loaded block shows and the header keeps its size.
+    const multipleVariants = Object.keys(precompute ?? {}).length > 1;
+    return (React.createElement(CodeHighlighter, { name: props['data-name'], slug: props['data-slug'], precompute: precompute, Content: Content, ContentLoading: ContentLoading, contentProps: contentProps, highlightAfter: highlightAfter, sourceEnhancers: sourceEnhancers, fallbackUsesAllVariants: multipleVariants || undefined }));
+}
+//# sourceMappingURL=Pre.js.map

package/utils/docs/Pre.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pre.js","sourceRoot":"","sources":["../../src/utils/docs/Pre.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AA8B/D;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,CAAC,KAAe;IACjC,MAAM,EACJ,OAAO,GAAG,aAAa,EACvB,cAAc,GAAG,gBAAgB,EACjC,cAAc,EACd,eAAe,GAAG,qBAAqB,GACxC,GAAG,KAAK,CAAA;IAET,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9B,OAAO,CACL,sHAEM,CACP,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAA+C,CAAA;IACrG,MAAM,YAAY,GAAG,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,2EAA2E;IAC3E,2EAA2E;IAC3E,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAEjE,OAAO,CACL,oBAAC,eAAe,IACd,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,EACxB,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,EACxB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,eAAe,EAChC,uBAAuB,EAAE,gBAAgB,IAAI,SAAS,GACtD,CACH,CAAA;AACH,CAAC"}

package/utils/docs/createDemo.d.ts

@@ -0,0 +1,89 @@
+import { createDemoFactory as createEngineDemoFactory, createDemoWithVariantsFactory as createEngineDemoWithVariantsFactory } from '@fairgarden/docs/abstractCreateDemo';
+import type { DemoOptions } from '../../content/demo/DemoContent';
+/** The engine's demo factory options (`createDemoFactory` from `@fairgarden/docs/abstractCreateDemo`). */
+export type DemoFactoryOptions<T extends {} = DemoOptions> = Parameters<typeof createEngineDemoFactory<T>>[0];
+/** What `createDemoFactory` returns: `createDemo(url, component, meta?)`. */
+export type CreateDemo<T extends {} = DemoOptions> = ReturnType<typeof createEngineDemoFactory<T>>;
+/** What `createDemoWithVariantsFactory` returns: `createDemoWithVariants(url, variants, meta?)`. */
+export type CreateDemoWithVariants<T extends {} = DemoOptions> = ReturnType<typeof createEngineDemoWithVariantsFactory<T>>;
+/**
+ * The engine's `createDemoFactory` with the design system's defaults
+ * (`DemoContent: DemoLazy`, `DemoContentLoading: DemoLoading`, `DemoTitle`,
+ * `projectDir` / `projectUrl` from `SOURCE_CODE_ROOT_DIR` /
+ * `SOURCE_CODE_ROOT_URL`); `options` override any. `highlightAfter` is left
+ * to the engine's default (`'idle'`); pass `'init'` only where a demo shows
+ * server-side highlighting.
+ */
+export declare function createDemoFactory<T extends {} = DemoOptions>(options?: Partial<DemoFactoryOptions<T>>): CreateDemo<T>;
+/**
+ * As `createDemoFactory`, over the engine's `createDemoWithVariantsFactory`,
+ * with `fallbackUsesAllVariants: true`: the loading state gets every
+ * variant, so it draws the variant Select (nothing shifts at the swap) and
+ * every variant's `#slug` targets.
+ */
+export declare function createDemoWithVariantsFactory<T extends {} = DemoOptions>(options?: Partial<DemoFactoryOptions<T>>): CreateDemoWithVariants<T>;
+/**
+ * Creates a demo: the component rendered above its highlighted source.
+ * @param url `import.meta.url` of the demo's `index.ts`.
+ * @param component The component to render.
+ * @param meta Optional `name`, `slug` and display options.
+ */
+export declare const createDemo: (url: string, component: React.ComponentType, meta?: {
+    name?: string;
+    slug?: string;
+    displayName?: string;
+    variantType?: string;
+    skipPrecompute?: boolean;
+    highlightAfter?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["highlightAfter"];
+    enhanceAfter?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["enhanceAfter"];
+    editActivation?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["editActivation"];
+    precompute?: import("@fairgarden/docs/CodeHighlighter/types").Code;
+    ClientProvider?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    collapseToEmpty?: boolean;
+    showCollapsedFocus?: boolean;
+    initialExpanded?: boolean;
+    initialCollapsed?: boolean;
+    initialDisabled?: boolean;
+}) => import("react").ComponentType<import("../../content/code-block").CodeBlockOptions & {
+    collapseToEmpty?: boolean;
+    showCollapsedFocus?: boolean;
+    initialExpanded?: boolean;
+    initialCollapsed?: boolean;
+}> & {
+    Title: React.ComponentType;
+};
+/**
+ * As `createDemo`, with switchable variants of the same demo.
+ * @param url `import.meta.url` of the demo's `index.ts`.
+ * @param variants The variants, keyed by name (`{ CssModules, Tag }`).
+ * @param meta Optional `name`, `slug` and display options.
+ */
+export declare const createDemoWithVariants: (url: string, variants: Record<string, React.ComponentType>, meta?: {
+    name?: string;
+    slug?: string;
+    displayName?: string;
+    variantType?: string;
+    skipPrecompute?: boolean;
+    highlightAfter?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["highlightAfter"];
+    enhanceAfter?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["enhanceAfter"];
+    editActivation?: import("@fairgarden/docs/CodeHighlighter/types").CodeHighlighterProps<{}>["editActivation"];
+    precompute?: import("@fairgarden/docs/CodeHighlighter/types").Code;
+    ClientProvider?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    collapseToEmpty?: boolean;
+    showCollapsedFocus?: boolean;
+    initialExpanded?: boolean;
+    initialCollapsed?: boolean;
+    initialDisabled?: boolean;
+}) => import("react").ComponentType<import("../../content/code-block").CodeBlockOptions & {
+    collapseToEmpty?: boolean;
+    showCollapsedFocus?: boolean;
+    initialExpanded?: boolean;
+    initialCollapsed?: boolean;
+}> & {
+    Title: React.ComponentType;
+};
+//# sourceMappingURL=createDemo.d.ts.map

package/utils/docs/createDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDemo.d.ts","sourceRoot":"","sources":["../../src/utils/docs/createDemo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,IAAI,uBAAuB,EAC5C,6BAA6B,IAAI,mCAAmC,EACrE,MAAM,qCAAqC,CAAA;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAajE,0GAA0G;AAC1G,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,IAAI,UAAU,CACrE,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAClC,CAAC,CAAC,CAAC,CAAA;AAEJ,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,IAAI,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAA;AAElG,oGAAoG;AACpG,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,IAAI,UAAU,CACzE,OAAO,mCAAmC,CAAC,CAAC,CAAC,CAC9C,CAAA;AAkBD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,EAC1D,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAM,GAC3C,UAAU,CAAC,CAAC,CAAC,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,EACtE,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAM,GAC3C,sBAAsB,CAAC,CAAC,CAAC,CAI3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CAAsC,CAAA;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;CAAkD,CAAA"}

package/utils/docs/createDemo.js

@@ -0,0 +1,51 @@
+import { createDemoFactory as createEngineDemoFactory, createDemoWithVariantsFactory as createEngineDemoWithVariantsFactory, } from '@fairgarden/docs/abstractCreateDemo';
+import { DemoLazy } from '../../content/demo/DemoLazy';
+import { DemoLoading } from '../../content/demo/DemoLoading';
+import { DemoTitle } from './DemoTitle';
+function demoOptions(options, defaults = {}) {
+    return {
+        DemoContent: DemoLazy,
+        DemoContentLoading: DemoLoading,
+        DemoTitle,
+        // Set by `withDeploymentConfig`: turns file:// source URLs into hosted links.
+        projectDir: process.env.SOURCE_CODE_ROOT_DIR,
+        projectUrl: process.env.SOURCE_CODE_ROOT_URL,
+        ...defaults,
+        ...options,
+    };
+}
+/**
+ * The engine's `createDemoFactory` with the design system's defaults
+ * (`DemoContent: DemoLazy`, `DemoContentLoading: DemoLoading`, `DemoTitle`,
+ * `projectDir` / `projectUrl` from `SOURCE_CODE_ROOT_DIR` /
+ * `SOURCE_CODE_ROOT_URL`); `options` override any. `highlightAfter` is left
+ * to the engine's default (`'idle'`); pass `'init'` only where a demo shows
+ * server-side highlighting.
+ */
+export function createDemoFactory(options = {}) {
+    return createEngineDemoFactory(demoOptions(options));
+}
+/**
+ * As `createDemoFactory`, over the engine's `createDemoWithVariantsFactory`,
+ * with `fallbackUsesAllVariants: true`: the loading state gets every
+ * variant, so it draws the variant Select (nothing shifts at the swap) and
+ * every variant's `#slug` targets.
+ */
+export function createDemoWithVariantsFactory(options = {}) {
+    return createEngineDemoWithVariantsFactory(demoOptions(options, { fallbackUsesAllVariants: true }));
+}
+/**
+ * Creates a demo: the component rendered above its highlighted source.
+ * @param url `import.meta.url` of the demo's `index.ts`.
+ * @param component The component to render.
+ * @param meta Optional `name`, `slug` and display options.
+ */
+export const createDemo = /* @__PURE__ */ createDemoFactory();
+/**
+ * As `createDemo`, with switchable variants of the same demo.
+ * @param url `import.meta.url` of the demo's `index.ts`.
+ * @param variants The variants, keyed by name (`{ CssModules, Tag }`).
+ * @param meta Optional `name`, `slug` and display options.
+ */
+export const createDemoWithVariants = /* @__PURE__ */ createDemoWithVariantsFactory();
+//# sourceMappingURL=createDemo.js.map

package/utils/docs/createDemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDemo.js","sourceRoot":"","sources":["../../src/utils/docs/createDemo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,IAAI,uBAAuB,EAC5C,6BAA6B,IAAI,mCAAmC,GACrE,MAAM,qCAAqC,CAAA;AAG5C,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAuBvC,SAAS,WAAW,CAClB,OAAuC,EACvC,WAA2C,EAAE;IAE7C,OAAO;QACL,WAAW,EAAE,QAAgD;QAC7D,kBAAkB,EAAE,WAA0D;QAC9E,SAAS;QACT,8EAA8E;QAC9E,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAC5C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAC5C,GAAG,QAAQ;QACX,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA0C,EAAE;IAE5C,OAAO,uBAAuB,CAAI,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA0C,EAAE;IAE5C,OAAO,mCAAmC,CACxC,WAAW,CAAC,OAAO,EAAE,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CACxD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC,iBAAiB,EAAE,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC,6BAA6B,EAAE,CAAA"}

package/utils/docs/createMdxComponents.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import { type PreProps } from './Pre';
+type ElementProps<T extends keyof React.JSX.IntrinsicElements> = React.ComponentProps<T>;
+/** A link component for internal hrefs, such as next/link. */
+export type MdxLinkComponent = React.ComponentType<{
+    href: string;
+    children?: React.ReactNode;
+    className?: string;
+}>;
+/** Options for createMdxComponents. Every one is optional. */
+export type CreateMdxComponentsOptions = {
+    /**
+     * Renders links to internal paths (`/…`), such as next/link, as the
+     * design system's Link's element. Default: a plain `a`.
+     */
+    Link?: MdxLinkComponent;
+    /** Renders `img`, such as next/image. Default: the plain element. */
+    Image?: React.ElementType<ElementProps<'img'>>;
+    /** Fenced blocks' CodeHighlighter `Content`. Default: `CodeBlockLazy`. */
+    Content?: PreProps['Content'];
+    /** Fenced blocks' CodeHighlighter `ContentLoading`. Default: `CodeBlockLoading`. */
+    ContentLoading?: PreProps['ContentLoading'];
+    /**
+     * When fenced blocks highlight. Default: the engine's own (`'idle'`). Pass
+     * `'init'` only to show server-side highlighting, which costs server work
+     * and page weight.
+     */
+    highlightAfter?: PreProps['highlightAfter'];
+    /**
+     * The source enhancers the server runs on fenced blocks' code. Default
+     * `serverSourceEnhancers`: the engine's emphasis enhancer with the options
+     * demos get, so every block's emphasis window is in the first paint and
+     * nothing changes size after hydration [D201]. Pass the enhancers your
+     * `demoEmphasisOptions` make, if you set them, or `[]` to run none.
+     */
+    sourceEnhancers?: PreProps['sourceEnhancers'];
+    /** More components, or replacements for any of the map's, merged last. */
+    components?: Record<string, React.ElementType>;
+};
+/** The map createMdxComponents returns. */
+export type MdxComponents = Record<string, React.ElementType>;
+/**
+ * The MDX component map: `pre` (the Code Block, through CodeHighlighter),
+ * `code` (inline code in the syntax tiers), `h1`–`h4` (h2–h4 link to
+ * themselves), `p`, `a` (the design system's Link), `ul`, `ol`, `table`,
+ * `blockquote`, `hr`, and `img` when an `Image` is given. Use it as the
+ * return of your `useMDXComponents`, and as the types factories'
+ * `components`.
+ */
+export declare function createMdxComponents(options?: CreateMdxComponentsOptions): MdxComponents;
+export {};
+//# sourceMappingURL=createMdxComponents.d.ts.map

package/utils/docs/createMdxComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMdxComponents.d.ts","sourceRoot":"","sources":["../../src/utils/docs/createMdxComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA;AAY1C,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;AAExF,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC,CAAA;AAEF,8DAA8D;AAC9D,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,qEAAqE;IACrE,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9C,0EAA0E;IAC1E,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC7B,oFAAoF;IACpF,cAAc,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAC3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAC3C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAC7C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;CAC/C,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;AAsB7D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa,CAwE3F"}

package/utils/docs/createMdxComponents.js

@@ -0,0 +1,59 @@
+import * as React from 'react';
+import { Link as DesignLink } from '../../actions/link';
+import { cx } from '../className';
+import { Pre } from './Pre';
+import styles from './mdx.module.css';
+/** A heading that links to itself when it has an id (rehype-slug gives each one). */
+function heading(Tag, className) {
+    function Heading({ className: extra, id, children, ...props }) {
+        const Element = Tag;
+        return (React.createElement(Element, { ...props, id: id, className: cx(className, extra) }, id ? (React.createElement("a", { href: `#${id}`, className: styles.anchor }, children)) : (children)));
+    }
+    Heading.displayName = `Mdx${Tag.toUpperCase()}`;
+    return Heading;
+}
+/**
+ * The MDX component map: `pre` (the Code Block, through CodeHighlighter),
+ * `code` (inline code in the syntax tiers), `h1`–`h4` (h2–h4 link to
+ * themselves), `p`, `a` (the design system's Link), `ul`, `ol`, `table`,
+ * `blockquote`, `hr`, and `img` when an `Image` is given. Use it as the
+ * return of your `useMDXComponents`, and as the types factories'
+ * `components`.
+ */
+export function createMdxComponents(options = {}) {
+    const { Link, Image, Content, ContentLoading, highlightAfter, sourceEnhancers, components } = options;
+    function MdxPre(props) {
+        return (React.createElement(Pre, { Content: Content, ContentLoading: ContentLoading, highlightAfter: highlightAfter, sourceEnhancers: sourceEnhancers, ...props }));
+    }
+    /**
+     * Links in running text are the design system's inline Link. Internal
+     * links render through `Link` when given; absolute URLs get the external
+     * mark.
+     */
+    function MdxA({ href = '', children, id }) {
+        if (href.startsWith('/') && Link) {
+            return (React.createElement(DesignLink, { id: id, render: React.createElement(Link, { href: href }) }, children));
+        }
+        return (React.createElement(DesignLink, { id: id, href: href, external: /^https?:\/\//.test(href) || undefined }, children));
+    }
+    const map = {
+        pre: MdxPre,
+        code: ({ className, ...props }) => (React.createElement("code", { ...props, className: cx(styles.code, className) })),
+        h1: ({ className, ...props }) => (React.createElement("h1", { ...props, className: cx(styles.h1, className) })),
+        h2: heading('h2', styles.h2),
+        h3: heading('h3', styles.h3),
+        h4: heading('h4', styles.h4),
+        p: ({ className, ...props }) => (React.createElement("p", { ...props, className: cx(styles.p, className) })),
+        a: MdxA,
+        ul: ({ className, ...props }) => (React.createElement("ul", { ...props, className: cx(styles.list, className) })),
+        ol: ({ className, ...props }) => (React.createElement("ol", { ...props, className: cx(styles.list, className) })),
+        table: ({ className, ...props }) => (React.createElement("div", { className: styles.tableWrap },
+            React.createElement("table", { ...props, className: cx(styles.table, className) }))),
+        blockquote: ({ className, ...props }) => (React.createElement("blockquote", { ...props, className: cx(styles.blockquote, className) })),
+        hr: ({ className, ...props }) => (React.createElement("hr", { ...props, className: cx(styles.hr, className) })),
+    };
+    if (Image)
+        map.img = Image;
+    return { ...map, ...components };
+}
+//# sourceMappingURL=createMdxComponents.js.map

package/utils/docs/createMdxComponents.js.map

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

package/utils/docs/createTypes.d.ts

@@ -0,0 +1,23 @@
+import { createMultipleTypesFactory as createEngineMultipleTypesFactory, createTypesFactory as createEngineTypesFactory, type AbstractCreateTypesOptions } from '@fairgarden/docs/abstractCreateTypes';
+/** The engine's types factory options (`@fairgarden/docs/abstractCreateTypes`). */
+export type TypesFactoryOptions = AbstractCreateTypesOptions;
+/** What `createTypesFactory` returns: `createTypes(url, component, meta?)`. */
+export type CreateTypes = ReturnType<typeof createEngineTypesFactory>;
+/** What `createMultipleTypesFactory` returns: `createMultipleTypes(url, components, meta?)`. */
+export type CreateMultipleTypes = ReturnType<typeof createEngineMultipleTypesFactory>;
+/** The engine's `createTypesFactory` with `TypesTable` and `TypePre`; `options` override either. */
+export declare function createTypesFactory(options?: Partial<TypesFactoryOptions>): CreateTypes;
+/** As `createTypesFactory`, over the engine's `createMultipleTypesFactory`. */
+export declare function createMultipleTypesFactory(options?: Partial<TypesFactoryOptions>): CreateMultipleTypes;
+/**
+ * The API table for one export, extracted from TypeScript at build time.
+ * @param url `import.meta.url` of the page's `types.ts`.
+ * @param component The export to document.
+ */
+export declare const createTypes: (url: string, typeDef: object, meta?: import("@fairgarden/docs/abstractCreateTypes").TypesTableMeta | undefined) => import("react").ComponentType<{}>;
+/** API tables for several related exports, rendered as `<TypesX.Part />`. */
+export declare const createMultipleTypes: <K extends Record<string, any>>(url: string, typeDef: K, meta?: import("@fairgarden/docs/abstractCreateTypes").TypesTableMeta | undefined) => {
+    types: Record<keyof K, import("react").ComponentType<{}>>;
+    AdditionalTypes: import("react").ComponentType<{}>;
+};
+//# sourceMappingURL=createTypes.d.ts.map

package/utils/docs/createTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTypes.d.ts","sourceRoot":"","sources":["../../src/utils/docs/createTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,IAAI,gCAAgC,EAC9D,kBAAkB,IAAI,wBAAwB,EAC9C,KAAK,0BAA0B,EAChC,MAAM,sCAAsC,CAAA;AAa7C,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,CAAA;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAErE,gGAAgG;AAChG,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAUrF,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,WAAW,CAE1F;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,mBAAmB,CAErB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,uJAAuC,CAAA;AAE/D,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;;;CAA+C,CAAA"}