@m0saic/templates 0.2.0

package/dist/m0saic/charts/bar-graph/v1/bar-graph.js

@@ -0,0 +1,316 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartsBarGraph = void 0;
+const types_1 = require("@m0saic/types");
+const dsl_stdlib_1 = require("@m0saic/dsl-stdlib");
+const template_utils_1 = require("@m0saic/template-utils");
+const axis_1 = require("./axis");
+const format_1 = require("./format");
+const defaults_1 = require("./defaults");
+// ---------------------------------------------------------------------------
+// Props Schema (public)
+// ---------------------------------------------------------------------------
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    values: {
+        type: "number[]",
+        required: true,
+        description: "Numeric data values driving the chart bars.",
+        meta: { constraints: { minItems: 1 }, ui: { label: "Values", order: 1 } },
+    },
+    orientation: {
+        type: "string",
+        required: false,
+        description: "Bar orientation: vertical or horizontal.",
+        meta: { constraints: { oneOf: ["vertical", "horizontal"] }, ui: { label: "Orientation", order: 2 } },
+    },
+    labels: {
+        type: "string[]",
+        required: false,
+        description: "Optional category labels (index-aligned to values).",
+        meta: { ui: { label: "Category Labels", order: 3 } },
+    },
+    title: {
+        type: "string",
+        required: false,
+        description: "Chart title.",
+        meta: { control: { placeholder: "e.g., Monthly Sales" }, ui: { label: "Title", order: 1 } },
+    },
+    subtitle: {
+        type: "string",
+        required: false,
+        description: "Chart subtitle.",
+        meta: { control: { placeholder: "e.g., Q4 2024" }, ui: { label: "Subtitle", order: 2 } },
+    },
+    minValue: {
+        type: "number",
+        required: false,
+        description: "Explicit domain minimum (optional).",
+        meta: { ui: { label: "Min Value", order: 4 } },
+    },
+    maxValue: {
+        type: "number",
+        required: false,
+        description: "Explicit domain maximum (optional).",
+        meta: { control: { placeholder: "data max" }, ui: { label: "Max Value", order: 5 } },
+    },
+    highlightIndex: {
+        type: "number",
+        required: false,
+        description: "Optional bar index to highlight (neutral emphasis).",
+        meta: { control: { placeholder: "none" }, constraints: { min: 0 }, ui: { label: "Highlight Index", order: 6 } },
+    },
+    // Layout (canonical: pixels)
+    gap: {
+        type: "number",
+        required: false,
+        description: "Gap between bars in pixels.",
+        meta: { constraints: { min: 0, max: 256 }, ui: { label: "Gap (px)", order: 10 } },
+    },
+    padding: {
+        // Public prop is currently `number` in your types.ts scaffold,
+        // but defaults.ts resolves union → ResolvedPadding. If you later
+        // want true per-side padding, make this a union.
+        type: "number",
+        required: false,
+        description: "Outer padding in pixels (symmetric).",
+        meta: { constraints: { min: 0, max: 512 }, ui: { label: "Padding (px)", order: 11 } },
+    },
+    barThickness: {
+        type: "number",
+        required: false,
+        description: "Optional fixed bar thickness in pixels. If unset, bars share space evenly.",
+        meta: { control: { placeholder: "auto (from gap)" }, constraints: { min: 1, max: 4096 }, ui: { label: "Bar Thickness (px)", order: 12 } },
+    },
+    cornerRadius: {
+        type: "number",
+        required: false,
+        description: "Geometric radius fraction (0..1) for bars and container corners.",
+        meta: { constraints: { min: 0, max: 1 }, ui: { label: "Corner Radius", order: 13 } },
+    },
+    // Appearance
+    preset: {
+        type: "string",
+        required: false,
+        description: "Theme preset.",
+        meta: { constraints: { oneOf: ["neutral", "dark", "terminal", "glass", "paper"] }, ui: { label: "Preset", order: 20 } },
+    },
+    barColor: {
+        // `json` (permissive) so the prop accepts a single color OR a per-bar color
+        // array (the impl supports both); the editor still renders a color picker via
+        // `constraints.isColor`.
+        type: "json",
+        required: false,
+        description: "Bar fill color — a single color, or an array of per-bar colors (cycled in bar order).",
+        meta: { constraints: { isColor: true }, control: { colorPicker: true }, ui: { label: "Bar Color", order: 21 } },
+    },
+    track: {
+        type: "group",
+        required: false,
+        description: "Track (background rail) configuration.",
+        meta: { ui: { label: "Track", collapsedByDefault: true } },
+    },
+    grid: {
+        type: "group",
+        required: false,
+        description: "Grid configuration (show, count).",
+        meta: { ui: { label: "Grid", collapsedByDefault: true } },
+    },
+    baseline: {
+        type: "group",
+        required: false,
+        description: "Baseline configuration (show).",
+        meta: { ui: { label: "Baseline", collapsedByDefault: true } },
+    },
+    valueAxis: {
+        type: "group",
+        required: false,
+        description: "Value-axis line at the max-value side (top for vertical / right for horizontal).",
+        meta: { ui: { label: "Value Axis", collapsedByDefault: true } },
+    },
+    valueLabels: {
+        type: "group",
+        required: false,
+        description: "Value label config (show/format/decimals).",
+        meta: { ui: { label: "Value Labels", collapsedByDefault: true } },
+    },
+    anim: {
+        type: "group",
+        required: false,
+        description: "Animation config (intro timing, easing, reduceMotion).",
+        meta: { ui: { label: "Animation", collapsedByDefault: true } },
+    },
+});
+// ---------------------------------------------------------------------------
+// Template Definition
+// ---------------------------------------------------------------------------
+exports.ChartsBarGraph = {
+    id: (0, types_1.asTemplateId)("@m0saic/charts/bar-graph/v1"),
+    label: "Bar Graph",
+    version: 1,
+    description: "Canonical bar graph data-viz primitive supporting vertical/horizontal, with first-class animation and presets.",
+    capabilities: { tier: "core" },
+    primitive: true, // foundational data-viz building block (composed by dashboards/reports)
+    deprecated: {
+        reason: "Early template: a 5-deep nested-template composition (ChartFrame → PlotArea → BarsStack → BarCell → BarFill) where every bar is a FULL-PLOT-HEIGHT tile carved by a transparent base + overlay crop — wasted pixels + per-layer composite tax, and it errors on the CLI render path once labels are added. Use v2 — same chart, flat single doc with tight baseline-anchored bar rects; ~2× fewer render steps and faster.",
+        replacement: (0, types_1.asTemplateId)("@m0saic/charts/bar-graph/v2"),
+        since: "2026-06-21",
+    },
+    tags: ["charts", "bar-graph", "chart", "data-viz"],
+    outputHints: { width: 1920, height: 1080, fps: 30, durationMs: 2000 },
+    propsSchema,
+    defaultProps: {
+        minValue: 0,
+        values: [35, 60, 85, 45, 70],
+        orientation: defaults_1.DEFAULT_ORIENTATION,
+        preset: defaults_1.DEFAULT_PRESET,
+        gap: defaults_1.DEFAULT_GAP,
+        padding: defaults_1.DEFAULT_PADDING.top, // symmetric public pad for now
+        cornerRadius: defaults_1.DEFAULT_CORNER_RADIUS,
+        track: defaults_1.DEFAULT_TRACK,
+        grid: defaults_1.DEFAULT_GRID,
+        baseline: defaults_1.DEFAULT_BASELINE,
+        valueAxis: defaults_1.DEFAULT_VALUE_AXIS,
+        valueLabels: defaults_1.DEFAULT_VALUE_LABELS,
+        anim: defaults_1.DEFAULT_ANIM,
+    },
+    async render(props, ctx) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        // 1) Validate required data
+        if (!props.values || props.values.length === 0) {
+            return (0, template_utils_1.makeErrorMosaic)("values[] must be non-empty", {
+                title: `${this.id} props`,
+                width: ctx.target.width,
+                height: ctx.target.height,
+            });
+        }
+        // 2) Resolve core props
+        const orientation = (_a = props.orientation) !== null && _a !== void 0 ? _a : defaults_1.DEFAULT_ORIENTATION;
+        const axisConfig = (0, axis_1.resolveAxisConfig)(orientation);
+        const preset = ((_b = props.preset) !== null && _b !== void 0 ? _b : defaults_1.DEFAULT_PRESET);
+        const gap = (_c = props.gap) !== null && _c !== void 0 ? _c : defaults_1.DEFAULT_GAP;
+        // Public padding is currently symmetric number; resolve to per-side pixels
+        const padPx = (0, defaults_1.resolvePadding)(props.padding);
+        // Convert px → fraction relative to THIS chart's canvas (ctx.target — the
+        // slot when nested), not ctx.output (the top-level envelope), so padding is
+        // correct when the chart is composed into a smaller cell.
+        const padding = {
+            top: padPx.top / ctx.target.height,
+            bottom: padPx.bottom / ctx.target.height,
+            left: padPx.left / ctx.target.width,
+            right: padPx.right / ctx.target.width,
+        };
+        const cornerRadius = (_d = props.cornerRadius) !== null && _d !== void 0 ? _d : defaults_1.DEFAULT_CORNER_RADIUS;
+        const track = (0, defaults_1.resolveTrack)(props.track);
+        const grid = (0, defaults_1.resolveGrid)(props.grid);
+        const baseline = (0, defaults_1.resolveBaseline)(props.baseline);
+        const valueAxis = (0, defaults_1.resolveValueAxis)(props.valueAxis);
+        const valueLabels = (0, defaults_1.resolveValueLabels)(props.valueLabels);
+        const anim = (0, defaults_1.resolveAnim)(props.anim);
+        const values = props.values;
+        // 3) Domain computation.
+        //
+        // When the caller passes minValue / maxValue EXPLICITLY we honor them
+        // exactly — the chart shows the data on the user's chosen scale.
+        //
+        // When EITHER bound is auto-derived (the common case for the canonical
+        // primitive), apply the "nice numbers" axis algorithm so axis ticks land
+        // on round values (0/20/40/60/80/100) rather than exact domain fractions
+        // (0/17/34/51/68/85). Bars are then scaled to the NICE max, so the data
+        // sits below the top of the plot — matching standard chart convention
+        // and visually distinguishing axis-scale numbers from per-bar values.
+        const rawMin = (_e = props.minValue) !== null && _e !== void 0 ? _e : 0;
+        const rawMax = (_f = props.maxValue) !== null && _f !== void 0 ? _f : Math.max(...values);
+        const explicitDomain = props.minValue != null && props.maxValue != null;
+        let minValue = rawMin;
+        let maxValue = rawMax;
+        let effectiveGridCount = grid.count;
+        if (!explicitDomain) {
+            const nice = (0, format_1.niceAxis)(rawMin, rawMax, grid.count + 1);
+            minValue = nice.min;
+            maxValue = nice.max;
+            // Nice algorithm may shift the tick count slightly (e.g. asks for 6,
+            // returns 5 or 7) — keep the grid in lockstep so gridlines align with
+            // ticks.
+            effectiveGridCount = Math.max(1, nice.ticks.length - 1);
+        }
+        // Production note: handle max==min gracefully (all values equal).
+        const denom = maxValue - minValue;
+        const fractions = values.map((v) => (denom === 0 ? 1 : (v - minValue) / denom));
+        // Grid lines and tick rail must agree on count; the nice axis may have
+        // adjusted it. Plot-area + labels both read this resolved count.
+        const effectiveGrid = effectiveGridCount === grid.count
+            ? grid
+            : { ...grid, count: effectiveGridCount };
+        // 4) Render the internal tree (top-down)
+        //
+        // NOTE:
+        // - We render internal templates using renderNestedTemplate.
+        // - Internals are referenced by ID; they are not exported publicly.
+        //
+        // Children refs for the final doc:
+        const children = {};
+        // BarsStack
+        children["bars-stack"] = await (0, template_utils_1.renderNestedTemplate)("@m0saic/charts/bar-graph/internal/bars-stack/v1", {
+            axisConfig,
+            values,
+            fractions,
+            minValue,
+            maxValue,
+            barColor: (_g = props.barColor) !== null && _g !== void 0 ? _g : "#f97316",
+            gap,
+            barThickness: props.barThickness,
+            highlightIndex: props.highlightIndex,
+            track,
+            valueLabels,
+            labels: props.labels,
+            anim,
+            cornerRadius,
+        }, ctx);
+        // PlotArea
+        children["plot-area"] = await (0, template_utils_1.renderNestedTemplate)("@m0saic/charts/bar-graph/internal/plot-area/v1", {
+            axisConfig,
+            grid: effectiveGrid,
+            baseline,
+            valueAxis,
+            barsStackRef: "bars-stack",
+        }, ctx);
+        // Labels (content layout) — composes title-band + plot-area-ref + label-band
+        // + value-axis tick rail into the chart's m0 banded layout. Sits INSIDE
+        // ChartFrame; not a sibling overlay.
+        children["labels"] = await (0, template_utils_1.renderNestedTemplate)("@m0saic/charts/bar-graph/internal/labels/v1", {
+            axisConfig,
+            title: props.title,
+            subtitle: props.subtitle,
+            labels: props.labels,
+            values,
+            minValue,
+            maxValue,
+            padding,
+            gap,
+            preset,
+            valueLabels,
+            gridCount: effectiveGridCount,
+            showValueTicks: effectiveGrid.show,
+            plotAreaRef: "plot-area",
+        }, ctx);
+        // ChartFrame: card surface + content (labels) overlay inset by padding.
+        // The `plotAreaRef` prop name is historical — it now references the
+        // content composition (Labels), which itself embeds the plot area.
+        children["chart-frame"] = await (0, template_utils_1.renderNestedTemplate)("@m0saic/charts/bar-graph/internal/chart-frame/v1", {
+            padding,
+            cornerRadius,
+            preset,
+            plotAreaRef: "labels",
+        }, ctx);
+        // 5) Top-level document is a single source: the chart-frame.
+        return {
+            kind: "mosaic_document",
+            version: 1,
+            assets: {},
+            m0: (0, dsl_stdlib_1.toM0String)("F", "BarGraph"),
+            children,
+            sources: [{ type: "mosaic", ref: "chart-frame" }],
+        };
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.ChartsBarGraph);

