@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/kpi/MicroKpiSubtitle.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `micro-kpi-subtitle` (annex §1) — the inline header micro-KPI line recomputed
+ * from live state ("3 unread · 10 total", "24 members · 8 online", "N connected ·
+ * 12 available"). `placement: 'inline'`, so it renders in a page-header slot
+ * rather than a grid cell and never carries WidgetFrame chrome.
+ *
+ * The sentence is a stored TEMPLATE with `{placeholder}` tokens resolved against
+ * the bound scalars — see `interpolateTemplate` in `kpi-lib` for why an unknown
+ * token degrades to the empty string rather than leaking `{token}` into the UI.
+ */
+import { MonoText } from '@adminium/ui';
+import { formatOptionsOf } from '../../lib/format.js';
+import { interpolateTemplate } from './kpi-lib.js';
+// Config schema + deterministic demo payload live in the pure `kpi-config`
+// module so the registry metadata graph never reaches this component file
+// (04 §2.3). Re-exported here to keep existing import points stable.
+export { microKpiSubtitleConfigSchema, microKpiSubtitleDemoData } from './kpi-config.js';
+/**
+ * Every scalar the payload carries, flattened for template interpolation. The
+ * annex's contract is "1–3 derived scalars over a sibling `record-list`" — the
+ * host compiles them into a `single-metric` envelope whose sibling keys are the
+ * other scalars, so any number/string column is addressable by name.
+ */
+export function scalarsOf(data) {
+    if (typeof data !== 'object' || data === null || Array.isArray(data))
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === 'number' && Number.isFinite(value))
+            out[key] = value;
+        else if (typeof value === 'string')
+            out[key] = value;
+    }
+    return out;
+}
+export function MicroKpiSubtitle({ config, data }) {
+    const scalars = scalarsOf(data);
+    const zero = scalars[config.zeroKey];
+    const isZero = typeof zero === 'number' && zero === 0;
+    const text = isZero && config.zeroStateText !== undefined
+        ? config.zeroStateText
+        : interpolateTemplate(config.template, scalars, config.metricFormat, formatOptionsOf(config));
+    return (_jsx(MonoText, { "data-widget": "micro-kpi-subtitle", "data-zero": isZero, className: "truncate text-caption text-fg-muted", children: text }));
+}
+//# sourceMappingURL=MicroKpiSubtitle.js.map

package/dist/families/kpi/MicroKpiSubtitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicroKpiSubtitle.js","sourceRoot":"","sources":["../../../src/families/kpi/MicroKpiSubtitle.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKnD,2EAA2E;AAC3E,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGzF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAChF,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aACrE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAuC;IACpF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC,CAAC;IAEtD,MAAM,IAAI,GACR,MAAM,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS;QAC1C,CAAC,CAAC,MAAM,CAAC,aAAa;QACtB,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAElG,OAAO,CACL,KAAC,QAAQ,mBACK,oBAAoB,eACrB,MAAM,EACjB,SAAS,EAAC,qCAAqC,YAE9C,IAAI,GACI,CACZ,CAAC;AACJ,CAAC"}

package/dist/families/kpi/PeriodComparison.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `period-comparison` (annex §1) — two labeled progress bars (this period vs
+ * last) with a computed diff footer ("+$13.1k (37.3%) higher"). Renders only the
+ * loaded state — skeleton/empty/error are WidgetFrame's job.
+ *
+ * SHAPE: the annex's "two `single-metric` values for adjacent windows" IS the
+ * `metric+delta` envelope (`value` = this window, `prior` = last), so the shared
+ * `computeDelta` produces the footer figure — no bespoke shape, and the
+ * "down-is-good" inversion behaves identically to `kpi-stat-card`.
+ *
+ * Both bars are scaled against the LARGER of the two values, not each against
+ * itself: the comparison is the whole point, so the shorter bar must actually
+ * read as shorter.
+ */
+import type { PeriodComparisonConfig } from './kpi-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { periodComparisonConfigSchema, periodComparisonDemoData } from './kpi-config.js';
+export type { PeriodComparisonConfig } from './kpi-config.js';
+export declare function PeriodComparison({ config, data }: WidgetProps<PeriodComparisonConfig>): import("react").JSX.Element;
+//# sourceMappingURL=PeriodComparison.d.ts.map

