@mkbabb/glass-ui 3.12.0 → 4.0.0

package/dist/components/custom/handmark/constants.d.ts

@@ -0,0 +1,39 @@
+/**
+ * constants.ts — the marking-space geometry constants (the colocation home).
+ * ─────────────────────────────────────────────────────────────────────────────
+ * The hand-mark family's named geometry constants live here (the AY.W-COLOCATE
+ * convention's `constants.ts` home). geometry.ts + the SFC re-read them by name.
+ */
+/** Marking-space width (the 0..100 × 0..40 viewBox; `preserveAspectRatio="none"`). */
+export declare const VB_W = 100;
+/** Marking-space height. */
+export declare const VB_H = 40;
+/**
+ * The hairline gap, as a fraction of the `.hm` box, between the MEASURED text
+ * baseline and the underline centerline. The underline rides just under the real
+ * glyph bottoms — a hand mark sits a few % of cap-height below the baseline, never
+ * through it (the E1 occlusion root: a constant `y=32` strikethroughs tight-leading
+ * display type because 80% of a `line-height:1.02` box IS the baseline).
+ */
+export declare const UNDERLINE_GAP = 0.06;
+/**
+ * The highlighter LOW-SEAT band (BA.W-HANDMARK C-1(a)). A real highlighter rides
+ * the low two-thirds of the line — the ink sits on the baseline and rises to
+ * ~x-height — NOT the box vertical center the fork shipped. The band centerline
+ * seats at `baselineFrac − HIGHLIGHT_RISE` (raised off the baseline by ~half a
+ * lowercase x-height) so the wide slab (weight 26) covers x-height down to the
+ * baseline. Expressed as a fraction of the `.hm` box, parallel to UNDERLINE_GAP.
+ */
+export declare const HIGHLIGHT_RISE = 0.22;
+/** Pre-measure fallback for the highlight band's low seat (null baselineFrac). */
+export declare const HIGHLIGHT_FALLBACK_FRAC = 0.66;
+/**
+ * Natural-underline morphology (BA.W-HANDMARK C-2). The procedural wobble is
+ * SCALE-RELATIVE: the amplitude is a fraction of the rendered word width (a long
+ * word and a short word wobble in proportion, not the viewBox-stretched-constant
+ * the fork's GlassUnderline shipped). The period count is IRREGULAR — a seeded
+ * pick in [PERIODS_MIN, PERIODS_MAX] — so two seeds differ in hump count, never
+ * identical twins.
+ */
+export declare const PERIODS_MIN = 2;
+export declare const PERIODS_MAX = 4;

package/dist/components/custom/handmark/geometry.d.ts

@@ -12,21 +12,19 @@
  *   - text mode (box == null): use the full viewBox (single-line underline/strike)
  *   - positioned mode (box = {x,y,w,h}): map an explicit rect (circle a datum)
  *
- * The circle arm rides pencil-boil 0.4.0's `ellipsePoints` (the hand-circle
+ * The circle arm rides pencil-boil 0.4.x's `ellipsePoints` (the hand-circle
  * overshoot ring — the sole upstream geometry delta this component required).
+ *
+ * THE SEED RECONCILE (BA.W-HANDMARK [S2]): the wobble centerlines are seeded from
+ * the HOUSE prng leaf (`src/utils/prng.ts` mulberry32 + hashString — the AV.W14
+ * single-source). The family FEEDS pencil-boil a house-derived integer seed; glass-
+ * ui code imports ZERO `mulberry32` from pencil-boil (its internal mulberry32 stays
+ * inside its OWN perturb math). ONE seed leaf, the house identity.
  */
 import { type WobbleOptions } from "@mkbabb/pencil-boil";
+import { UNDERLINE_GAP, VB_H, VB_W } from "./constants";
 import type { HandShape, MarkBox } from "./types";