package/dist/m0saic/charts/bar-graph/v1/defaults.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ============================================================================
+ * @m0saic/charts/bar-graph — Defaults + Canonical Tokens
+ * ============================================================================
+ *
+ * RESPONSIBILITY:
+ *   Central home for:
+ *   - Default props for the HERO bar graph
+ *   - Canonical design tokens (per preset)
+ *   - “Resolved props” helpers used by the top-level template
+ *
+ * WHY THIS FILE EXISTS:
+ *   Production templates become unmaintainable if defaults are duplicated
+ *   across barGraph.ts + internal templates.
+ *
+ * CANONICAL RULES:
+ *   - Public props are permissive; internals should receive RESOLVED values.
+ *   - Any union types in public props (like Padding, barColor being single vs array)
+ *     should be normalized here or in the top-level template via helpers from here.
+ *
+ * WHAT THIS FILE SHOULD NOT DO:
+ *   - No rendering
+ *   - No FFmpeg expression math (that belongs in bar-fill)
+ *   - No template registration
+ * ============================================================================
+ */
+import type { AnimConfig, BarGraphPreset, BaselineConfig, GridConfig, Orientation, Padding, ResolvedPadding, TrackConfig, ValueLabelsConfig } from "./types";
+import type { MosaicColor } from "@m0saic/types";
+/**
+ * In production, each preset becomes a real “theme token pack”:
+ * background colors, text colors, grid opacity, track opacity, etc.
+ *
+ * For scaffold: keep it small. The production comment blocks explain what
+ * should be added later.
+ */
+export type BarGraphPresetTokens = {
+    barColor: MosaicColor;
+};
+export declare const PRESET_TOKENS: Record<BarGraphPreset, BarGraphPresetTokens>;
+export declare const DEFAULT_ORIENTATION: Orientation;
+export declare const DEFAULT_GAP = 18;
+/**
+ * Default padding: symmetric, but we keep it in Resolved form because internals
+ * should not deal with unions.
+ */
+export declare const DEFAULT_PADDING: ResolvedPadding;
+/** Geometric radius fraction (0..1). See RoundingOptions.borderRadius. */
+export declare const DEFAULT_CORNER_RADIUS = 0.15;
+export declare const DEFAULT_TRACK: TrackConfig;
+export declare const DEFAULT_GRID: GridConfig;
+export declare const DEFAULT_BASELINE: BaselineConfig;
+export declare const DEFAULT_VALUE_AXIS: BaselineConfig;
+export declare const DEFAULT_VALUE_LABELS: ValueLabelsConfig;
+export declare const DEFAULT_ANIM: AnimConfig;
+export declare const DEFAULT_PRESET: BarGraphPreset;
+/**
+ * Resolve public padding input into canonical ResolvedPadding.
+ *
+ * PRODUCTION NOTE:
+ *   In production you might also adjust padding based on:
+ *   - title/subtitle presence
+ *   - labelDock rules
+ *   - whether value labels are on
+ *   But that logic should still live centrally (here or in top-level render),
+ *   not scattered across internals.
+ */
+export declare function resolvePadding(padding: Padding | undefined): ResolvedPadding;
+/**
+ * Resolve which “base bar color” to use when the user passes a single color
+ * or nothing. If user supplies an array, we keep it as-is (handled later).
+ */
+export declare function resolveBaseBarColor(opts: {
+    preset: BarGraphPreset;
+    barColor?: MosaicColor | MosaicColor[];
+}): MosaicColor;
+/**
+ * Resolve child configs with defaults. Kept shallow on purpose.
+ *
+ * RULE:
+ *   Avoid deep-merge magic. Be explicit about what you merge so props remain
+ *   predictable and learnable.
+ */
+export declare function resolveTrack(track?: Partial<TrackConfig>): TrackConfig;
+export declare function resolveGrid(grid?: Partial<GridConfig>): GridConfig;
+export declare function resolveBaseline(baseline?: Partial<BaselineConfig>): BaselineConfig;
+export declare function resolveValueAxis(axis?: Partial<BaselineConfig>): BaselineConfig;
+export declare function resolveValueLabels(valueLabels?: Partial<ValueLabelsConfig>): ValueLabelsConfig;
+export declare function resolveAnim(anim?: Partial<AnimConfig>): AnimConfig;

