@lostgradient/cinder 0.1.0 → 0.2.0

package/components.json

@@ -3,7 +3,7 @@
   "manifestVersion": 1,
   "package": {
     "name": "@lostgradient/cinder",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "framework": "svelte",
     "frameworkVersionRange": ">=5.55.0 <6",
     "classPrefix": "cinder-",
@@ -500,6 +500,32 @@
         "variables": "@lostgradient/cinder/callout/variables"
       }
     },
+    {
+      "name": "CapabilityGate",
+      "id": "capability-gate",
+      "import": "@lostgradient/cinder/capability-gate",
+      "exportName": "CapabilityGate",
+      "category": "feedback",
+      "status": "alpha",
+      "purpose": "Present feature availability and next action for browser permission or support states, with accessible status text and focus management.",
+      "tags": ["feedback", "permission", "notice"],
+      "useWhen": [
+        "Surfacing that a feature requires a browser permission such as microphone or notifications.",
+        "Communicating that a feature is unsupported in the current browser with a clear fallback path."
+      ],
+      "avoidWhen": [
+        "Performing the actual feature detection or permission request — wire that in userland.",
+        "Storing permission state — CapabilityGate is a pure presentation component."
+      ],
+      "related": ["alert", "banner", "callout", "modal"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/capability-gate/schema",
+        "variables": "@lostgradient/cinder/capability-gate/variables",
+        "examples": "@lostgradient/cinder/capability-gate/examples"
+      }
+    },
     {
       "name": "Card",
       "id": "card",
@@ -626,6 +652,51 @@
         "examples": "@lostgradient/cinder/chip/examples"
       }
     },
+    {
+      "name": "ChoiceGrid",
+      "id": "choice-grid",
+      "import": "@lostgradient/cinder/choice-grid",
+      "exportName": "ChoiceGrid",
+      "category": "form",
+      "status": "alpha",
+      "purpose": "Responsive grid of large selectable choices with roving keyboard focus, selection state, and optional correct/incorrect/pending feedback for quiz and assessment surfaces.",
+      "tags": ["form", "selection", "quiz", "assessment"],
+      "useWhen": [
+        "Presenting a small fixed set of large selectable answers where all options should stay visible (quiz or assessment surfaces).",
+        "Building a touch-friendly selector grid with stable cell dimensions that must not shift when feedback states are applied."
+      ],
+      "avoidWhen": [
+        "Selecting from a long dynamic list — use combobox or select instead.",
+        "Choosing one of two to five short values in a compact inline context — use segmented-control instead."
+      ],
+      "related": ["choice-grid-item", "segmented-control", "radio-group", "checkbox-group"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/choice-grid/schema",
+        "variables": "@lostgradient/cinder/choice-grid/variables",
+        "examples": "@lostgradient/cinder/choice-grid/examples"
+      }
+    },
+    {
+      "name": "ChoiceGridItem",
+      "id": "choice-grid-item",
+      "import": "@lostgradient/cinder/choice-grid-item",
+      "exportName": "ChoiceGridItem",
+      "category": "form",
+      "status": "alpha",
+      "purpose": "Selectable answer tile used inside a ChoiceGrid; carries selected, disabled, correct, incorrect, and pending states without shifting cell dimensions.",
+      "tags": ["form", "selection", "quiz"],
+      "useWhen": ["Composing individual answer choices inside a ChoiceGrid parent."],
+      "avoidWhen": ["Used outside a ChoiceGrid — this leaf requires the parent context."],
+      "related": ["choice-grid"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/choice-grid-item/schema",
+        "variables": "@lostgradient/cinder/choice-grid-item/variables"
+      }
+    },
     {
       "name": "ClickAwayListener",
       "id": "click-away-listener",
@@ -1056,6 +1127,39 @@
         "examples": "@lostgradient/cinder/data-list/examples"
       }
     },