package/dist/families/kpi/PeriodComparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeriodComparison.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/PeriodComparison.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AA0B9D,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAsDrF"}

package/dist/families/kpi/PeriodComparison.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `period-comparison` (annex §1) — two labeled progress bars (this period vs
+ * last) with a computed diff footer ("+$13.1k (37.3%) higher"). Renders only the
+ * loaded state — skeleton/empty/error are WidgetFrame's job.
+ *
+ * SHAPE: the annex's "two `single-metric` values for adjacent windows" IS the
+ * `metric+delta` envelope (`value` = this window, `prior` = last), so the shared
+ * `computeDelta` produces the footer figure — no bespoke shape, and the
+ * "down-is-good" inversion behaves identically to `kpi-stat-card`.
+ *
+ * Both bars are scaled against the LARGER of the two values, not each against
+ * itself: the comparison is the whole point, so the shorter bar must actually
+ * read as shorter.
+ */
+import { MonoText, ProgressBar } from '@adminium/ui';
+import { computeDelta, formatMetricValue, formatOptionsOf } from '../../lib/format.js';
+import { asMetricDelta } from '../../lib/shapes.js';
+// Config schema + deterministic demo payload live in the pure `kpi-config`
+// module so the registry metadata graph never reaches this component file
+// (04 §2.3). Re-exported here to keep existing import points stable.
+export { periodComparisonConfigSchema, periodComparisonDemoData } from './kpi-config.js';
+function Bar({ label, text, value, max, tone, }) {
+    return (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsxs("div", { className: "flex items-baseline justify-between gap-2", children: [_jsx("span", { className: "truncate text-caption text-fg-muted", children: label }), _jsx(MonoText, { className: "shrink-0 text-body-sm font-semibold text-fg", children: text })] }), _jsx(ProgressBar, { value: value, max: max, tone: tone, size: "md", label: `${label}: ${text}` })] }));
+}
+export function PeriodComparison({ config, data }) {
+    const metric = asMetricDelta(data);
+    if (metric === null) {
+        return _jsx("p", { className: "px-4 pb-4 text-body-sm text-fg-muted", children: "Unexpected data shape." });
+    }
+    const opts = formatOptionsOf(config);
+    const current = metric.value;
+    const prior = metric.prior ?? 0;
+    // Scale both bars against the larger value so the comparison reads visually.
+    const max = Math.max(Math.abs(current), Math.abs(prior)) || 1;
+    const delta = computeDelta(metric, 'abs', config.metricFormat, opts);
+    const pct = computeDelta(metric, 'pct', config.metricFormat, opts);
+    const direction = delta === null || delta.trend === 'flat'
+        ? (config.flatLabel ?? 'flat')
+        : delta.trend === 'up'
+            ? (config.higherLabel ?? 'higher')
+            : (config.lowerLabel ?? 'lower');
+    // Tone follows "is this good", not "is this up" — invertDeltaGood flips it
+    // for costs / error rates / churn, exactly as the delta pill does.
+    const good = delta === null || delta.trend === 'flat' ? null : config.invertDeltaGood ? delta.trend === 'down' : delta.trend === 'up';
+    const footerTone = good === null ? 'text-fg-muted' : good ? 'text-pos' : 'text-danger';
+    return (_jsxs("div", { className: "flex h-full flex-col justify-center gap-3 px-4 pb-4 compact:gap-2 compact:px-3 compact:pb-3", "data-widget": "period-comparison", "data-trend": delta?.trend ?? 'flat', children: [_jsx(Bar, { label: config.periodALabel ?? 'This period', text: formatMetricValue(current, config.metricFormat, opts), value: Math.abs(current), max: max, tone: "accent" }), _jsx(Bar, { label: config.periodBLabel ?? 'Last period', text: formatMetricValue(prior, config.metricFormat, opts), value: Math.abs(prior), max: max, tone: "neutral" }), delta === null ? null : (_jsxs("p", { "data-part": "diff-footer", className: `truncate text-caption font-semibold ${footerTone}`, children: [_jsx(MonoText, { children: delta.text }), pct === null ? '' : _jsx(MonoText, { children: ` (${pct.text})` }), ` ${direction}`] }))] }));
+}
+//# sourceMappingURL=PeriodComparison.js.map

package/dist/families/kpi/PeriodComparison.js.map

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

