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

package/content/carousel/carousel.module.css

@@ -9,7 +9,9 @@
  * the inverse pair); count --primary12; rail --role-hairline; railThumb
  * --primary12. Colors are role variables only; local custom properties
  * carry dimensions only (--carousel-slide, --carousel-bleed,
- * --carousel-ratio, a unitless ratio).
+ * --carousel-ratio, a unitless ratio). The component writes only custom
+ * properties inline (--carousel-bleed on the root, --carousel-ratio on a
+ * slide); these rules map them to real properties [D205].
  */
 
 /* Composition sits in top-level rules, outside the layers: Lightning CSS
@@ -45,7 +47,7 @@
     --carousel-slide: 88%;
 
     display: flex;
-    gap: var(--ds-space-12);
+    gap: var(--size-px-2-5);
     margin: 0;
     padding: 0;
     list-style: none;
@@ -56,7 +58,7 @@
     content: '';
     flex: none;
     inline-size: var(--carousel-bleed, 0px);
-    margin-inline-start: calc(-1 * var(--ds-space-12));
+    margin-inline-start: calc(-1 * var(--size-px-2-5));
   }
 
   .slide {
@@ -82,7 +84,7 @@
 
   .pager {
     display: flex;
-    gap: var(--ds-space-12);
+    gap: var(--size-px-2-5);
   }
 
   .printSummary {
@@ -92,6 +94,11 @@
   .photo {
     margin: 0;
   }
+
+  /* The photo at its own ratio, from the slide's --carousel-ratio, so the strip never crops it. */
+  .photo img {
+    aspect-ratio: var(--carousel-ratio);
+  }
 }
 
 @layer variants {
@@ -102,6 +109,9 @@
    * --carousel-bleed, which the component measures [D186].
    */
   .viewport {
+    /* A vertical wheel passes to the page: the track never holds vertical scroll chaining [D186]. */
+    --scroll-area-overscroll-y: auto;
+
     max-inline-size: none;
     margin-inline-end: calc(-1 * var(--carousel-bleed, 0px));
   }
@@ -115,7 +125,7 @@
    * post 3 + peek, photos the 480 px strip [D186].
    */
   .cards .list {
-    --carousel-slide: calc((88% - var(--ds-space-12)) / 2);
+    --carousel-slide: calc((88% - var(--size-px-2-5)) / 2);
   }
 
   .post .list {
@@ -140,7 +150,7 @@
 
   @container carousel (width >= 360px) {
     .cards .list {
-      --carousel-slide: calc((88cqi - var(--ds-space-12)) / 2);
+      --carousel-slide: calc((88cqi - var(--size-px-2-5)) / 2);
     }
 
     .post .list {
@@ -154,13 +164,13 @@
 
   @container carousel (width >= 768px) {
     .post .list {
-      --carousel-slide: calc((88cqi - var(--ds-space-12)) / 2);
+      --carousel-slide: calc((88cqi - var(--size-px-2-5)) / 2);
     }
   }
 
   @container carousel (width >= 1024px) {
     .post .list {
-      --carousel-slide: calc((88cqi - 2 * var(--ds-space-12)) / 3);
+      --carousel-slide: calc((88cqi - 2 * var(--size-px-2-5)) / 3);
     }
 
     /*
@@ -176,7 +186,7 @@
   /*
    * A slide's figure runs its photo and caption across its full width and
    * never takes the side caption, so the Figure's 12-track gutters go:
-   * eleven of them would floor a portrait slide at 11 × --ds-space-margin
+   * eleven of them would floor a portrait slide at 11 × --fgd-space-margin
    * and push its photo past the slide into the next.
    */
   .photo {

package/content/code-block/CodeActionsMenu.d.ts

@@ -0,0 +1,34 @@
+import * as React from 'react';
+import type { UseCodeResult } from '@fairgarden/docs/useCode';
+export type CodeActionsMenuProps = {
+    /** The inline row (one named file) instead of the menu (several files, or a nameless one). */
+    inline: boolean;
+    /** `useCode().selectedFileName`, for the action labels. */
+    fileName: string | undefined;
+    /** `useCode().copy`. */
+    onCopy?: UseCodeResult['copy'];
+    /** Copies the selected file's deep link (`useCopier`); omitted without a slug. */
+    onCopyLink?: (event: React.MouseEvent<Element>) => void;
+    /** `useCode().selectedFileUrl`. Hidden for `file://` URLs, as in the source. */
+    fileUrl?: string;
+    /** `useCode().copyMarkdown`, offered with several files only. */
+    onCopyMarkdown?: UseCodeResult['copyMarkdown'];
+    /** `useCode().reset`: defined only with a `CodeControllerContext`. */
+    onReset?: UseCodeResult['reset'];
+    /** The TS | JS switch; `anchor` is the inline switch or the ⋮ trigger, for scroll anchoring. */
+    jsTransform?: {
+        enabled: boolean;
+        onToggle: (enabled: boolean, anchor: HTMLElement | null) => void;
+    };
+    /** Two or more variants; `anchor` is the Select or the ⋮ trigger. */
+    variants?: {
+        items: readonly {
+            value: string;
+            label: string;
+        }[];
+        selected: string | undefined;
+        onChange: (value: string, anchor: HTMLElement | null) => void;
+    };
+};
+export declare function CodeActionsMenu(props: CodeActionsMenuProps): React.JSX.Element;
+//# sourceMappingURL=CodeActionsMenu.d.ts.map

package/content/code-block/CodeActionsMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeActionsMenu.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeActionsMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAgD7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,8FAA8F;IAC9F,MAAM,EAAE,OAAO,CAAA;IACf,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,wBAAwB;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,kFAAkF;IAClF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IACvD,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,cAAc,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC9C,sEAAsE;IACtE,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAChC,gGAAgG;IAChG,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;KAAE,CAAA;IACpG,qEAAqE;IACrE,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,SAAS;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;QAClD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;KAC9D,CAAA;CACF,CAAA;AAwCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAsL1D"}

package/content/code-block/CodeActionsMenu.js

@@ -0,0 +1,102 @@
+'use client';
+import * as React from 'react';
+import { Button } from '../../actions/button';
+import { Toggle } from '../../actions/toggle';
+import { ToggleGroup } from '../../actions/toggle-group';
+import { Select } from '../../forms/select';
+import { Menu, MenuCheckboxItem, MenuItem, MenuPopup, MenuRadioGroup, MenuRadioItem, MenuSeparator, } from '../../overlays/menu';
+import { MenuMorphTrigger } from '../../overlays/menu/morph';
+import { Tooltip, TooltipPopup, TooltipProvider, TooltipTrigger } from '../../overlays/tooltip';
+import { Icon } from '../../foundations/icon';
+import { FileTabsControl } from '../../navigation/file-tabs';
+import { actionLabels, openableUrl } from './CodeBlockFrame';
+import styles from './code-block.module.css';
+const TRANSFORM_LABELS = { off: 'TS', on: 'JS', menu: 'Transpile to JavaScript' };
+/** One icon-only action: a small quiet (`text`) Button named by its Tooltip; File Tabs draws its edge on hover and focus. */
+function IconAction({ icon, label, onClick, href, }) {
+    const button = href ? (React.createElement(Button, { variant: "text", iconOnly: true, size: "sm", icon: icon, nativeButton: false, render: React.createElement("a", { href: href, target: "_blank", rel: "noreferrer noopener" }) }, label)) : (React.createElement(Button, { variant: "text", iconOnly: true, size: "sm", icon: icon, onClick: onClick }, label));
+    return (React.createElement(Tooltip, null,
+        React.createElement(TooltipTrigger, { render: button }),
+        React.createElement(TooltipPopup, null, label)));
+}
+export function CodeActionsMenu(props) {
+    const { inline, fileName, onCopy, onCopyLink, fileUrl, onCopyMarkdown, onReset, jsTransform, variants, } = props;
+    // Scroll anchors: the inline switch's and Select's wrappers stay mounted
+    // across a swap; in the menu, the items unmount on close, so the trigger
+    // anchors instead.
+    const switchRef = React.useRef(null);
+    const selectRef = React.useRef(null);
+    const triggerRef = React.useRef(null);
+    // A `file://` URL means the build-time rewrite was skipped; it wouldn't open from the browser.
+    const sourceUrl = openableUrl(fileUrl);
+    const { copy: copyLabel, link: linkLabel, source: sourceLabel } = actionLabels(fileName);
+    const markdownLabel = 'Copy all files as Markdown';
+    const resetLabel = 'Reset edits';
+    if (inline) {
+        // End-aligned, and late controls first: Reset (a code controller's) and
+        // the TS | JS switch join after hydration (the loading state can't know
+        // them), so they enter at the row's start, taking room from the label,
+        // and the Select and Buttons painted from the first frame keep their
+        // places.
+        return (React.createElement(TooltipProvider, null,
+            onReset ? React.createElement(IconAction, { icon: "restart_alt", label: resetLabel, onClick: onReset }) : null,
+            jsTransform ? (React.createElement("span", { ref: switchRef, className: styles.transformSwitch },
+                React.createElement(ToggleGroup, { variant: "segmented", className: styles.transformGroup, "aria-label": TRANSFORM_LABELS.menu, value: [jsTransform.enabled ? 'on' : 'off'], onValueChange: (value) => {
+                        // Pressing the pressed cell would empty a single group; keep one side on.
+                        if (value.length === 0)
+                            return;
+                        const enabled = value[value.length - 1] === 'on';
+                        if (enabled !== jsTransform.enabled)
+                            jsTransform.onToggle(enabled, switchRef.current);
+                    } },
+                    React.createElement(Toggle, { value: "off", size: "sm", className: styles.transformToggle }, TRANSFORM_LABELS.off),
+                    React.createElement(Toggle, { value: "on", size: "sm", className: styles.transformToggle }, TRANSFORM_LABELS.on)))) : null,
+            variants ? (React.createElement("span", { ref: selectRef, className: styles.variantSelect },
+                React.createElement(Select, { "aria-label": "Variant", items: variants.items, value: variants.selected ?? null, onValueChange: (value) => {
+                        if (value != null)
+                            variants.onChange(value, selectRef.current);
+                    } }))) : null,
+            onCopy ? React.createElement(IconAction, { icon: "content_copy", label: copyLabel, onClick: onCopy }) : null,
+            onCopyLink ? React.createElement(IconAction, { icon: "link", label: linkLabel, onClick: onCopyLink }) : null,
+            sourceUrl ? React.createElement(IconAction, { icon: "open_in_new", label: sourceLabel, href: sourceUrl }) : null,
+            onCopyMarkdown ? (React.createElement(IconAction, { icon: "content_copy", label: markdownLabel, onClick: onCopyMarkdown })) : null));
+    }
+    // A nameless file whose one action is copy: that action hangs by itself,
+    // one click, in the ⋮'s slot and geometry (a FileTabsControl: the same
+    // ear, hit area, hover outline and corner wrap). If another action joins
+    // later (a TS | JS transform worked out in the browser), the ⋮ takes the
+    // slot instead: the same box, only the glyph changes. (Several files
+    // always offer copy Markdown too, so they never land here.)
+    const copyOnly = onCopy !== undefined &&
+        !onCopyLink &&
+        !sourceUrl &&
+        !onCopyMarkdown &&
+        !onReset &&
+        !jsTransform &&
+        !variants;
+    if (copyOnly) {
+        return (React.createElement(Tooltip, null,
+            React.createElement(TooltipTrigger, { render: React.createElement(FileTabsControl, { "aria-label": copyLabel, onClick: onCopy },
+                    React.createElement(Icon, { name: "content_copy", size: "inline", weight: "interactive" })) }),
+            React.createElement(TooltipPopup, null, copyLabel)));
+    }
+    const moreLabel = 'More actions';
+    return (React.createElement(Menu, null,
+        React.createElement(Tooltip, null,
+            React.createElement(TooltipTrigger, { render: React.createElement(MenuMorphTrigger, { ref: triggerRef, "aria-label": moreLabel, render: React.createElement(FileTabsControl, null) },
+                    React.createElement(Icon, { name: "more_vert", size: "tag", weight: "interactive" })) }),
+            React.createElement(TooltipPopup, null, moreLabel)),
+        React.createElement(MenuPopup, { align: "end" },
+            onCopy ? (React.createElement(MenuItem, { icon: "content_copy", onClick: onCopy }, copyLabel)) : null,
+            onCopyLink ? (React.createElement(MenuItem, { icon: "link", onClick: onCopyLink }, linkLabel)) : null,
+            sourceUrl ? (React.createElement(MenuItem, { icon: "open_in_new", closeOnClick: true, render: React.createElement("a", { href: sourceUrl, target: "_blank", rel: "noreferrer noopener" }) }, sourceLabel)) : null,
+            onCopyMarkdown ? (React.createElement(MenuItem, { icon: "content_copy", onClick: onCopyMarkdown }, markdownLabel)) : null,
+            jsTransform ? (React.createElement(React.Fragment, null,
+                React.createElement(MenuSeparator, null),
+                React.createElement(MenuCheckboxItem, { checked: jsTransform.enabled, closeOnClick: false, onCheckedChange: (enabled) => jsTransform.onToggle(enabled, triggerRef.current) }, TRANSFORM_LABELS.menu))) : null,
+            variants ? (React.createElement(React.Fragment, null,
+                React.createElement(MenuSeparator, null),
+                React.createElement(MenuRadioGroup, { value: variants.selected, onValueChange: (value) => variants.onChange(String(value), triggerRef.current) }, variants.items.map((item) => (React.createElement(MenuRadioItem, { key: item.value, value: item.value, closeOnClick: true }, item.label)))))) : null,
+            onReset ? (React.createElement(MenuItem, { icon: "restart_alt", onClick: onReset }, resetLabel)) : null)));
+}
+//# sourceMappingURL=CodeActionsMenu.js.map

package/content/code-block/CodeActionsMenu.js.map

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

package/content/code-block/CodeBlock.d.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+import type { ContentProps } from '@fairgarden/docs/CodeHighlighter/types';
+import type { PrimaryScale, RadixScale } from '../../utils/scales';
+export { codeBlock } from './CodeBlockFrame';
+/** Code Block's own content props: JSON, so a fence's `data-content-props` or a demo's props can carry them. */
+export type CodeBlockOptions = {
+    /**
+     * Collapses the code to its window (`@focus`, emphasis) with the "Show all {n} lines" toggle,
+     * where the code has one. A fence flag (` ```tsx collapse `) arrives as the string `'true'`,
+     * which counts. Not `collapsible`: the engine hands a ContentLoading its own `collapsible`
+     * (whether a file has a window), which would shadow it. Default `false`.
+     */
+    collapse?: boolean | 'true';
+};
+/** Props for CodeBlock: the content props CodeHighlighter hands its `Content`, plus the block's scales. */
+export type CodeBlockProps = ContentProps<CodeBlockOptions> & {
+    /** Primary scale: frame, labels, syntax inks, highlight fills, focus ring. Never defaulted [D133]. */
+    primary?: PrimaryScale;
+    /** Secondary scale: highlight accent bar (`--role-accent`), keywords (`--secondary12`), the selected file tab. Never defaulted. */
+    secondary?: RadixScale;
+    className?: string;
+};
+/**
+ * A code block: the file tabs (or the one file's name), the busy label and
+ * the actions in the header, the selected file's highlighted source, and,
+ * with `collapse`, the window's toggle under a long block. Tabs are links
+ * to each file's `#slug`; a modifier click opens the link instead of
+ * switching. Copy writes the selected file; "Copy link" its deep link. Each
+ * copy confirms with a toast (a danger toast if the clipboard refuses)
+ * through the design system's ToastProvider, where one is mounted above;
+ * without one, copying is silent. A nameless snippet has no header row.
+ * With several files, or none named, the "More actions" ⋮ hangs outside
+ * the frame's inline-end edge: leave `--fgd-size-file-tabs-control`
+ * (24 px) free past the block, unclipped.
+ */
+export declare function CodeBlock(props: CodeBlockProps): React.JSX.Element;
+//# sourceMappingURL=CodeBlock.d.ts.map

package/content/code-block/CodeBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeBlock.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAI1E,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAKlE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AA+C5C,gHAAgH;AAChH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B,CAAA;AAED,2GAA2G;AAC3G,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,gBAAgB,CAAC,GAAG;IAC5D,sGAAsG;IACtG,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,mIAAmI;IACnI,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAkB9C"}

package/content/code-block/CodeBlock.js

@@ -0,0 +1,30 @@
+'use client';
+import * as React from 'react';
+import { useCode } from '@fairgarden/docs/useCode';
+import { useCodeWindow } from '@fairgarden/docs/useCodeWindow';
+import { isOn } from './CodeBlockFrame';
+import { CodeBlockSection, useCodeBlockOptions } from './CodeBlockSection';
+import { useCopyToasts } from './CodeBlockToasts';
+export { codeBlock } from './CodeBlockFrame';
+/**
+ * A code block: the file tabs (or the one file's name), the busy label and
+ * the actions in the header, the selected file's highlighted source, and,
+ * with `collapse`, the window's toggle under a long block. Tabs are links
+ * to each file's `#slug`; a modifier click opens the link instead of
+ * switching. Copy writes the selected file; "Copy link" its deep link. Each
+ * copy confirms with a toast (a danger toast if the clipboard refuses)
+ * through the design system's ToastProvider, where one is mounted above;
+ * without one, copying is silent. A nameless snippet has no header row.
+ * With several files, or none named, the "More actions" ⋮ hangs outside
+ * the frame's inline-end edge: leave `--fgd-size-file-tabs-control`
+ * (24 px) free past the block, unclipped.
+ */
+export function CodeBlock(props) {
+    const { primary, secondary, className, ...contentProps } = props;
+    const collapsible = isOn(contentProps.collapse);
+    const codeWindow = useCodeWindow();
+    const toasts = useCopyToasts();
+    const code = useCode(contentProps, useCodeBlockOptions(collapsible, codeWindow, toasts));
+    return (React.createElement(CodeBlockSection, { code: code, codeWindow: codeWindow, collapsible: collapsible, toasts: toasts, primary: primary, secondary: secondary, className: className }));
+}
+//# sourceMappingURL=CodeBlock.js.map

package/content/code-block/CodeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.js","sourceRoot":"","sources":["../../src/content/code-block/CodeBlock.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAG9D,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAmE5C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,CAAA;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG,aAAa,EAAoB,CAAA;IACpD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IAExF,OAAO,CACL,oBAAC,gBAAgB,IACf,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,GACpB,CACH,CAAA;AACH,CAAC"}

package/content/code-block/CodeBlockFrame.d.ts

@@ -0,0 +1,54 @@
+import * as React from 'react';
+/** Code Block's CVA function. `embedded` is the Demo's code section. */
+export declare const codeBlock: (props?: ({
+    embedded?: boolean | null | undefined;
+    primary?: "ruby" | "brown" | "crimson" | "gold" | "gray" | "indigo" | "olive" | "pink" | "plum" | "purple" | "red" | "tomato" | "violet" | "bronze" | "iris" | "mauve" | "sage" | "sand" | "slate" | null | undefined;
+    secondary?: "ruby" | "blue" | "brown" | "crimson" | "cyan" | "gold" | "gray" | "green" | "indigo" | "lime" | "olive" | "orange" | "pink" | "plum" | "purple" | "red" | "teal" | "tomato" | "violet" | "yellow" | "amber" | "bronze" | "grass" | "iris" | "jade" | "mauve" | "mint" | "sage" | "sand" | "sky" | "slate" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** A variant Select's items from variant keys (`useCode().variants`, or a fallback's). */
+export declare function variantItems(variants: readonly string[]): {
+    value: string;
+    label: string;
+}[];
+/**
+ * The one-file actions' names, shared by the loaded row (CodeActionsMenu)
+ * and the loading state's stand-ins, so both read the same. A nameless
+ * file's copy is "Copy code" (its toast says "Code copied").
+ */
+export declare function actionLabels(fileName: string | undefined): {
+    copy: string;
+    link: string;
+    source: string;
+};
+/**
+ * A source URL the browser can open, for "View source": not a `file://`
+ * URL, which means the build-time rewrite was skipped.
+ */
+export declare function openableUrl(url: string | undefined): string | undefined;
+/**
+ * A content prop that arrives from JSON: `true`, or a fence's flag (the
+ * pipeline passes a bare ` ```tsx collapse ` as the string `'true'`).
+ */
+export declare function isOn(value: unknown): value is true | "true" | "";
+export type CodeBlockToggleProps = {
+    /** The hidden checkbox's id (the label's `htmlFor`). */
+    id: string;
+    /** The file's line count, for "Show all {n} lines". */
+    lines: number | undefined;
+    /** Controlled by useCode's `expanded` once loaded. */
+    checked?: boolean;
+    /** Uncontrolled in the loading state: `initialExpanded`. */
+    defaultChecked?: boolean;
+    /** A fallback that carries only the window has nothing to expand into yet. */
+    disabled?: boolean;
+    onChange?: (expanded: boolean) => void;
+    /** `useCodeWindow().toggleRef`. */
+    toggleRef?: React.Ref<HTMLLabelElement>;
+};
+/**
+ * The window's control: a visually hidden checkbox (the state, which works
+ * before hydration) and its label, a full-width row with the disclosure
+ * glyph [D109].
+ */
+export declare function CodeBlockToggle(props: CodeBlockToggleProps): React.JSX.Element;
+//# sourceMappingURL=CodeBlockFrame.d.ts.map

package/content/code-block/CodeBlockFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockFrame.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockFrame.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,wEAAwE;AACxE,eAAO,MAAM,SAAS;;;;8EAYpB,CAAA;AAKF,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE;;;IAEvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;;;;EAMxD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,sBAElD;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,+BAElC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,uDAAuD;IACvD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,mCAAmC;IACnC,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;CACxC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAmC1D"}

package/content/code-block/CodeBlockFrame.js

@@ -0,0 +1,80 @@
+'use client';
+import * as React from 'react';
+import { cva } from 'class-variance-authority';
+import { DisclosureGlyph } from '../../disclosure/collapsible';
+import { cx } from '../../utils/className';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import styles from './code-block.module.css';
+/*
+ * Internal to Code Block and Demo: the frame parts the loaded block and its
+ * loading state share: the CVA function and the window's toggle (the
+ * header, with its hanging actions, is File Tabs'). No docs engine runtime
+ * here, so the loading path (CodeBlockLoading, DemoLoading) stays light.
+ * Not exported from the index; `codeBlock` is re-exported by CodeBlock.
+ */
+/** Code Block's CVA function. `embedded` is the Demo's code section. */
+export const codeBlock = cva(styles.base, {
+    variants: {
+        embedded: {
+            true: styles.embedded,
+        },
+        // Color axes: never defaulted, so an omitted prop inherits the scope [D133].
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+    defaultVariants: {
+        embedded: false,
+    },
+});
+/** Display names for variant keys, as in the source. */
+const VARIANT_LABELS = { CssModules: 'CSS Modules' };
+/** A variant Select's items from variant keys (`useCode().variants`, or a fallback's). */
+export function variantItems(variants) {
+    return variants.map((value) => ({ value, label: VARIANT_LABELS[value] ?? value }));
+}
+/**
+ * The one-file actions' names, shared by the loaded row (CodeActionsMenu)
+ * and the loading state's stand-ins, so both read the same. A nameless
+ * file's copy is "Copy code" (its toast says "Code copied").
+ */
+export function actionLabels(fileName) {
+    return {
+        copy: fileName ? `Copy ${fileName} source` : 'Copy code',
+        link: fileName ? `Copy ${fileName} link` : 'Copy link',
+        source: fileName ? `View ${fileName} source` : 'View source',
+    };
+}
+/**
+ * A source URL the browser can open, for "View source": not a `file://`
+ * URL, which means the build-time rewrite was skipped.
+ */
+export function openableUrl(url) {
+    return url && !url.startsWith('file://') ? url : undefined;
+}
+/**
+ * A content prop that arrives from JSON: `true`, or a fence's flag (the
+ * pipeline passes a bare ` ```tsx collapse ` as the string `'true'`).
+ */
+export function isOn(value) {
+    return value === true || value === 'true' || value === '';
+}
+/**
+ * The window's control: a visually hidden checkbox (the state, which works
+ * before hydration) and its label, a full-width row with the disclosure
+ * glyph [D109].
+ */
+export function CodeBlockToggle(props) {
+    const { id, lines, checked, defaultChecked, disabled, onChange, toggleRef } = props;
+    // As the source: a pointer press never leaves the hidden checkbox focused.
+    const blurPointerFocus = (event) => {
+        if (!event.currentTarget.matches(':focus-visible'))
+            event.currentTarget.blur();
+    };
+    return (React.createElement(React.Fragment, null,
+        React.createElement("input", { type: "checkbox", id: id, className: styles.checkbox, checked: checked, defaultChecked: defaultChecked, disabled: disabled, onFocus: blurPointerFocus, onChange: onChange ? (event) => onChange(event.target.checked) : undefined }),
+        React.createElement("label", { ref: toggleRef, htmlFor: id, className: styles.toggle, "data-panel-open": (checked ?? defaultChecked) ? '' : undefined },
+            React.createElement(DisclosureGlyph, { size: "chrome" }),
+            React.createElement("span", { className: cx(styles.toggleLabel, styles.showAll) }, lines != null ? `Show all ${lines} lines` : 'Show all lines'),
+            React.createElement("span", { className: cx(styles.toggleLabel, styles.showFewer) }, "Show fewer lines"))));
+}
+//# sourceMappingURL=CodeBlockFrame.js.map

package/content/code-block/CodeBlockFrame.js.map

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

package/content/code-block/CodeBlockHeader.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { UseCodeResult } from '@fairgarden/docs/useCode';
+import { type FileTab } from '../../navigation/file-tabs';
+import type { PrimaryScale, RadixScale } from '../../utils/scales';
+export type CodeBlockHeaderProps = {
+    /** The files as tabs (one: its label; none, a nameless file: no header row). */
+    tabs: readonly FileTab[];
+    /** The selected file's name. */
+    value: string | undefined;
+    /** `useCode().selectFileName`; omitted while loading. */
+    onValueChange?: (id: string) => void;
+    /** The loading state's tabs. */
+    disabled?: boolean;
+    /** The Demo's code section: the header joins the preview with a rule. */
+    embedded: boolean;
+    /** The actions (`CodeActionsMenu`, or the loading state's disabled stand-ins). */
+    actions: React.ReactNode;
+    /** `useCode().pendingTransform`: `undefined` is idle; `null` is a swap back to the original (TS). */
+    pending: UseCodeResult['pendingTransform'];
+    primary?: PrimaryScale;
+    secondary?: RadixScale;
+    /** The panel's content: the selected file's source. */
+    children: React.ReactNode;
+};
+export declare function CodeBlockHeader(props: CodeBlockHeaderProps): React.JSX.Element;
+//# sourceMappingURL=CodeBlockHeader.d.ts.map

package/content/code-block/CodeBlockHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockHeader.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAAyC,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAmBlE,MAAM,MAAM,oBAAoB,GAAG;IACjC,gFAAgF;IAChF,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,yDAAyD;IACzD,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;IACjB,kFAAkF;IAClF,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,qGAAqG;IACrG,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAC1C,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,uDAAuD;IACvD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAQD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAgC1D"}

package/content/code-block/CodeBlockHeader.js

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import { FileTabs, FileTabsList, FileTabsPanel } from '../../navigation/file-tabs';
+/** The busy label's target: TS for the original, JS for the `js` transform, else its name. */
+function pendingLabel(pending) {
+    if (pending === null)
+        return 'TS';
+    return pending === 'js' ? 'JS' : pending;
+}
+export function CodeBlockHeader(props) {
+    const { tabs, value, onValueChange, disabled, embedded, actions, pending, primary, secondary, children, } = props;
+    const status = pending !== undefined ? `Switching to ${pendingLabel(pending)}…` : '';
+    return (React.createElement(FileTabs, { tabs: tabs, value: value, onValueChange: onValueChange, disabled: disabled, frame: embedded ? 'joined' : 'top', mono: true, controls: actions, status: status, primary: primary, secondary: secondary },
+        React.createElement(FileTabsList, { "aria-label": "Files" }),
+        React.createElement(FileTabsPanel, null, children)));
+}
+//# sourceMappingURL=CodeBlockHeader.js.map

package/content/code-block/CodeBlockHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockHeader.js","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAgB,MAAM,4BAA4B,CAAA;AAyChG,8FAA8F;AAC9F,SAAS,YAAY,CAAC,OAAsB;IAC1C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACjC,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,GACT,GAAG,KAAK,CAAA;IACT,MAAM,MAAM,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAEpF,OAAO,CACL,oBAAC,QAAQ,IACP,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAClC,IAAI,QACJ,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS;QAEpB,oBAAC,YAAY,kBAAY,OAAO,GAAG;QACnC,oBAAC,aAAa,QAAE,QAAQ,CAAiB,CAChC,CACZ,CAAA;AACH,CAAC"}

package/content/code-block/CodeBlockLazy.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import type { CodeBlockProps } from './CodeBlock';
+/**
+ * Code Block, code-split: CodeHighlighter's `Content` that loads CodeBlock
+ * (`useCode`, the tabs, the menus) in its own chunk, as fg-docs'
+ * CodeContentLazy. Pair it with `ContentLoading={CodeBlockLoading}`, which
+ * shows while the chunk loads. The import lives in this client module
+ * because a function can't cross from a server component as a prop.
+ */
+export declare function CodeBlockLazy(props: CodeBlockProps): React.JSX.Element;
+//# sourceMappingURL=CodeBlockLazy.d.ts.map

package/content/code-block/CodeBlockLazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockLazy.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockLazy.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,qBAOlD"}

package/content/code-block/CodeBlockLazy.js

@@ -0,0 +1,14 @@
+'use client';
+import * as React from 'react';
+import { LazyContent } from '@fairgarden/docs/CoordinatedLazy';
+/**
+ * Code Block, code-split: CodeHighlighter's `Content` that loads CodeBlock
+ * (`useCode`, the tabs, the menus) in its own chunk, as fg-docs'
+ * CodeContentLazy. Pair it with `ContentLoading={CodeBlockLoading}`, which
+ * shows while the chunk loads. The import lives in this client module
+ * because a function can't cross from a server component as a prop.
+ */
+export function CodeBlockLazy(props) {
+    return (React.createElement(LazyContent, { content: () => import('./CodeBlock').then((mod) => ({ default: mod.CodeBlock })), props: props }));
+}
+//# sourceMappingURL=CodeBlockLazy.js.map

package/content/code-block/CodeBlockLazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockLazy.js","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockLazy.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAI9D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAqB;IACjD,OAAO,CACL,oBAAC,WAAW,IACV,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAChF,KAAK,EAAE,KAAK,GACZ,CACH,CAAA;AACH,CAAC"}

package/content/code-block/CodeBlockLoading.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { ContentLoadingProps } from '@fairgarden/docs/CodeHighlighter/types';
+import type { PrimaryScale, RadixScale } from '../../utils/scales';
+import type { CodeBlockOptions } from './CodeBlock';
+/** Props for CodeBlockLoading: what CodeHighlighter hands its `ContentLoading`, plus the block's scales. */
+export type CodeBlockLoadingProps = ContentLoadingProps<CodeBlockOptions> & {
+    primary?: PrimaryScale;
+    secondary?: RadixScale;
+    className?: string;
+};
+export type CodeBlockSectionLoadingProps = {
+    /** The ContentLoading props (the fallback). */
+    fallback: ContentLoadingProps<object>;
+    collapsible: boolean;
+    /** The Demo's code section (the Demo renders the scroll targets). */
+    embedded?: boolean;
+    primary?: PrimaryScale;
+    secondary?: RadixScale;
+    className?: string;
+};
+/** Every scroll target the fallback knows: the initial variant's files, and other variants' when it carries them. */
+export declare function fallbackSlugs(fallback: ContentLoadingProps<object>, fileNames: readonly string[]): string[];
+/** Internal to Code Block and Demo: the code section from the fallback. Not exported from the index. */
+export declare function CodeBlockSectionLoading(props: CodeBlockSectionLoadingProps): React.JSX.Element;
+/**
+ * The loading state of a code block: the precomputed fallback in the
+ * loaded block's frame, with its tabs and actions disabled until the
+ * content loads. Pass it as CodeHighlighter's `ContentLoading`.
+ */
+export declare function CodeBlockLoading(props: CodeBlockLoadingProps): React.JSX.Element;
+//# sourceMappingURL=CodeBlockLoading.d.ts.map

package/content/code-block/CodeBlockLoading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlockLoading.d.ts","sourceRoot":"","sources":["../../src/content/code-block/CodeBlockLoading.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAA;AAQjF,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAyBnD,4GAA4G;AAC5G,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;IAC1E,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACrC,WAAW,EAAE,OAAO,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,YAYhG;AAED,wGAAwG;AACxG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,qBA8G1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,qBAW5D"}