+    {
+      "name": "DataTable",
+      "id": "data-table",
+      "import": "@lostgradient/cinder/data-table",
+      "exportName": "DataTable",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Data-driven convenience wrapper over the compositional Table family that renders a full semantic table from a columns array and a rows array.",
+      "tags": ["table", "data"],
+      "useWhen": [
+        "Rendering a structured dataset where columns and rows are known at runtime (e.g. API responses, config-driven dashboards).",
+        "You want correct scope=col / scope=row semantics and aria-sort wiring without writing Table.Header / Table.Body manually."
+      ],
+      "avoidWhen": [
+        "You need custom cell rendering, interactive cells, nested components, or column spanning — use the compositional Table family directly.",
+        "You need row selection — DataTable does not expose a selection prop; use Table with selectable instead."
+      ],
+      "related": [
+        "table",
+        "table-header",
+        "table-body",
+        "table-row",
+        "table-cell",
+        "table-header-cell"
+      ],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/data-table/schema",
+        "variables": "@lostgradient/cinder/data-table/variables",
+        "examples": "@lostgradient/cinder/data-table/examples"
+      }
+    },
     {
       "name": "DescriptionList",
       "id": "description-list",
@@ -1790,6 +1894,29 @@
         "examples": "@lostgradient/cinder/kbd/examples"
       }
     },
+    {
+      "name": "KeyboardShortcuts",
+      "id": "keyboard-shortcuts",
+      "import": "@lostgradient/cinder/keyboard-shortcuts",
+      "exportName": "KeyboardShortcuts",
+      "category": "typography",
+      "status": "alpha",
+      "purpose": "Grouped keyboard-shortcut reference that renders key combos via Kbd with accessible labels not reliant only on visual keycaps.",
+      "tags": ["shortcut", "keyboard"],
+      "useWhen": [
+        "Displaying a reference panel of keyboard shortcuts grouped by feature area.",
+        "Embedding a shortcut table inside a modal, sheet, popover, or help page."
+      ],
+      "avoidWhen": ["Showing a single inline shortcut hint — use shortcut-hint instead."],
+      "related": ["kbd", "shortcut-hint", "modal", "sheet", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/keyboard-shortcuts/schema",
+        "variables": "@lostgradient/cinder/keyboard-shortcuts/variables",
+        "examples": "@lostgradient/cinder/keyboard-shortcuts/examples"
+      }
+    },
     {
       "name": "Label",
       "id": "label",
@@ -1910,6 +2037,58 @@
         "examples": "@lostgradient/cinder/markdown-editor/examples"
       }
     },
+    {
+      "name": "MatrixChart",
+      "id": "matrix-chart",
+      "import": "@lostgradient/cinder/matrix-chart",
+      "exportName": "MatrixChart",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Categorical × categorical heatmap for dense analytics, confusion matrices, and correlation grids.",
+      "tags": ["chart", "heatmap", "matrix", "analytics"],
+      "useWhen": [
+        "Showing density or magnitude across two categorical dimensions simultaneously.",
+        "Rendering a confusion matrix where rows are actual classes and columns are predicted classes."
+      ],
+      "avoidWhen": [
+        "Showing a continuous trend over time — use line-chart instead.",
+        "Comparing discrete category totals — use bar-chart instead."
+      ],
+      "related": ["bar-chart", "line-chart", "area-chart"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/matrix-chart/schema",
+        "variables": "@lostgradient/cinder/matrix-chart/variables",
+        "examples": "@lostgradient/cinder/matrix-chart/examples"
+      }
+    },
+    {
+      "name": "MediaControls",
+      "id": "media-controls",
+      "import": "@lostgradient/cinder/media-controls",
+      "exportName": "MediaControls",
+      "category": "action",
+      "status": "alpha",
+      "purpose": "Accessible playback controls for play, pause, and replay actions with optional progress display.",
+      "tags": ["action", "media"],
+      "useWhen": [
+        "Embedding play/pause/replay controls for audio or video content.",
+        "Rendering media controls inside a toolbar or standalone on a card."
+      ],
+      "avoidWhen": [
+        "You need waveform visualization or Web Audio integration — wire that separately.",
+        "You need a full media player UI with seek scrubbing — use a dedicated player component."
+      ],
+      "related": ["button", "toolbar", "progress", "tooltip"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/media-controls/schema",
+        "variables": "@lostgradient/cinder/media-controls/variables",
+        "examples": "@lostgradient/cinder/media-controls/examples"
+      }
+    },
     {
       "name": "MenuBar",
       "id": "menu-bar",
@@ -2196,6 +2375,32 @@
         "examples": "@lostgradient/cinder/portal/examples"
       }
     },