package/dist/families/kpi/StatPairCard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `stat-pair-card` (annex §1) — two large mono metrics side by side with a
+ * vertical divider (MRR / LTV, where LTV may be a derived formula over MRR).
+ * Renders only the loaded state — skeleton/empty/error are WidgetFrame's job.
+ *
+ * RTL: the divider is a logical `border-s` on the second column, so the pair
+ * genuinely swaps sides under `dir="rtl"` and the rule lands between them either
+ * way. `flex` handles the ordering; nothing here is physically positioned.
+ */
+import type { StatPairCardConfig } from './kpi-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { statPairCardConfigSchema, statPairCardDemoData } from './kpi-config.js';
+export type { StatPairCardConfig } from './kpi-config.js';
+/** Read a numeric scalar off the payload by configured field name (04 §5). */
+export declare function scalarAt(data: unknown, field: string): number | null;
+/**
+ * The two sides of the pair. Side B is the derived formula's result when one is
+ * configured, else the payload's `valueBField`. Either side may be null — an
+ * unbound column renders an em-dash rather than "NaN".
+ */
+export declare function statPairValues(data: unknown, config: Pick<StatPairCardConfig, 'valueAField' | 'valueBField' | 'derivedFormula' | 'derivedOperand'>): {
+    a: number | null;
+    b: number | null;
+};
+export declare function StatPairCard({ config, data }: WidgetProps<StatPairCardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=StatPairCard.d.ts.map

package/dist/families/kpi/StatPairCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatPairCard.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/StatPairCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC,GACpG;IAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMxC;AAaD,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,kBAAkB,CAAC,+BAuB7E"}

package/dist/families/kpi/StatPairCard.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `stat-pair-card` (annex §1) — two large mono metrics side by side with a
+ * vertical divider (MRR / LTV, where LTV may be a derived formula over MRR).
+ * Renders only the loaded state — skeleton/empty/error are WidgetFrame's job.
+ *
+ * RTL: the divider is a logical `border-s` on the second column, so the pair
+ * genuinely swaps sides under `dir="rtl"` and the rule lands between them either
+ * way. `flex` handles the ordering; nothing here is physically positioned.
+ */
+import { MonoText } from '@adminium/ui';
+import { formatMetricValue, formatOptionsOf } from '../../lib/format.js';
+import { applyDerived } from './kpi-lib.js';
+// Config schema + deterministic demo payload live in the pure `kpi-config`
+// module so the registry metadata graph never reaches this component file
+// (04 §2.3). Re-exported here to keep existing import points stable.
+export { statPairCardConfigSchema, statPairCardDemoData } from './kpi-config.js';
+/** Read a numeric scalar off the payload by configured field name (04 §5). */
+export function scalarAt(data, field) {
+    if (typeof data !== 'object' || data === null)
+        return null;
+    const raw = data[field];
+    if (typeof raw === 'number' && Number.isFinite(raw))
+        return raw;
+    if (typeof raw === 'string' && raw.trim() !== '' && Number.isFinite(Number(raw)))
+        return Number(raw);
+    return null;
+}
+/**
+ * The two sides of the pair. Side B is the derived formula's result when one is
+ * configured, else the payload's `valueBField`. Either side may be null — an
+ * unbound column renders an em-dash rather than "NaN".
+ */
+export function statPairValues(data, config) {
+    const a = scalarAt(data, config.valueAField);
+    if (config.derivedFormula !== 'none') {
+        return { a, b: a === null ? null : applyDerived(a, config.derivedFormula, config.derivedOperand) };
+    }
+    return { a, b: scalarAt(data, config.valueBField) };
+}
+function Side({ label, value }) {
+    return (_jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [label === undefined ? null : _jsx("p", { className: "truncate text-body-sm text-fg-muted", children: label }), _jsx(MonoText, { className: "block truncate text-[24px] font-bold leading-tight text-fg compact:text-[20px]", children: value })] }));
+}
+export function StatPairCard({ config, data }) {
+    const { a, b } = statPairValues(data, config);
+    if (a === null && b === null) {
+        return _jsx("p", { className: "px-4 pb-4 text-body-sm text-fg-muted", children: "Unexpected data shape." });
+    }
+    const opts = formatOptionsOf(config);
+    const textA = a === null ? '—' : formatMetricValue(a, config.metricAFormat, opts);
+    const textB = b === null ? '—' : formatMetricValue(b, config.metricBFormat, opts);
+    return (_jsxs("div", { className: "flex h-full items-center gap-4 px-4 pb-4 compact:gap-3 compact:px-3 compact:pb-3", "data-widget": "stat-pair-card", "data-derived": config.derivedFormula, children: [_jsx(Side, { label: config.metricALabel, value: textA }), _jsx("div", { className: "flex min-w-0 flex-1 border-s border-border ps-4 compact:ps-3", children: _jsx(Side, { label: config.metricBLabel, value: textB }) })] }));
+}
+//# sourceMappingURL=StatPairCard.js.map