-export declare const VB_W = 100;
-export declare const VB_H = 40;
-/**
- * The hairline gap, as a fraction of the `.hm` box, between the MEASURED text
- * baseline and the underline centerline. The underline rides just under the real
- * glyph bottoms — a hand mark sits a few % of cap-height below the baseline, never
- * through it (the E1 occlusion root: a constant `y=32` strikethroughs tight-leading
- * display type because 80% of a `line-height:1.02` box IS the baseline).
- */
-export declare const UNDERLINE_GAP = 0.06;
+export { VB_W, VB_H, UNDERLINE_GAP };
 /** A shape maps to one or more centerlines (open polylines) or one closed ring. */
 export interface ShapeGeom {
     lines: [number, number][][];
@@ -42,8 +40,12 @@ export interface ShapeGeom {
  * box), which struck through tight-leading headings. `null` ⇒ not yet measured: fall
  * back to the legacy `VB_H − 8` constant so first paint (and jsdom/SSR) still renders
  * a line, replaced the instant the measure lands.
+ *
+ * `natural` (BA.W-HANDMARK C-2) routes the underline through the procedural
+ * `naturalUnderlinePoints` morphology instead of pencil-boil's `wobbleLinePoints`
+ * (the masthead `boil` voice); the default underline keeps the pencil-boil line.
  */
-export declare function shapeGeom(shape: HandShape, opts: WobbleOptions, box?: MarkBox | null, baselineFrac?: number | null): ShapeGeom;
+export declare function shapeGeom(shape: HandShape, opts: WobbleOptions, box?: MarkBox | null, baselineFrac?: number | null, natural?: boolean): ShapeGeom;
 /** Boil one geometry: re-perturb the CACHED centerlines (anchored → no draw-on pop). */
 export declare function boilLines({ lines, closed }: ShapeGeom, amount: number, seed: number): [number, number][][];
 /** Serialize centerlines → one SVG `d` (multi-line shapes concat with a space). */

package/dist/components/custom/handmark/index.d.ts

@@ -9,7 +9,13 @@
  *
  * The DEFAULT is `pen` (clean ink, grain:0 ⇒ no filter, zero extra dep). The
  * `@mkbabb/pencil-boil` geometry + `perfect-freehand` body are OPTIONAL PEERS;
- * only `ribbon:'hull'` touches the vendored pf core (treeshaken otherwise).
+ * only `ribbon:'hull'` (the highlighter) touches the vendored pf core (treeshaken
+ * otherwise).
+ *
+ * BA.W-HANDMARK: `GlassUnderline`/the `/underline` subpath RETIRED onto
+ * `HandMark shape="underline"` (DEC-8 outcome 1; clean break, no alias). The
+ * editorial draw-on underline is `<HandMark shape="underline" animation="draw-on">`;
+ * the natural pencil-boil morphology is the `boil` brush.
  */
 export { default as HandMark, default as InkMark } from "./HandMark.vue";
 export { BRUSHES, resolveBrush, lerpBrush, type Brush, type BrushName, type BlendMode, type TaperSpec, type StampFn, type InkPath, } from "./brush";
@@ -17,5 +23,5 @@ export { shapeGeom, serialize, boilLines, VB_W, VB_H, UNDERLINE_GAP, type ShapeG
 export { ink, type SVGFragment } from "./ink";
 export { grainFilter, hasGrain } from "./texture";
 export { getStroke, getStrokePoints, getSvgPathFromStroke, type StrokeOptions, type InputPoint, } from "./freehand";
-export { useHandMark, normalizeProps, type UseHandMarkInput, type HandMarkCore, type BoilClock, } from "./useHandMark";
+export { useHandMark, normalizeProps, type UseHandMarkInput, type HandMarkCore, type BoilClock, } from "./composables/useHandMark";
 export type { HandMarkProps, HandShape, HandAnimation, MarkBox, } from "./types";

package/dist/components/custom/handmark/types.d.ts

@@ -44,6 +44,15 @@ export interface HandMarkProps {
     segments?: number;
     /** angular kinks vs smooth bezier. default false. */
     jagged?: boolean;
+    /**
+     * NATURAL underline morphology (BA.W-HANDMARK C-2). When true (the masthead
+     * `boil` voice), the underline geometry goes PROCEDURAL — scale-relative
+     * amplitude, an IRREGULAR seeded period count, off the house prng leaf feeding
+     * pencil-boil — instead of pencil-boil's single `wobbleLinePoints` line. The
+     * `boil` brush auto-engages it; the default underline keeps the pencil-boil line.
+     * Ignored on non-underline shapes.
+     */
+    natural?: boolean;
     /** POSITIONED mode (circle a datum): explicit target rect. */
     box?: MarkBox;
     /** shape:'path' escape hatch — arbitrary SVG `d` (wins over shape). */

package/dist/components/custom/icon-chip/IconChip.vue.d.ts

@@ -0,0 +1,4 @@
+import type { IconChipProps } from "./types";
+declare const __VLS_export: import("vue").DefineComponent<IconChipProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<IconChipProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/icon-chip/index.d.ts

@@ -0,0 +1,2 @@
+export { default as IconChip } from "./IconChip.vue";
+export type { IconChipProps, IconChipIcon, IconChipSection, IconChipTone, } from "./types";

package/dist/components/custom/icon-chip/types.d.ts

@@ -0,0 +1,72 @@
+import type { Component, FunctionalComponent, HTMLAttributes } from "vue";
+/**
+ * Permissive icon type — Vue's `Component` ships across multiple structurally
+ * incompatible shapes (the @lucide/vue v1 functional-component form is one), so
+ * we accept the union a `<component :is>` render expression handles. Mirrors the
+ * `MetricCell` `IconLike` precedent (the AZ `isComponent` allowance).
+ */
+export type IconChipIcon = Component | FunctionalComponent | object;
+/** A 0..12 index into the `--section-color-N` 13-stop ramp. */
+export type IconChipSection = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+/**
+ * A complete token colour for the chip event (e.g. `var(--chart-download)`,
+ * `var(--tier-featured)`) — the MetricCell-`iconColor` reconcile path. NEVER a
+ * demo-local literal hue (ppmycota purple stays out of the library — the chip
+ * `tone` arm takes a token).
+ */
+export type IconChipTone = string;
+export interface IconChipProps {
+    /**
+     * The lucide glyph (functional-component form per the AZ `isComponent`
+     * precedent). Rendered via `<component :is>`.
+     */
+    icon: IconChipIcon;
+    /**
+     * The `--section-color-N` ramp index (0..12) — the section arm. XOR `tone`.
+     * When both are set, `tone` wins (the explicit complete-token override).
+     * Typed `number` for data-driven consumers (a `v-for` over a descriptor list
+     * with a `section: number` field); the 0..12 canonical range is the
+     * `IconChipSection` union the discovery layer publishes.
+     */
+    section?: number;
+    /**
+     * A complete token colour (the tone arm — the MetricCell-`iconColor`
+     * reconcile). XOR `section`.
+     */
+    tone?: IconChipTone;
+    /**
+     * The chip diameter in px — the FLOOR is `glyphSize × --icon-chip-glyph-ratio`
+     * so the plate can never paint under the glyph (the d2 proportion, structural).
+     * Default `48` (the reference register, 48/22 ≈ 2.18).
+     */
+    size?: number;
+    /** The lucide glyph pixel size. Default `22` (the reference register). */
+    glyphSize?: number;
+    /** The lucide glyph stroke width. Default `1.75` (the reference register). */
+    strokeWidth?: number;
+    /**
+     * The NO-PLATE register — render the full-chroma glyph with NO backplate
+     * (the MetricCell leading-glyph tint). The chip≤glyph floor is moot (no plate).
+     */
+    bare?: boolean;
+    /**
+     * Duotone fill — a low-alpha fill of the same hue UNDER the full-chroma
+     * stroke (the iOS/Material "filled-tonal" move). Mono-hue (proportion-safe,
+     * never a second hue). Default `false`.
+     */
+    duotone?: boolean;
+    /**
+     * The chip's own smooth-glass hover register (the backplate mix lifts, a soft
+     * glow ring appears, the stroke firms) — on the §6 easing doctrine, PRM-gated,
+     * disco-FREE. Default `false`.
+     */
+    bloom?: boolean;
+    /**
+     * Entrance choreography — composes the shipped `vReveal` directive. A numeric
+     * value is the `--d` stagger index; `true` is index 0. PRM-gated by `vReveal`'s
+     * construction. Default `false`.
+     */
+    reveal?: boolean | number;
+    /** Pass-through class on the chip root. */
+    class?: HTMLAttributes["class"];
+}

package/dist/components/custom/instrument-chassis/InstrumentChassis.vue.d.ts

@@ -17,8 +17,19 @@ export type InstrumentChassisPhase = "ready" | "ping" | "download" | "upload" |
  *   architectural underclaim. Consumed at quiet-content App-level
  *   mounts (the inner card paints its own glass tier — the spine is
  *   the housing that frames it).
+ *
+ * - `"structure"` (BA.W-ATLAS-RECONCILE C-3) — the SILVER structure-metal
+ *   register. A cool polished-steel milled-panel read: the engraved bezel +
+ *   the structural grooves re-point to the `--silver` quad (the gold quad's
+ *   cool mirror) instead of the warm-cream `--surface-tint-*` default, so the
+ *   chassis reads as an INDUSTRIAL precision-instrument housing — the cool-metal
+ *   twin of the gold "complete"-phase affirmation. The phase cascade stays
+ *   orthogonal (a `structure` chassis still retints on `data-phase`); only the
+ *   structure-metal recipe forks. The silver is the W-NO-GRAY named cool-neutral
+ *   exception. Consumer #2 of the silver quad (the atlas's structure surface is
+ *   consumer #1).
  */
-export type InstrumentChassisVariant = "glass" | "spine";
+export type InstrumentChassisVariant = "glass" | "spine" | "structure";
 /**
  * <InstrumentChassis> — single glass surface composing strip / dial / control
  * regions, glued together by twin-line hairline grooves.
@@ -28,8 +39,8 @@ export type InstrumentChassisVariant = "glass" | "spine";
  * the `<ChassisDivider>` adjacent to each — emit markup only when bound.
  * I gate `<header>`, `<footer>`, and the two dividers on `$slots.strip` /
  * `$slots.control` presence, so empty-slot consumers don't have to suppress
- * the markup with `display: none` overrides. Mirrors the `v-if="$slots.status"`
- * idiom InstrumentRail established.
+ * the markup with `display: none` overrides — the `v-if="$slots.status"`
+ * slot-gating idiom.
  *
  * The chassis owns the `--phase-color` cascade via `data-phase`; phase label,
  * hero number, and phase progress fill all read it through one CSS custom
@@ -56,7 +67,9 @@ type __VLS_Props = {
      * Surface register. Defaults to `"glass"` (the canonical chassis
      * plate). Pass `"spine"` at App-level mount paths to get the
      * housing register (polished sleeve, no backdrop-filter, interior
-     * vignette + hairline outer stroke).
+     * vignette + hairline outer stroke). Pass `"structure"` for the
+     * silver milled-panel register (cool polished-steel bezel + grooves;
+     * BA.W-ATLAS-RECONCILE C-3).
      */
     variant?: InstrumentChassisVariant;
     class?: HTMLAttributes["class"];

package/dist/components/custom/labeled-field/LabeledField.vue.d.ts

@@ -16,6 +16,19 @@ import { type HTMLAttributes } from "vue";
  * cursor-help). The previous mixed `text-base` / `text-lg` literals
  * harmonise on a single body-size token.
  *
+ * AZ.W-BLOB-REDRESS — `hideLabel` VISUALLY hides the field's own label (it
+ * renders `sr-only` instead of `.labeled-field-label`) while KEEPING it in the
+ * DOM, so the `for`/`id`/`aria-labelledby` control↔label association — the
+ * Slider thumb's `aria-labelledby`, the Select trigger's `for` — stays intact
+ * and the control is still accessibly named. The visible human label is then
+ * supplied by an enclosing chrome row (a `<ConfiguratorRow label>`). This is
+ * the canonical fix for the double-label leak: a `<ConfiguratorRow label="X">`
+ * wrapping a `<LabeledSlider label="x">` rendered BOTH labels (the human one +
+ * the raw config key); the inner control passes `hide-label` so ONE visible
+ * human label remains, the raw key demotes to the row's mono `name` token, and
+ * a11y is preserved. The tooltip is suppressed when hidden (the row owns the
+ * affordance). NO effect on `LabeledField` used standalone (default `false`).
+ *
  * AQ.W4 §W4.5 — `required` threads a `aria-hidden` asterisk onto the label
  * (the `required` attr on the slotted control is the semantic carrier). The
  * `error` slot renders an error-message region that the W3.1c
@@ -24,12 +37,36 @@ import { type HTMLAttributes } from "vue";
  * default slot's `errorId` slot-prop so the slotted control can bind
  * `aria-errormessage="errorId"` (the four wrappers auto-wire it; a raw
  * `<LabeledField>` slot binds it manually).
+ *
+ * # LabeledField vs ConfiguratorRow — recorded divergence (AZ.W-METRIC-UNIFY §B)
+ *
+ * Both are "label (+ meta) above/beside a slotted control", but they are NOT
+ * interchangeable — they emphasize DIFFERENT features:
+ *  - LabeledField (this) — for FORM fields. Carries the `for`/`id` label↔control
+ *    a11y wiring (`controlId`/`labelId`/`errorId`), the `tooltip`, the `required`
+ *    asterisk, and the `aria-live` `error` region.
+ *  - ConfiguratorRow — for TOKEN / PRESET controls. Carries the token-`name`
+ *    reference, the opt-in `reset` affordance (`canReset`), and the four-rung
+ *    `density` axis. No a11y for/id wiring.
+ *
+ * Reach for LabeledField for accessible form inputs; reach for ConfiguratorRow
+ * inside a `<Configurator>` for token sliders/selects. The divergence is recorded
+ * (NOT a forced merge — no ≥2-consumer shared-chassis need surfaced) in
+ * `docs/precepts/design-idioms.md §9`, alongside the `cn`/`focus-ring` keeps.
  */
 type __VLS_Props = {
     label: string;
     tooltip?: string;
     labelClass?: HTMLAttributes["class"];
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the field's own label `sr-only` (kept in the
+     * DOM for the control↔label a11y association) instead of visibly. Use when
+     * an enclosing chrome row already supplies the visible human label (a
+     * `<ConfiguratorRow label>`), so the inner control does not leak a second
+     * (often raw-config-key) label. Default `false` (standalone behavior).
+     */
+    hideLabel?: boolean;
 };
 declare var __VLS_7: {
     errorId: string;

package/dist/components/custom/labeled-field/LabeledSelect.vue.d.ts

@@ -8,6 +8,12 @@ type __VLS_Props = {
     labelClass?: string;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;

package/dist/components/custom/labeled-field/LabeledSlider.vue.d.ts

@@ -8,6 +8,12 @@ type __VLS_Props = {
     step: number;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: number) => any;

package/dist/components/custom/labeled-field/LabeledSwitch.vue.d.ts

@@ -5,6 +5,12 @@ type __VLS_Props = {
     labelClass?: string;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:checked": (value: boolean) => any;

package/dist/components/custom/metric-badge/MetricBadge.vue.d.ts

@@ -1,9 +1,10 @@
 import type { HTMLAttributes } from 'vue';
-type MetricBadgeSize = 'sm' | 'md' | 'lg' | 'xl';
-type MetricBadgeLabelPosition = 'inline' | 'stacked';
-type MetricBadgeVariant = 'default' | 'record';
-type __VLS_Props = {
-    amount: string | number | null | undefined;
+import { type MetricValue } from '../../../utils';
+export type MetricBadgeSize = 'sm' | 'md' | 'lg' | 'xl';
+export type MetricBadgeLabelPosition = 'inline' | 'stacked';
+export interface MetricBadgeProps {
+    /** The primary metric. A valid `0` renders `"0"`, never the placeholder. */
+    value: MetricValue;
     unit?: string;
     /** Full annotation slot, rendered as a sibling `<span>` with classnames
      *  `metric-badge__label metric-badge__label--full`. Tracked uppercase,
@@ -21,27 +22,19 @@ type __VLS_Props = {
      *  the label slot does not render even if `label`/`abbreviation` carry
      *  values. */
     labelPosition?: MetricBadgeLabelPosition;
-    /** Color applied to the amount when it's truthy. */
+    /** Color applied to the value when it's non-empty. */
     color?: string;
-    /** Substitute glyph when amount is empty. */
+    /** Substitute glyph when value is empty (null / undefined / ""). */
     placeholder?: string;
     /** Typographic scale. Defaults to `md`. The ladder reads
      *  sm 11px / md 12px / lg 14px / xl 18px; `xl` is the audacious-poster
-     *  rung (`text-mono-prose` amount, `text-prose` unit) for hero
+     *  rung (`text-mono-prose` value, `text-prose` unit) for hero
      *  placements that need to read at chassis distance. */
     size?: MetricBadgeSize;
-    /** Surface register. `default` is the canonical 5-tier glass pill;
-     *  `record` is the GILT pill (D6.b) — a 1px `--gold-rim` tooled edge +
-     *  `--gold-ink` amount + a faint ≤8% gold wash (never opaque). Gold marks
-     *  the SUPERLATIVE, exactly one per view: the all-time-high / peak figure.
-     *  The medal reads as earned, not as a fourth data color. */
-    variant?: MetricBadgeVariant;
     class?: HTMLAttributes['class'];
-};
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+}
+declare const __VLS_export: import("vue").DefineComponent<MetricBadgeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricBadgeProps> & Readonly<{}>, {
     size: MetricBadgeSize;
-    variant: MetricBadgeVariant;
-    placeholder: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/custom/metric-badge/index.d.ts

@@ -1 +1,2 @@
 export { default as MetricBadge } from "./MetricBadge.vue";
+export type { MetricBadgeProps, MetricBadgeSize, MetricBadgeLabelPosition, } from "./MetricBadge.vue";

package/dist/components/custom/metric-cell/MetricCell.vue.d.ts

@@ -1,4 +1,5 @@
 import type { Component, FunctionalComponent, HTMLAttributes } from "vue";
+import { type MetricValue } from "../../../utils";
 /**
  * Permissive icon type — Vue's `Component` type ships across multiple
  * package boundaries (vue / @vue/runtime-core duplication when consumers
@@ -54,13 +55,24 @@ export interface MetricCellProps {
     iconStrokeWidth?: number;
     /** Icon pixel size — defaults to 14 (matches `text-micro` cap height). */
     iconSize?: number;
+    /**
+     * Optional accent colour for the LEADING GLYPH ONLY (e.g. a semantic
+     * `var(--chart-download)` viz colour). Tints the icon — the one
+     * deliberate colour event for the cell — while the label, value, and unit
+     * stay neutral ink (the one-color-event proportion rule, AZ.W-SUFFUSE D3).
+     * Unset (default) keeps the glyph the neutral `--muted-foreground` of the
+     * label row.
+     */
+    iconColor?: string;
     /** Label text — reads through the `label` slot when set. */
     label?: string;
-    /** Value — primary metric. Reads through the `value` slot when set. */
-    value?: string | number | null | undefined;
+    /** Value — primary metric. Reads through the `value` slot when set. A valid
+     *  `0` renders `"0"`, never the placeholder. */
+    value?: MetricValue;
     /** Unit suffix appended after the value (e.g. "Mbps", "ms"). */
     unit?: string;
-    /** Placeholder glyph when value is empty/null. Defaults to em-dash. */
+    /** Placeholder glyph when value is empty/null. Defaults to em-dash (the
+     *  shared `coalesceMetric` default). */
     placeholder?: string;
     /**
      * Visual register.
@@ -82,7 +94,6 @@ type __VLS_Slots = {} & {
     value?: (props: typeof __VLS_10) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<MetricCellProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricCellProps> & Readonly<{}>, {
-    placeholder: string;
     appearance: MetricCellAppearance;
     iconStrokeWidth: number;
     iconSize: number;

package/dist/components/custom/metric-stack/MetricRow.vue.d.ts

@@ -1,4 +1,5 @@
 import type { HTMLAttributes, Component } from "vue";
+import { type MetricValue } from "../../../utils";
 /**
  * MetricRow — a single row inside <MetricStack>.
  *
@@ -39,11 +40,13 @@ export interface MetricRowProps {
     iconSize?: number;
     /** Label text — reads through the label slot when set. */
     label?: string;
-    /** Value text (the audacious-poster hero number). */
-    value?: string | number | null | undefined;
+    /** Value text (the audacious-poster hero number). A valid `0` renders
+     *  `"0"`, never the placeholder. */
+    value?: MetricValue;
     /** Unit suffix — reads through the unit slot when set. */
     unit?: string;
-    /** Placeholder glyph when value is empty/null. Defaults to "—". */
+    /** Placeholder glyph when value is empty/null. Defaults to "—" (the shared
+     *  `coalesceMetric` default). */
     placeholder?: string;
     /**
      * Per-row phase colour. Sets `--phase-color` inline so descendant
@@ -87,7 +90,6 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<MetricRowProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricRowProps> & Readonly<{}>, {
     active: boolean;
-    placeholder: string;
     iconStrokeWidth: number;
     iconSize: number;
     digitCount: number;

package/dist/components/custom/pager-dots/PagerDots.vue.d.ts

@@ -0,0 +1,39 @@
+import type { HTMLAttributes } from "vue";
+export interface PagerDotsProps {
+    /** Total dot count (the slide/snap count). */
+    count: number;
+    /** Rail layout axis. Default horizontal. */
+    orientation?: "horizontal" | "vertical";
+    /**
+     * When set, window the rail to `fit` dots centered on the active dot
+     * (the DeckPager dock-gutter overflow generalized). Off (undefined) →
+     * show every dot.
+     */
+    windowFit?: number;
+    /** Encapsulate the rail in the glass pager pill chassis. Default true. */
+    ring?: boolean;
+    /** Accessible name for the rail group. */
+    ariaLabel?: string;
+    /** Additional classes for the rail root. */
+    class?: HTMLAttributes["class"];
+}
+type __VLS_Props = PagerDotsProps;
+type __VLS_ModelProps = {
+    /** v-model:active — the active 0-based index. */
+    "active"?: number;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:active": (value: number) => any;
+} & {
+    select: (index: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onSelect?: ((index: number) => any) | undefined;
+    "onUpdate:active"?: ((value: number) => any) | undefined;
+}>, {
+    orientation: "horizontal" | "vertical";
+    ariaLabel: string;
+    ring: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/custom/pager-dots/index.d.ts

@@ -0,0 +1,2 @@
+export { default as PagerDots } from "./PagerDots.vue";
+export type { PagerDotsProps } from "./PagerDots.vue";

package/dist/components/custom/tabs/SegmentedTabs.vue.d.ts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes } from "vue";
-/** The canonical tab/option shape — one descriptor across all three variants. */
+/** The canonical tab/option shape — one descriptor across both materials. */
 export interface SegmentedTabOption {
     label: string;
     value: string;
@@ -7,9 +7,13 @@ export interface SegmentedTabOption {
     disabled?: boolean;
     tooltip?: string;
 }
-/** The three indicator chromes. `segmented` (default) = the muted pill-slider;
- *  `pill` = the solid `--foreground` pill; `underline` = the hairline rule. */
-export type SegmentedTabsVariant = "segmented" | "pill" | "underline";
+/** The two materials. `pill` (DEFAULT) = the glass-track slider (absorbs the
+ *  retired `segmented`); `underline` = the paper ink-hairline rule. */
+export type SegmentedTabsVariant = "pill" | "underline";
+/** The orientation axis — `horizontal` (default) lays children in a row + tracks
+ *  the indicator on the inline axis; `vertical` stacks a column + tracks the
+ *  block axis (the vertical underline is the leading-edge ink rail). */
+export type SegmentedTabsOrientation = "horizontal" | "vertical";
 export interface SegmentedTabsResponsive {
     /**
      * CSS length consumed inside `(min-width: <breakpoint>)`. BELOW it the
@@ -30,34 +34,26 @@ export interface SegmentedTabsResponsive {
 export interface SegmentedTabsProps {
     options: SegmentedTabOption[];
     /**
-     * Indicator chrome — `segmented` (DEFAULT, the pill-slider over a muted
-     * track), `pill` (solid foreground pill), `underline` (the hairline rule).
+     * The material — `pill` (DEFAULT, the glass-track slider) or `underline`
+     * (the paper ink-hairline rule).
      */
     variant?: SegmentedTabsVariant;
     /**
-     * Multi-select — when true the surface mutates as a ToggleGroup (N
-     * simultaneous pressed buttons, `role="group"`). Only valid on the
-     * `segmented`/`pill` variants; `underline` is panel-nav (single-select).
+     * Orientation — `horizontal` (default) or `vertical`. Axis-derived on the
+     * one indicator engine.
      */
-    multiSelect?: boolean;
+    orientation?: SegmentedTabsOrientation;
     /**
-     * Tab-row overflow handling.
-     * - `"none"` (default) — inline-grid; tabs share width and clip.
-     * - `"scroll"` — flex row with intrinsic widths + edge fades; never clips.
-     * - `"auto"` — flex row with intrinsic widths + plain horizontal scroll.
-     */
-    overflow?: "none" | "scroll" | "auto";
-    /**
-     * Responsive collapse — below the breakpoint the strip becomes a `<Select>`
-     * (subsumes the former standalone ResponsiveTabs). `true` uses defaults;
-     * an object tunes the breakpoint / desktop subset / accessible name.
+     * Responsive collapse — below the breakpoint the strip becomes a `<Select>`.
+     * `true` uses defaults; an object tunes the breakpoint / desktop subset /
+     * accessible name.
      */
     responsive?: boolean | SegmentedTabsResponsive;
     class?: HTMLAttributes["class"];
 }
 type __VLS_Props = SegmentedTabsProps;
 type __VLS_ModelProps = {
-    modelValue: string | string[];
+    modelValue: string;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare var __VLS_50: {
@@ -73,14 +69,13 @@ type __VLS_Slots = {} & {
     option?: (props: typeof __VLS_58) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string | string[]) => any;
+    "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string | string[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    overflow: "none" | "scroll" | "auto";
+    orientation: SegmentedTabsOrientation;
     variant: SegmentedTabsVariant;
     responsive: boolean | SegmentedTabsResponsive;
-    multiSelect: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;