+    {
+      "name": "PricingCard",
+      "id": "pricing-card",
+      "import": "@lostgradient/cinder/pricing-card",
+      "exportName": "PricingCard",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Presents a single pricing plan with its name, price, feature list, and a call-to-action button.",
+      "tags": ["pricing", "plan"],
+      "useWhen": [
+        "Letting users compare and select subscription tiers or product plans.",
+        "Highlighting one tier as selected or recommended in a pricing comparison."
+      ],
+      "avoidWhen": [
+        "Showing generic grouped content without a distinct price or CTA — use card instead.",
+        "Displaying a single key metric in isolation — use stat or stat-group instead."
+      ],
+      "related": ["card", "button", "stat", "stat-group"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/pricing-card/schema",
+        "variables": "@lostgradient/cinder/pricing-card/variables",
+        "examples": "@lostgradient/cinder/pricing-card/examples"
+      }
+    },
     {
       "name": "Progress",
       "id": "progress",
@@ -2365,10 +2570,11 @@
       "avoidWhen": ["Selecting from a constrained list of known options — use combobox instead."],
       "related": ["input", "combobox"],
       "hasConstraints": false,
-      "hasExamples": false,
+      "hasExamples": true,
       "artifacts": {
         "schema": "@lostgradient/cinder/search-field/schema",
-        "variables": "@lostgradient/cinder/search-field/variables"
+        "variables": "@lostgradient/cinder/search-field/variables",
+        "examples": "@lostgradient/cinder/search-field/examples"
       }
     },
     {
@@ -2500,6 +2706,32 @@
         "examples": "@lostgradient/cinder/selection-popover/examples"
       }
     },
+    {
+      "name": "ShareCard",
+      "id": "share-card",
+      "import": "@lostgradient/cinder/share-card",
+      "exportName": "ShareCard",
+      "category": "action",
+      "status": "alpha",
+      "purpose": "Compact share card with copy-link, copy-text, and native navigator.share actions, with accessible success announcements and graceful fallback when navigator.share is unavailable.",
+      "tags": ["action", "clipboard"],
+      "useWhen": [
+        "Offering a quick way to share a link or text with copy and native share options.",
+        "Presenting a result, invite link, or exported report link with sharing affordances."
+      ],
+      "avoidWhen": [
+        "Generating the share text or images — compose ShareCard with your own copy generation logic.",
+        "Posting directly to social media or analytics — wire those externally."
+      ],
+      "related": ["copy-button", "card", "button"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/share-card/schema",
+        "variables": "@lostgradient/cinder/share-card/variables",
+        "examples": "@lostgradient/cinder/share-card/examples"
+      }
+    },
     {
       "name": "Sheet",
       "id": "sheet",
@@ -2526,6 +2758,29 @@
         "examples": "@lostgradient/cinder/sheet/examples"
       }
     },
+    {
+      "name": "ShortcutHint",
+      "id": "shortcut-hint",
+      "import": "@lostgradient/cinder/shortcut-hint",
+      "exportName": "ShortcutHint",
+      "category": "typography",
+      "status": "alpha",
+      "purpose": "Inline shortcut hint that renders a key combo via Kbd alongside an action label, with an accessible text representation not reliant on visual keycaps alone.",
+      "tags": ["shortcut", "inline"],
+      "useWhen": [
+        "Showing a keyboard shortcut inline beside a label in a toolbar button, menu item, or tooltip.",
+        "Pairing with command-palette items to surface available shortcuts."
+      ],
+      "avoidWhen": ["Displaying a full shortcut reference table — use keyboard-shortcuts instead."],
+      "related": ["kbd", "keyboard-shortcuts", "tooltip"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/shortcut-hint/schema",
+        "variables": "@lostgradient/cinder/shortcut-hint/variables",
+        "examples": "@lostgradient/cinder/shortcut-hint/examples"
+      }
+    },
     {
       "name": "SideNavigation",
       "id": "side-navigation",
@@ -2654,6 +2909,32 @@
         "examples": "@lostgradient/cinder/skeleton/examples"
       }
     },