package/dist/families/kpi/StatPairCard.js.map

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

package/dist/families/kpi/UsageMeter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `usage-meter` — quota-consumption card (annex §1): label, "used of
+ * limit" mono text, horizontal progress bar; bar and caption flip to
+ * warn/danger tones past the thresholds. Powers billing quotas, storage
+ * and AI-credit sidebars.
+ */
+import type { UsageMeterConfig } from './kpi-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { usageMeterConfigSchema, usageMeterDemoData } from './kpi-config.js';
+export type { UsageMeterConfig } from './kpi-config.js';
+export declare function UsageMeter({ config, data, onEvent }: WidgetProps<UsageMeterConfig>): import("react").JSX.Element;
+//# sourceMappingURL=UsageMeter.d.ts.map

package/dist/families/kpi/UsageMeter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageMeter.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/UsageMeter.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BA+ClF"}

package/dist/families/kpi/UsageMeter.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `usage-meter` — quota-consumption card (annex §1): label, "used of
+ * limit" mono text, horizontal progress bar; bar and caption flip to
+ * warn/danger tones past the thresholds. Powers billing quotas, storage
+ * and AI-credit sidebars.
+ */
+import { MonoText, ProgressBar } from '@adminium/ui';
+import { formatMetricValue, formatOptionsOf } from '../../lib/format.js';
+import { asSingleMetric } from '../../lib/shapes.js';
+// Config schema + deterministic demo payload live in the pure `kpi-config`
+// module so the registry metadata graph never reaches this component file
+// (04 §2.3). Re-exported here to keep existing import points stable.
+export { usageMeterConfigSchema, usageMeterDemoData } from './kpi-config.js';
+export function UsageMeter({ config, data, onEvent }) {
+    const metric = asSingleMetric(data);
+    if (metric === null) {
+        return _jsx("p", { className: "px-4 pb-4 text-body-sm text-fg-muted", children: "Unexpected data shape." });
+    }
+    const opts = formatOptionsOf(config);
+    const used = metric.value;
+    const limit = config.limit;
+    const pct = limit > 0 ? (used / limit) * 100 : 0;
+    const tone = pct >= config.dangerThreshold ? 'danger' : pct >= config.warnThreshold ? 'warn' : 'accent';
+    const unit = config.unit ?? metric.unit;
+    const usedText = formatMetricValue(used, 'compact', opts);
+    const limitText = formatMetricValue(limit, 'compact', opts);
+    const label = config.title ?? 'Usage';
+    return (_jsxs("div", { className: `flex h-full flex-col justify-center gap-2 px-4 pb-4 ${config.compact ? 'gap-1.5 px-3 pb-3' : ''}`, "data-widget": "usage-meter", "data-tone": tone, children: [_jsxs("div", { className: "flex items-baseline justify-between gap-2", children: [_jsx("span", { className: "truncate text-body-sm text-fg-muted", children: label }), _jsxs(MonoText, { className: "shrink-0 text-body-sm font-semibold text-fg", children: [usedText, " ", _jsx("span", { className: "font-normal text-fg-muted", children: "of" }), " ", limitText, unit === undefined ? '' : ` ${unit}`] })] }), _jsx(ProgressBar, { value: Math.min(used, limit), max: limit, tone: tone, size: config.compact ? 'sm' : 'md', label: `${label}: ${usedText} of ${limitText}${unit === undefined ? '' : ` ${unit}`}` }), config.ctaLabel !== undefined && config.ctaHref !== undefined && !config.compact && (_jsx("button", { type: "button", className: "self-start text-body-sm font-medium text-accent hover:underline", onClick: () => onEvent({ type: 'drill-through', href: config.ctaHref }), children: config.ctaLabel }))] }));
+}
+//# sourceMappingURL=UsageMeter.js.map