package/dist/m0saic/charts/bar-graph/v1/defaults.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * ============================================================================
+ * @m0saic/charts/bar-graph — Defaults + Canonical Tokens
+ * ============================================================================
+ *
+ * RESPONSIBILITY:
+ *   Central home for:
+ *   - Default props for the HERO bar graph
+ *   - Canonical design tokens (per preset)
+ *   - “Resolved props” helpers used by the top-level template
+ *
+ * WHY THIS FILE EXISTS:
+ *   Production templates become unmaintainable if defaults are duplicated
+ *   across barGraph.ts + internal templates.
+ *
+ * CANONICAL RULES:
+ *   - Public props are permissive; internals should receive RESOLVED values.
+ *   - Any union types in public props (like Padding, barColor being single vs array)
+ *     should be normalized here or in the top-level template via helpers from here.
+ *
+ * WHAT THIS FILE SHOULD NOT DO:
+ *   - No rendering
+ *   - No FFmpeg expression math (that belongs in bar-fill)
+ *   - No template registration
+ * ============================================================================
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PRESET = exports.DEFAULT_ANIM = exports.DEFAULT_VALUE_LABELS = exports.DEFAULT_VALUE_AXIS = exports.DEFAULT_BASELINE = exports.DEFAULT_GRID = exports.DEFAULT_TRACK = exports.DEFAULT_CORNER_RADIUS = exports.DEFAULT_PADDING = exports.DEFAULT_GAP = exports.DEFAULT_ORIENTATION = exports.PRESET_TOKENS = void 0;
+exports.resolvePadding = resolvePadding;
+exports.resolveBaseBarColor = resolveBaseBarColor;
+exports.resolveTrack = resolveTrack;
+exports.resolveGrid = resolveGrid;
+exports.resolveBaseline = resolveBaseline;
+exports.resolveValueAxis = resolveValueAxis;
+exports.resolveValueLabels = resolveValueLabels;
+exports.resolveAnim = resolveAnim;
+exports.PRESET_TOKENS = {
+    neutral: { barColor: "#111827" },
+    dark: { barColor: "#f9fafb" },
+    terminal: { barColor: "#22c55e" },
+    glass: { barColor: "#60a5fa" },
+    paper: { barColor: "#0f172a" },
+};
+// ---------------------------------------------------------------------------
+// Default config blocks
+// ---------------------------------------------------------------------------
+exports.DEFAULT_ORIENTATION = "vertical";
+exports.DEFAULT_GAP = 18;
+/**
+ * Default padding: symmetric, but we keep it in Resolved form because internals
+ * should not deal with unions.
+ */
+exports.DEFAULT_PADDING = {
+    top: 72,
+    right: 72,
+    bottom: 72,
+    left: 72,
+};
+/** Geometric radius fraction (0..1). See RoundingOptions.borderRadius. */
+exports.DEFAULT_CORNER_RADIUS = 0.15;
+exports.DEFAULT_TRACK = {
+    show: true,
+};
+exports.DEFAULT_GRID = {
+    show: true,
+    count: 5,
+};
+exports.DEFAULT_BASELINE = {
+    show: true,
+};
+exports.DEFAULT_VALUE_AXIS = {
+    show: true,
+};
+exports.DEFAULT_VALUE_LABELS = {
+    show: true,
+    format: "compact",
+    decimals: 0,
+    suffix: "",
+};
+exports.DEFAULT_ANIM = {
+    intro: {
+        durationSec: 1.1,
+        delaySec: 0.1,
+        staggerSec: 0.06,
+        ease: "smoothstep",
+    },
+    reduceMotion: false,
+};
+exports.DEFAULT_PRESET = "neutral";
+// ---------------------------------------------------------------------------
+// Helpers: resolve padding + shallow merge blocks
+// ---------------------------------------------------------------------------
+/**
+ * Resolve public padding input into canonical ResolvedPadding.
+ *
+ * PRODUCTION NOTE:
+ *   In production you might also adjust padding based on:
+ *   - title/subtitle presence
+ *   - labelDock rules
+ *   - whether value labels are on
+ *   But that logic should still live centrally (here or in top-level render),
+ *   not scattered across internals.
+ */
+function resolvePadding(padding) {
+    if (typeof padding === "number") {
+        return { top: padding, right: padding, bottom: padding, left: padding };
+    }
+    if (padding && typeof padding === "object") {
+        return {
+            top: padding.top,
+            right: padding.right,
+            bottom: padding.bottom,
+            left: padding.left,
+        };
+    }
+    return exports.DEFAULT_PADDING;
+}
+/**
+ * Resolve which “base bar color” to use when the user passes a single color
+ * or nothing. If user supplies an array, we keep it as-is (handled later).
+ */
+function resolveBaseBarColor(opts) {
+    const { preset, barColor } = opts;
+    if (typeof barColor === "string")
+        return barColor;
+    return exports.PRESET_TOKENS[preset].barColor;
+}
+/**
+ * Resolve child configs with defaults. Kept shallow on purpose.
+ *
+ * RULE:
+ *   Avoid deep-merge magic. Be explicit about what you merge so props remain
+ *   predictable and learnable.
+ */
+function resolveTrack(track) {
+    return { ...exports.DEFAULT_TRACK, ...(track !== null && track !== void 0 ? track : {}) };
+}
+function resolveGrid(grid) {
+    return { ...exports.DEFAULT_GRID, ...(grid !== null && grid !== void 0 ? grid : {}) };
+}
+function resolveBaseline(baseline) {
+    return { ...exports.DEFAULT_BASELINE, ...(baseline !== null && baseline !== void 0 ? baseline : {}) };
+}
+function resolveValueAxis(axis) {
+    return { ...exports.DEFAULT_VALUE_AXIS, ...(axis !== null && axis !== void 0 ? axis : {}) };
+}
+function resolveValueLabels(valueLabels) {
+    return { ...exports.DEFAULT_VALUE_LABELS, ...(valueLabels !== null && valueLabels !== void 0 ? valueLabels : {}) };
+}
+function resolveAnim(anim) {
+    var _a, _b;
+    // Note: intro is nested; keep this explicit so we don’t accidentally drop fields.
+    const intro = { ...exports.DEFAULT_ANIM.intro, ...((_a = anim === null || anim === void 0 ? void 0 : anim.intro) !== null && _a !== void 0 ? _a : {}) };
+    const reduceMotion = (_b = anim === null || anim === void 0 ? void 0 : anim.reduceMotion) !== null && _b !== void 0 ? _b : exports.DEFAULT_ANIM.reduceMotion;
+    return { intro, reduceMotion };
+}