+    {
+      "name": "SkipLink",
+      "id": "skip-link",
+      "import": "@lostgradient/cinder/skip-link",
+      "exportName": "SkipLink",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Visually hidden skip link that moves keyboard focus to a landmark element, letting keyboard and screen reader users bypass repeated navigation.",
+      "tags": ["navigation", "accessibility", "skip-link"],
+      "useWhen": [
+        "Providing a keyboard shortcut to jump past site-wide navigation directly to the main content area.",
+        "Meeting WCAG 2.4.1 (Bypass Blocks) without adding visible chrome to the layout."
+      ],
+      "avoidWhen": [
+        "The page has no repeated navigation block — a skip link adds no value on single-panel layouts.",
+        "The target region already receives focus naturally without intervention."
+      ],
+      "related": ["visually-hidden"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/skip-link/schema",
+        "variables": "@lostgradient/cinder/skip-link/variables",
+        "examples": "@lostgradient/cinder/skip-link/examples"
+      }
+    },
     {
       "name": "Slider",
       "id": "slider",
@@ -2705,6 +2986,60 @@
         "variables": "@lostgradient/cinder/sortable-list/variables"
       }
     },
+    {
+      "name": "Spectrogram",
+      "id": "spectrogram",
+      "import": "@lostgradient/cinder/spectrogram",
+      "exportName": "Spectrogram",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Responsive SVG time × frequency heatmap for visualizing audio spectrogram data.",
+      "tags": ["chart", "spectrogram", "signal", "audio"],
+      "useWhen": [
+        "Visualizing how frequency content of a signal changes over time (time × frequency heatmap).",
+        "Displaying pre-computed spectrogram frames from an FFT or short-time Fourier transform."
+      ],
+      "avoidWhen": [
+        "Only a single spectrum snapshot is needed — use spectrum-chart instead.",
+        "Real-time live audio spectrogram is needed — feed frames as props yourself.",
+        "A categorical × categorical heatmap without a time axis is needed — use matrix-chart instead."
+      ],
+      "related": ["spectrum-chart", "waveform", "matrix-chart"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/spectrogram/schema",
+        "variables": "@lostgradient/cinder/spectrogram/variables",
+        "examples": "@lostgradient/cinder/spectrogram/examples"
+      }
+    },
+    {
+      "name": "SpectrumChart",
+      "id": "spectrum-chart",
+      "import": "@lostgradient/cinder/spectrum-chart",
+      "exportName": "SpectrumChart",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Responsive SVG frequency-bin bar chart for visualizing audio spectrum magnitude data.",
+      "tags": ["chart", "spectrum", "signal", "audio"],
+      "useWhen": [
+        "Displaying pre-computed frequency-domain magnitude data from an FFT or spectrum analyzer.",
+        "Showing a static frequency response or spectrum snapshot with labelled frequency bins."
+      ],
+      "avoidWhen": [
+        "Real-time live audio spectrum is needed — feed live AnalyserNode data as props yourself.",
+        "A full time × frequency heatmap is needed — use spectrogram instead.",
+        "General categorical bar comparison — use bar-chart instead."
+      ],
+      "related": ["waveform", "spectrogram", "bar-chart"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/spectrum-chart/schema",
+        "variables": "@lostgradient/cinder/spectrum-chart/variables",
+        "examples": "@lostgradient/cinder/spectrum-chart/examples"
+      }
+    },
     {
       "name": "Spinner",
       "id": "spinner",
@@ -2859,6 +3194,32 @@
         "examples": "@lostgradient/cinder/steps/examples"
       }
     },