package/dist/families/kpi/UsageMeter.js.map

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

package/dist/families/kpi/components.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `kpi` family component barrel — the single lazy-import target of this
+ * family's definitions, so Vite emits one chunk for the whole family
+ * (04 §2.3). The ONLY module in the family that imports component code:
+ * `definitions.ts` reaches it exclusively through `lazy(() => import(...))`,
+ * which keeps the @adminium/ui-heavy widgets out of the registry's eager graph
+ * (enforced by `qa/chunk-budget.test.ts`).
+ */
+export { KpiStatCard } from './KpiStatCard.js';
+export { UsageMeter } from './UsageMeter.js';
+export { KpiStatTileCompact } from './KpiStatTileCompact.js';
+export { MetricHero } from './MetricHero.js';
+export { StatPairCard } from './StatPairCard.js';
+export { GaugeRing } from './GaugeRing.js';
+export { GaugeArc } from './GaugeArc.js';
+export { PeriodComparison } from './PeriodComparison.js';
+export { MicroKpiSubtitle } from './MicroKpiSubtitle.js';
+export { AutoInsights } from './AutoInsights.js';
+//# sourceMappingURL=components.d.ts.map

package/dist/families/kpi/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/components.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/families/kpi/components.js

@@ -0,0 +1,19 @@
+/**
+ * `kpi` family component barrel — the single lazy-import target of this
+ * family's definitions, so Vite emits one chunk for the whole family
+ * (04 §2.3). The ONLY module in the family that imports component code:
+ * `definitions.ts` reaches it exclusively through `lazy(() => import(...))`,
+ * which keeps the @adminium/ui-heavy widgets out of the registry's eager graph
+ * (enforced by `qa/chunk-budget.test.ts`).
+ */
+export { KpiStatCard } from './KpiStatCard.js';
+export { UsageMeter } from './UsageMeter.js';
+export { KpiStatTileCompact } from './KpiStatTileCompact.js';
+export { MetricHero } from './MetricHero.js';
+export { StatPairCard } from './StatPairCard.js';
+export { GaugeRing } from './GaugeRing.js';
+export { GaugeArc } from './GaugeArc.js';
+export { PeriodComparison } from './PeriodComparison.js';
+export { MicroKpiSubtitle } from './MicroKpiSubtitle.js';
+export { AutoInsights } from './AutoInsights.js';
+//# sourceMappingURL=components.js.map