package/dist/m0saic/charts/bar-graph/v1/format.d.ts

@@ -0,0 +1,46 @@
+/**
+ * ============================================================================
+ * @m0saic/charts/bar-graph — Value label formatting
+ * ============================================================================
+ *
+ * Pure formatters for the three canonical value-label modes.
+ *   - "raw":     value.toFixed(decimals)
+ *   - "percent": ((value / max) * 100).toFixed(decimals) + "%"
+ *   - "compact": k/M/B/T suffix notation, e.g. 1500 → "1.5K", 2.3e9 → "2.3B"
+ *
+ * No side effects, no template registration, no rendering — these run inside
+ * any internal that needs to display a value.
+ * ============================================================================
+ */
+import type { ValueLabelFormat } from "./types";
+export type FormatDomain = {
+    /** Domain max — used to compute percentage (value / max * 100). */
+    max?: number;
+};
+export declare function formatValue(value: number, format: ValueLabelFormat, decimals: number, domain?: FormatDomain, suffix?: string): string;
+export type NiceAxis = {
+    /** Lower bound of the axis (rounded down to a multiple of step). */
+    min: number;
+    /** Upper bound of the axis (rounded up to a multiple of step). */
+    max: number;
+    /** Step between adjacent ticks (a "nice" value: 1, 2, or 5 × 10^k). */
+    step: number;
+    /** Tick values from min → max, inclusive. Length = (max - min) / step + 1. */
+    ticks: number[];
+};
+/**
+ * Compute a "nice" axis (round-number ticks) covering [min..max] with
+ * approximately `targetTickCount` ticks. Returns `min`, `max`, `step`, and
+ * the full tick list min → max. The resulting axis is guaranteed to contain
+ * the input range (niceMin ≤ min, niceMax ≥ max).
+ *
+ * Example: niceAxis(0, 85, 6) → { min: 0, max: 100, step: 20,
+ *   ticks: [0, 20, 40, 60, 80, 100] }.
+ *
+ * @param min Raw lower bound.
+ * @param max Raw upper bound.
+ * @param targetTickCount Desired tick count including both endpoints.
+ *                         The actual count may differ slightly so the step
+ *                         stays a nice round number.
+ */
+export declare function niceAxis(min: number, max: number, targetTickCount: number): NiceAxis;