+    {
+      "name": "SubscriptionBadge",
+      "id": "subscription-badge",
+      "import": "@lostgradient/cinder/subscription-badge",
+      "exportName": "SubscriptionBadge",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Opinionated Badge variant that communicates billing subscription states with a standardized tone, icon, and human-readable label.",
+      "tags": ["billing", "subscription", "status"],
+      "useWhen": [
+        "Displaying the billing state of a subscription in a dashboard, invoice list, or account settings page.",
+        "Annotating a plan name, customer row, or invoice line with its current payment lifecycle state."
+      ],
+      "avoidWhen": [
+        "The subscription state is not one of the six recognized values — use Badge directly with a custom label instead.",
+        "You need an interactive control that lets users change the state — use a Button or Select."
+      ],
+      "related": ["badge", "status-dot", "chip"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/subscription-badge/schema",
+        "variables": "@lostgradient/cinder/subscription-badge/variables",
+        "examples": "@lostgradient/cinder/subscription-badge/examples"
+      }
+    },
     {
       "name": "Surface",
       "id": "surface",
@@ -3412,6 +3773,32 @@
         "variables": "@lostgradient/cinder/visually-hidden/variables",
         "examples": "@lostgradient/cinder/visually-hidden/examples"
       }
+    },
+    {
+      "name": "Waveform",
+      "id": "waveform",
+      "import": "@lostgradient/cinder/waveform",
+      "exportName": "Waveform",
+      "category": "data-display",
+      "status": "alpha",
+      "purpose": "Responsive SVG rendering of time-domain audio amplitude data as a waveform path or bar display.",
+      "tags": ["chart", "waveform", "signal", "audio"],
+      "useWhen": [
+        "Visualizing pre-recorded or pre-processed audio amplitude samples in a static display.",
+        "Showing an audio waveform thumbnail or preview with mocked or pre-computed sample data."
+      ],
+      "avoidWhen": [
+        "Real-time live audio capture is needed — wire AudioContext / AnalyserNode yourself and feed samples as props.",
+        "Frequency-domain data — use spectrum-chart or spectrogram instead."
+      ],
+      "related": ["spectrum-chart", "spectrogram", "bar-chart", "line-chart"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/waveform/schema",
+        "variables": "@lostgradient/cinder/waveform/variables",
+        "examples": "@lostgradient/cinder/waveform/examples"
+      }
     }
   ]
 }

package/dist/_internal/chart/chart-focus-ring.d.ts

@@ -0,0 +1,57 @@
+import type { ChartTarget } from './chart-utilities.ts';
+export declare const DEFAULT_CHART_FOCUS_RING_STROKE_PADDING = 8;
+export type ChartFocusRingConnectorGeometry = {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+};
+export type ChartFocusRingDotGeometry = {
+    cx: number;
+    cy: number;
+    radius: number;
+};
+export type ChartPointFocusRingGeometry = {
+    kind: 'point';
+    cx: number;
+    cy: number;
+    radius: number;
+    targetX: number;
+    targetY: number;
+    offsetX: number;
+    offsetY: number;
+    offsetDistance: number;
+    connector?: ChartFocusRingConnectorGeometry;
+    dot?: ChartFocusRingDotGeometry;
+} | ChartPlotFrameFocusRingGeometry;
+export type ChartBarFocusRingGeometry = {
+    kind: 'bar';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    radius: number;
+} | ChartPlotFrameFocusRingGeometry;
+export type ChartPlotFrameFocusRingGeometry = {
+    kind: 'plot-frame';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    radius: number;
+};
+export declare function createPointFocusRingGeometry(options: {
+    target: Pick<ChartTarget, 'x' | 'y'>;
+    plotWidth: number;
+    plotHeight: number;
+    strokePadding?: number;
+    radius?: number;
+}): ChartPointFocusRingGeometry | null;
+export declare function createBarFocusRingGeometry(options: {
+    target: Pick<ChartTarget, 'x' | 'y' | 'width' | 'height'>;
+    plotWidth: number;
+    plotHeight: number;
+    strokePadding?: number;
+    minimumWidth?: number;
+    minimumHeight?: number;
+}): ChartBarFocusRingGeometry | null;

package/dist/_internal/chart/chart-utilities.d.ts