package/dist/families/kpi/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../src/families/kpi/components.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/families/kpi/definitions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `kpi` family definitions — the COMPLETE annex §1 slice (10 ids). The M4-T06
+ * wave landed `kpi-stat-card` + `usage-meter`; M7 Wave 4 (TRACK KPI-FEEDS)
+ * closes the family out with the remaining eight.
+ *
+ * Metadata only in this file: the config schemas and demo generators come from
+ * the pure `kpi-config` module, and component code lives in sibling files
+ * reached through the `components.ts` barrel via `lazy()`, so Vite emits one
+ * chunk for the whole family (04 §2.3) and the registry's static graph never
+ * pulls the components in (enforced by `qa/chunk-budget.test.ts`).
+ *
+ * Grid sizing per the annex, stored in half-row units (04 §6.1:
+ * `h = round(annexRows × 2)`) — annex "3×1.5" ⇒ `defaultH: 3`. Widths map 1:1.
+ *
+ * `capabilities.exportPng` marks the widgets whose loaded body is a raster-able
+ * canvas (the stat card's spark, the hero, the two SVG gauges) — §7.6's export
+ * pipeline picks them up via their `data-export-node` roots.
+ */
+import type { WidgetDefinition } from '../../registry/types.js';
+export { autoInsightsDemoData, gaugeArcDemoData, gaugeRingDemoData, kpiStatCardDemoData, kpiStatTileCompactDemoData, metricHeroDemoData, microKpiSubtitleDemoData, periodComparisonDemoData, statPairCardDemoData, usageMeterDemoData, } from './kpi-config.js';
+export declare const kpiWidgetDefinitions: readonly WidgetDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/families/kpi/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA2BH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAqI3D,CAAC"}

package/dist/families/kpi/definitions.js

@@ -0,0 +1,159 @@
+/**
+ * `kpi` family definitions — the COMPLETE annex §1 slice (10 ids). The M4-T06
+ * wave landed `kpi-stat-card` + `usage-meter`; M7 Wave 4 (TRACK KPI-FEEDS)
+ * closes the family out with the remaining eight.
+ *
+ * Metadata only in this file: the config schemas and demo generators come from
+ * the pure `kpi-config` module, and component code lives in sibling files
+ * reached through the `components.ts` barrel via `lazy()`, so Vite emits one
+ * chunk for the whole family (04 §2.3) and the registry's static graph never
+ * pulls the components in (enforced by `qa/chunk-budget.test.ts`).
+ *
+ * Grid sizing per the annex, stored in half-row units (04 §6.1:
+ * `h = round(annexRows × 2)`) — annex "3×1.5" ⇒ `defaultH: 3`. Widths map 1:1.
+ *
+ * `capabilities.exportPng` marks the widgets whose loaded body is a raster-able
+ * canvas (the stat card's spark, the hero, the two SVG gauges) — §7.6's export
+ * pipeline picks them up via their `data-export-node` roots.
+ */
+import { lazy } from 'react';
+import { autoInsightsConfigSchema, autoInsightsDemoData, gaugeArcConfigSchema, gaugeArcDemoData, gaugeRingConfigSchema, gaugeRingDemoData, kpiStatCardConfigSchema, kpiStatCardDemoData, kpiStatTileCompactConfigSchema, kpiStatTileCompactDemoData, metricHeroConfigSchema, metricHeroDemoData, microKpiSubtitleConfigSchema, microKpiSubtitleDemoData, periodComparisonConfigSchema, periodComparisonDemoData, statPairCardConfigSchema, statPairCardDemoData, usageMeterConfigSchema, usageMeterDemoData, } from './kpi-config.js';
+import { defineWidget } from '../../registry/types.js';
+// The demo generators live in `kpi-config`; re-exported so story/test import
+// points against this module stay stable.
+export { autoInsightsDemoData, gaugeArcDemoData, gaugeRingDemoData, kpiStatCardDemoData, kpiStatTileCompactDemoData, metricHeroDemoData, microKpiSubtitleDemoData, periodComparisonDemoData, statPairCardDemoData, usageMeterDemoData, } from './kpi-config.js';
+export const kpiWidgetDefinitions = [
+    defineWidget({
+        id: 'kpi-stat-card',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).KpiStatCard })),
+        configSchema: kpiStatCardConfigSchema,
+        dataContract: 'metric+delta',
+        sizing: { minW: 3, minH: 2, defaultW: 3, defaultH: 3 }, // annex "min 3×1, default 3×1.5"
+        placement: 'grid',
+        skeleton: 'card',
+        capabilities: { exportPng: true },
+        demoData: kpiStatCardDemoData,
+        descriptionKey: 'widgets.kpi.statCard.description',
+    }),
+    defineWidget({
+        id: 'usage-meter',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).UsageMeter })),
+        configSchema: usageMeterConfigSchema,
+        dataContract: 'single-metric',
+        sizing: { minW: 3, minH: 2, defaultW: 3, defaultH: 2 }, // annex "min 3×1, default 3×1"
+        placement: 'grid',
+        skeleton: 'card',
+        demoData: usageMeterDemoData,
+        descriptionKey: 'widgets.kpi.usageMeter.description',
+    }),
+    defineWidget({
+        id: 'kpi-stat-tile-compact',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).KpiStatTileCompact })),
+        configSchema: kpiStatTileCompactConfigSchema,
+        dataContract: 'metric+delta',
+        sizing: { minW: 2, minH: 2, defaultW: 2, defaultH: 2 }, // annex "min 2×1, default 2×1"
+        placement: 'grid',
+        skeleton: 'card',
+        capabilities: { exportPng: true },
+        demoData: kpiStatTileCompactDemoData,
+        descriptionKey: 'widgets.kpi.statTileCompact.description',
+    }),
+    defineWidget({
+        id: 'metric-hero',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).MetricHero })),
+        configSchema: metricHeroConfigSchema,
+        dataContract: 'metric+delta',
+        sizing: { minW: 4, minH: 4, defaultW: 4, defaultH: 4 }, // annex "min 4×2, default 4×2"
+        placement: 'grid',
+        skeleton: 'card',
+        capabilities: { exportPng: true },
+        demoData: metricHeroDemoData,
+        descriptionKey: 'widgets.kpi.metricHero.description',
+    }),
+    defineWidget({
+        id: 'stat-pair-card',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).StatPairCard })),
+        configSchema: statPairCardConfigSchema,
+        dataContract: 'single-metric', // annex "two `single-metric` values" — one envelope, two keys
+        sizing: { minW: 3, minH: 2, defaultW: 3, defaultH: 2 }, // annex "min 3×1, default 3×1"
+        placement: 'grid',
+        skeleton: 'card',
+        demoData: statPairCardDemoData,
+        descriptionKey: 'widgets.kpi.statPairCard.description',
+    }),
+    defineWidget({
+        id: 'gauge-ring',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).GaugeRing })),
+        configSchema: gaugeRingConfigSchema,
+        dataContract: 'single-metric',
+        sizing: { minW: 3, minH: 4, defaultW: 3, defaultH: 4 }, // annex "min 3×2, default 3×2"
+        placement: 'grid',
+        skeleton: 'chart',
+        capabilities: { exportPng: true },
+        demoData: gaugeRingDemoData,
+        descriptionKey: 'widgets.kpi.gaugeRing.description',
+    }),
+    defineWidget({
+        id: 'gauge-arc',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).GaugeArc })),
+        configSchema: gaugeArcConfigSchema,
+        // annex §1: `single-metric` score for the speedometer; `categorical` list of
+        // {label, pct, tone} in cluster mode. `cluster` is config, so both are
+        // accepted and the component reads whichever it is configured for (04 §3).
+        dataContract: ['single-metric', 'categorical'],
+        sizing: { minW: 3, minH: 4, defaultW: 6, defaultH: 4 }, // annex "single min 3×2; cluster min 4×2, default 6×2"
+        placement: 'grid',
+        skeleton: 'chart',
+        capabilities: { exportPng: true },
+        demoData: gaugeArcDemoData,
+        descriptionKey: 'widgets.kpi.gaugeArc.description',
+    }),
+    defineWidget({
+        id: 'period-comparison',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).PeriodComparison })),
+        configSchema: periodComparisonConfigSchema,
+        // annex "two `single-metric` values for adjacent windows" = the
+        // `metric+delta` envelope (value = this window, prior = last).
+        dataContract: 'metric+delta',
+        sizing: { minW: 3, minH: 2, defaultW: 3, defaultH: 3 }, // annex "min 3×1, default 3×1.5"
+        placement: 'grid',
+        skeleton: 'card',
+        demoData: periodComparisonDemoData,
+        descriptionKey: 'widgets.kpi.periodComparison.description',
+    }),
+    defineWidget({
+        id: 'micro-kpi-subtitle',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).MicroKpiSubtitle })),
+        configSchema: microKpiSubtitleConfigSchema,
+        // annex "1–3 derived scalars over a sibling record-list" — the host compiles
+        // them into one `single-metric` envelope whose sibling keys are the scalars.
+        dataContract: 'single-metric',
+        sizing: { minW: 2, minH: 1, defaultW: 3, defaultH: 1 }, // annex "inline (page header slot)"
+        placement: 'inline',
+        skeleton: 'block',
+        demoData: microKpiSubtitleDemoData,
+        descriptionKey: 'widgets.kpi.microKpiSubtitle.description',
+    }),
+    defineWidget({
+        id: 'auto-insights',
+        family: 'kpi',
+        component: lazy(async () => ({ default: (await import('./components.js')).AutoInsights })),
+        configSchema: autoInsightsConfigSchema,
+        dataContract: 'record-list',
+        sizing: { minW: 4, minH: 4, defaultW: 6, defaultH: 4 }, // annex "min 4×2, default 6×2"
+        placement: 'grid',
+        skeleton: 'list',
+        demoData: autoInsightsDemoData,
+        descriptionKey: 'widgets.kpi.autoInsights.description',
+    }),
+];
+//# sourceMappingURL=definitions.js.map

package/dist/families/kpi/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/families/kpi/definitions.ts"],"names":[],"mappings":"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"}