@@ -89,6 +89,7 @@ export type BarChartModel = {
     categories: NormalizedXValue[];
     yTicks: number[];
     categoryTicks: Array<{
+        categoryKey: string;
         label: string;
         x: number;
         y: number;
@@ -107,6 +108,7 @@ export type BarChartModel = {
         hidden: boolean;
     }>;
     tableRows: Array<{
+        categoryKey: string;
         categoryLabel: string;
         values: Array<{
             seriesId: string;

package/dist/_internal/chart/heatmap-utilities.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Shared heatmap math for grid-style charts (MatrixChart, Spectrogram).
+ *
+ * Both render a grid of cells coloured by magnitude. The normalization,
+ * degenerate-domain handling, diverging zero-centering, and NaN/Infinity
+ * filtering are identical, so they live here rather than drifting between the
+ * two component implementations.
+ */
+export type HeatmapColorScale = 'sequential' | 'diverging';
+/**
+ * Keep only finite numbers. `NaN`, `Infinity`, `-Infinity`, `null`, and
+ * `undefined` are dropped — invalid values must render as "missing" cells, not
+ * poison `Math.min`/`Math.max`, normalization, or `color-mix(... NaN%)`.
+ */
+export declare function finiteNumbers(values: ReadonlyArray<number | null | undefined>): number[];
+/** A finite number, or `null` for anything non-finite (the "missing cell" sentinel). */
+export declare function toFiniteOrNull(value: unknown): number | null;
+export type HeatmapDomain = {
+    readonly min: number;
+    readonly max: number;
+    /** Empty when there are no finite values to scale. */
+    readonly isEmpty: boolean;
+};
+/**
+ * Compute the [min, max] domain over the finite values only.
+ *
+ * A single pass — NOT `Math.min(...finite)` — so a dense heatmap or a
+ * multi-thousand-bin spectrogram can't overflow the call stack / argument limit
+ * by spreading a huge array into the `Math` functions.
+ */
+export declare function heatmapDomain(values: ReadonlyArray<number | null | undefined>): HeatmapDomain;
+/**
+ * Compute the [min, max] domain over a sequence of rows (e.g. spectrogram
+ * frames) WITHOUT first flattening them into one big array. A single nested pass
+ * over the original arrays, so a large frames × bins grid never materializes a
+ * full flattened copy just to find its colour domain.
+ */
+export declare function heatmapDomainOfRows(rows: ReadonlyArray<ReadonlyArray<number | null | undefined>>): HeatmapDomain;
+/**
+ * Normalize `value` into `[0, 1]` against the domain.
+ *
+ * - Sequential: linear from `min`→0 to `max`→1. A degenerate domain
+ *   (`min === max`) maps everything to the midpoint `0.5` (a single colour).
+ * - Diverging: zero-centred. The scale is symmetric around 0 using the larger
+ *   absolute bound, so `0` always maps to `0.5` (neutral) regardless of how
+ *   lopsided the data is. E.g. domain `[-10, 30]` → 0 maps to 0.5, not blue.
+ */
+export declare function normalizeHeatmapValue(value: number, domain: HeatmapDomain, scale?: HeatmapColorScale): number;
+/**
+ * CSS `color-mix` fill for a heatmap cell. `null` (missing) returns the inset
+ * surface. Sequential mixes the primary series colour; diverging mixes a cool
+ * colour below the midpoint and a warm colour above it, both fading to the inset
+ * surface at the neutral midpoint.
+ */
+export declare function heatmapCellFill(value: number | null, domain: HeatmapDomain, scale?: HeatmapColorScale): string;
+/**
+ * Choose a readable label colour for a cell: a light colour over high-intensity
+ * (dark) fills, a dark colour over low-intensity (light) fills.
+ */
+export declare function heatmapLabelFill(value: number | null, domain: HeatmapDomain, scale?: HeatmapColorScale): string;

package/dist/components/accordion/accordion.schema.js

@@ -3,25 +3,43 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -55,4 +73,4 @@ export {
   accordion_schema_default as default
 };
 
-//# debugId=7554419C51FE088264756E2164756E21
+//# debugId=E7769D5347732F2964756E2164756E21