@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/kpi/kpi-config.d.ts.map

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

package/dist/families/kpi/kpi-config.js

@@ -0,0 +1,418 @@
+/**
+ * `kpi` family config schemas + deterministic demo generators — PURE module
+ * (zod, the shared config, and the @adminium/charts demo helpers only; no
+ * relative component imports, no React).
+ *
+ * WHY THIS EXISTS: `registry/index.ts` statically imports `definitions.ts`, so
+ * everything the definitions module imports lands in the registry's EAGER
+ * graph. While the schemas lived in `KpiStatCard.tsx` / `UsageMeter.tsx`, the
+ * definitions had to reach into those component modules to name them — which
+ * pulled the components and their @adminium/ui deps into the eager chunk and
+ * left the sibling `lazy(() => import('./components.js'))` refs buying nothing.
+ * Holding the schemas + demo payloads here (the boards/domain/media `*-config`
+ * convention) lets the definitions import metadata only, so the components stay
+ * reachable exclusively through the lazy `components.ts` barrel (04 §2.3,
+ * acceptance #3; enforced by `qa/chunk-budget.test.ts`).
+ *
+ * The component files re-export these symbols, so existing story/test import
+ * points stay stable.
+ */
+import { demoSparkline, mulberry32 } from '@adminium/charts';
+import { z } from 'zod';
+import { DEFAULT_GAUGE_BANDS, DERIVED_OPS, INSIGHT_ICONS } from './kpi-lib.js';
+import { widgetSharedConfigSchema } from '../../registry/shared-config.js';
+/** The annex §1 `format` vocabulary, shared by every metric-bearing kpi widget. */
+const metricFormatSchema = z.enum(['plain', 'compact', 'currency', 'percent', 'duration']);
+/** The annex §1 `deltaMode` vocabulary. */
+const deltaModeSchema = z.enum(['none', 'pct', 'abs']);
+/** The semantic tone vocabulary — bands/insights name a token, never a colour. */
+const toneSchema = z.enum(['neutral', 'accent', 'pos', 'warn', 'danger', 'info']);
+// ── kpi-stat-card (annex §1) ───────────────────────────────────────────────
+export const kpiStatCardConfigSchema = widgetSharedConfigSchema.extend({
+    /** Card label under the icon row (falls back to `title`). */
+    metricLabel: z.string().optional(),
+    /** Value formatting (annex §1 `format`). */
+    metricFormat: z.enum(['plain', 'compact', 'currency', 'percent', 'duration']).default('plain'),
+    deltaMode: z.enum(['none', 'pct', 'abs']).default('pct'),
+    /** Down-is-good (costs, error rates, churn) — flips the pill tones. */
+    invertDeltaGood: z.boolean().default(false),
+    showSparkline: z.boolean().default(true),
+    /** Curated Lucide tile icon (M4 set — full by-name lookup lands with the builder). */
+    iconName: z
+        .enum(['activity', 'dollar', 'users', 'cart', 'gauge', 'database', 'zap', 'star', 'package', 'trending'])
+        .default('activity'),
+    iconTone: z.enum(['neutral', 'accent', 'pos', 'warn', 'danger', 'info']).default('accent'),
+});
+/** Deterministic `metric+delta` demo payload (04 §7.7). */
+export function kpiStatCardDemoData(seed) {
+    const random = mulberry32(seed);
+    const value = Math.round(1200 + random() * 46_000);
+    const prior = Math.round(value * (0.72 + random() * 0.5));
+    return { value, prior, spark: demoSparkline(seed, 8) };
+}
+// ── usage-meter (annex §1) ─────────────────────────────────────────────────
+export const usageMeterConfigSchema = widgetSharedConfigSchema.extend({
+    /** The quota cap; the data payload carries only the used scalar. */
+    limit: z.number().positive().default(100),
+    /** Percent thresholds (annex §1 defaults). */
+    warnThreshold: z.number().min(0).max(100).default(80),
+    dangerThreshold: z.number().min(0).max(100).default(95),
+    unit: z.string().optional(),
+    ctaLabel: z.string().optional(),
+    ctaHref: z.string().optional(),
+    /** Sidebar mode: single line + slim bar. */
+    compact: z.boolean().default(false),
+});
+/** Deterministic `single-metric` demo payload against the default limit of 100. */
+export function usageMeterDemoData(seed) {
+    const random = mulberry32(seed);
+    return { value: Math.round(35 + random() * 60) };
+}
+// ── kpi-stat-tile-compact (annex §1) ───────────────────────────────────────
+export const kpiStatTileCompactConfigSchema = widgetSharedConfigSchema.extend({
+    /** Uppercase micro-label above the value (falls back to `title`). */
+    metricLabel: z.string().optional(),
+    metricFormat: metricFormatSchema.default('compact'),
+    deltaMode: deltaModeSchema.default('pct'),
+    /** Down-is-good (costs, error rates, churn) — flips the chip tones. */
+    invertDeltaGood: z.boolean().default(false),
+    /** The 22px 6-bar spark (annex §1). */
+    showSparkline: z.boolean().default(true),
+    /**
+     * Tiles per row in the dense "power" row (annex §1: 4–6). Advisory metadata
+     * for the generator's row packing — a single tile always fills its cell.
+     */
+    columns: z.number().int().min(4).max(6).default(6),
+});
+/** Deterministic `metric+delta` (+ `timeseries[6]`) demo payload (04 §7.7). */
+export function kpiStatTileCompactDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const value = Math.round(240 + random() * 9_600);
+    const prior = Math.round(value * (0.78 + random() * 0.42));
+    return { value, prior, spark: demoSparkline(seed, 6) };
+}
+// ── metric-hero (annex §1) ─────────────────────────────────────────────────
+export const metricHeroConfigSchema = widgetSharedConfigSchema.extend({
+    metricLabel: z.string().optional(),
+    metricFormat: metricFormatSchema.default('currency'),
+    deltaMode: deltaModeSchema.default('pct'),
+    invertDeltaGood: z.boolean().default(false),
+    /** Goal scalar; overrides the payload's `goal` when set (annex §1). */
+    goalValue: z.number().positive().optional(),
+    /** Goal track caption prefix, e.g. "Goal" → "Goal · $650k, 74%". */
+    goalLabel: z.string().optional(),
+    /** `requestAnimationFrame` count-up; forced off under reduced motion. */
+    countUp: z.boolean().default(true),
+    /** Spark bars rendered from the bound timeseries (annex §1 `sparkBars`). */
+    sparkBars: z.number().int().min(4).max(24).default(12),
+});
+/** Deterministic `metric+delta` + `timeseries` + goal demo payload (04 §7.7). */
+export function metricHeroDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const value = Math.round(180_000 + random() * 520_000);
+    const prior = Math.round(value * (0.7 + random() * 0.35));
+    // Goal sits above the current value so the track is partway, never complete.
+    const goal = Math.round(value * (1.15 + random() * 0.5));
+    return { value, prior, spark: demoSparkline(seed, 12), goal };
+}
+// ── stat-pair-card (annex §1) ──────────────────────────────────────────────
+export const statPairCardConfigSchema = widgetSharedConfigSchema.extend({
+    /** Side labels (annex §1 `metricA` / `metricB`). */
+    metricALabel: z.string().optional(),
+    metricBLabel: z.string().optional(),
+    /** Per-side formatting (annex §1 "format per side"). */
+    metricAFormat: metricFormatSchema.default('currency'),
+    metricBFormat: metricFormatSchema.default('currency'),
+    /**
+     * Derive side B from side A instead of reading it off the payload (annex §1:
+     * "second may be a formula over the first", e.g. LTV = MRR × lifetime).
+     * A closed enum, never an expression string — a stored config can never
+     * smuggle evaluable code into the renderer.
+     */
+    derivedFormula: z.enum(DERIVED_OPS).default('none'),
+    /** The right-hand operand of `derivedFormula`. */
+    derivedOperand: z.number().default(1),
+    // Field naming (04 §5) — which payload key carries each side.
+    valueAField: z.string().default('value'),
+    valueBField: z.string().default('valueB'),
+});
+/** Deterministic two-`single-metric` demo payload (04 §7.7). */
+export function statPairCardDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const value = Math.round(8_400 + random() * 62_000);
+    return { value, valueB: Math.round(value * (2.4 + random() * 3.2)) };
+}
+// ── gauge-ring + gauge-arc shared band config (annex §1) ───────────────────
+/**
+ * One qualitative gauge band (annex §1 `bands` [{to, color, label}]). `tone`
+ * names a semantic token rather than a colour so bands re-theme with the app
+ * (research/widget-registry.md Conventions: "CSS variables only").
+ */
+export const gaugeBandSchema = z.object({
+    /** Inclusive upper cutoff in the gauge's own value space (not a percent). */
+    to: z.number(),
+    tone: toneSchema,
+    label: z.string().optional(),
+});
+const defaultBands = () => DEFAULT_GAUGE_BANDS.map((band) => ({ ...band }));
+// ── gauge-ring (annex §1) ──────────────────────────────────────────────────
+export const gaugeRingConfigSchema = widgetSharedConfigSchema.extend({
+    max: z.number().positive().default(100),
+    bands: z.array(gaugeBandSchema).default(defaultBands),
+    /** Center readout: "73%" | "86" | "86/100" (annex §1 `centerFormat`). */
+    centerFormat: z.enum(['percent', 'value', 'fraction']).default('percent'),
+    /** Annex §1 `footer` (spent-of-total | avatar-stack | none). */
+    footer: z.enum(['none', 'spent-of-total', 'avatar-stack']).default('none'),
+    size: z.enum(['sm', 'md', 'lg']).default('md'),
+    /** Formatting for the footer's spent/total figures. */
+    metricFormat: metricFormatSchema.default('compact'),
+    /** Trend pill next to the footer figures (annex §1 "+ optional delta"). */
+    deltaMode: deltaModeSchema.default('none'),
+    invertDeltaGood: z.boolean().default(false),
+    /** Overrides the band label as the status caption under the center value. */
+    caption: z.string().optional(),
+    spentLabel: z.string().optional(),
+    totalLabel: z.string().optional(),
+});
+const RING_AVATARS = ['Ada Lovelace', 'Grace Hopper', 'Alan Turing', 'Katherine Johnson', 'Edsger Dijkstra'];
+/**
+ * Deterministic `single-metric` demo payload (04 §7.7) carrying the optional
+ * numerator/denominator + delta + avatar stack the annex's footer variants read.
+ */
+export function gaugeRingDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const value = Math.round(42 + random() * 56);
+    return {
+        value,
+        total: 100,
+        prior: Math.round(Math.min(100, Math.max(1, value * (0.75 + random() * 0.4)))),
+        avatars: RING_AVATARS.slice(0, 3 + Math.floor(random() * 3)).map((name) => name),
+    };
+}
+// ── gauge-arc (annex §1) ───────────────────────────────────────────────────
+export const gaugeArcConfigSchema = widgetSharedConfigSchema.extend({
+    max: z.number().positive().default(100),
+    bands: z.array(gaugeBandSchema).default(defaultBands),
+    /** Grid-of-gauges mode (annex §1: 2×2 / 5-up SLA + system-health clusters). */
+    cluster: z.boolean().default(false),
+    /** Columns in cluster mode (annex §1 `columns`). */
+    columns: z.number().int().min(1).max(5).default(2),
+    /** Draw the speedometer needle (off → a plain half-arc dasharray gauge). */
+    needle: z.boolean().default(true),
+    valueFormat: metricFormatSchema.default('plain'),
+    unit: z.string().optional(),
+    /**
+     * Per-widget empty copy (04 §4) for CLUSTER mode — the one shape this widget
+     * accepts that can legitimately be empty. The frame cannot route it there for
+     * us: the definition declares `['single-metric', 'categorical']`, and
+     * `isEmptyData` reads a multi-shape contract as empty only when EVERY shape
+     * does, while `isEmptyByShape['single-metric']` is `() => false` by design (a
+     * zero metric is data). So a cluster bound to an SLA query returning no rows
+     * arrives here in the `loaded` state and this widget owns the copy.
+     */
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const CLUSTER_SERVICES = [
+    'API gateway',
+    'Postgres primary',
+    'Job runner',
+    'Search index',
+    'CDN edge',
+];
+/**
+ * Deterministic demo payload satisfying BOTH accepted shapes at once (04 §7.7).
+ * `gauge-arc` declares `['single-metric', 'categorical']` because `cluster` is a
+ * CONFIG flag while `demoData(seed)` only sees the seed — so the payload carries
+ * `value` (single-metric, the speedometer) *and* `items` (categorical, the
+ * cluster grid), and the component reads whichever its config selects.
+ */
+export function gaugeArcDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const toneFor = (score) => (score <= 50 ? 'danger' : score <= 75 ? 'warn' : 'pos');
+    const items = CLUSTER_SERVICES.map((label, index) => {
+        const value = Math.round(38 + random() * 60);
+        return { key: `svc-${index + 1}`, label, value, tone: toneFor(value) };
+    });
+    return { value: Math.round(45 + random() * 54), items };
+}
+// ── period-comparison (annex §1) ───────────────────────────────────────────
+export const periodComparisonConfigSchema = widgetSharedConfigSchema.extend({
+    /** Bar labels for the two adjacent windows (annex §1 `periodA`/`periodB`). */
+    periodALabel: z.string().optional(),
+    periodBLabel: z.string().optional(),
+    metricFormat: metricFormatSchema.default('currency'),
+    /** Down-is-good — flips the footer's tone (costs, error rates, churn). */
+    invertDeltaGood: z.boolean().default(false),
+    /** Footer connectives, e.g. "higher" / "lower" / "vs". */
+    higherLabel: z.string().optional(),
+    lowerLabel: z.string().optional(),
+    flatLabel: z.string().optional(),
+});
+/**
+ * Deterministic `metric+delta` demo payload (04 §7.7) — the annex's "two
+ * `single-metric` values for adjacent windows" IS the `metric+delta` envelope
+ * (`value` = this period, `prior` = last), so the shared `computeDelta` produces
+ * the footer figure without a bespoke shape.
+ */
+export function periodComparisonDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const value = Math.round(12_000 + random() * 62_000);
+    return { value, prior: Math.round(value * (0.6 + random() * 0.55)) };
+}
+// ── micro-kpi-subtitle (annex §1) ──────────────────────────────────────────
+export const microKpiSubtitleConfigSchema = widgetSharedConfigSchema.extend({
+    /**
+     * Template with `{placeholder}` tokens resolved against the bound scalars
+     * (annex §1 `template`), e.g. "{value} unread · {total} total". An unknown
+     * token resolves to the empty string — a stored template that outlives its
+     * binding degrades to a shorter sentence, never to visible template syntax.
+     */
+    template: z.string().default('{value}'),
+    /** Shown instead of the template when `zeroKey`'s scalar is 0 (annex §1). */
+    zeroStateText: z.string().optional(),
+    /** Which scalar's 0 triggers `zeroStateText`. */
+    zeroKey: z.string().default('value'),
+    metricFormat: metricFormatSchema.default('plain'),
+});
+/**
+ * Deterministic `single-metric` demo payload (04 §7.7). The annex's contract is
+ * "1–3 derived scalars over a sibling `record-list`", so the envelope is a
+ * `single-metric` (`value`) carrying the sibling scalars the template reads.
+ */
+export function microKpiSubtitleDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const total = Math.round(12 + random() * 40);
+    return {
+        value: Math.round(random() * Math.min(9, total)),
+        total,
+        online: Math.round(1 + random() * (total - 1)),
+    };
+}
+// ── auto-insights (annex §1) ───────────────────────────────────────────────
+export const autoInsightsConfigSchema = widgetSharedConfigSchema.extend({
+    /** Insights visible at once (annex §1 `count`). */
+    count: z.number().int().min(1).max(8).default(3),
+    /** Show the Refresh control that rotates the visible window (annex §1). */
+    refreshable: z.boolean().default(true),
+    /** Rows kept in the rotation pool (annex §1 `pool` size). */
+    pool: z.number().int().min(1).max(24).default(9),
+    /** Bullet rows (Adminium UI Kit) vs the tone-icon card grid (Project Overview). */
+    variant: z.enum(['bullets', 'cards']).default('bullets'),
+    columns: z.number().int().min(1).max(3).default(2),
+    /** Per-insight CTA (annex §1 `applyAction`); omitted → no CTA. */
+    applyLabel: z.string().optional(),
+    refreshLabel: z.string().optional(),
+    // Field naming (04 §5) — which column carries what.
+    idField: z.string().default('id'),
+    iconField: z.string().default('icon'),
+    toneField: z.string().default('tone'),
+    tagField: z.string().default('tag'),
+    titleField: z.string().default('title'),
+    bodyField: z.string().default('body'),
+    sparkField: z.string().default('spark'),
+    hrefField: z.string().default('href'),
+    /** Ranking column — rows sort by it descending (stable when absent). */
+    scoreField: z.string().default('score'),
+});
+/**
+ * The seeded insight catalogue. The copy is authored here (and, in production,
+ * arrives through the binding) — `auto-insights` NEVER calls an LLM at render
+ * time: the annex's "AI-flavoured" framing describes where the sentences come
+ * from upstream, not a runtime dependency. The widget only ranks and renders.
+ */
+const INSIGHT_POOL = [
+    {
+        icon: 'trend-up',
+        tone: 'pos',
+        tag: 'Revenue',
+        title: 'MRR up 12.4% this month',
+        body: 'Expansion from existing accounts drove most of the lift; new logos held flat.',
+    },
+    {
+        icon: 'alert',
+        tone: 'danger',
+        tag: 'Churn',
+        title: '3 enterprise accounts at risk',
+        body: 'Weekly active seats fell by more than half across three accounts renewing in 30 days.',
+    },
+    {
+        icon: 'trend-down',
+        tone: 'warn',
+        tag: 'Performance',
+        title: 'p95 latency up 180ms',
+        body: 'The regression tracks the search index rebuild that started on the 9th.',
+    },
+    {
+        icon: 'target',
+        tone: 'accent',
+        tag: 'Pipeline',
+        title: '74% of the quarterly goal',
+        body: 'At the current run rate the target lands four days before quarter end.',
+    },
+    {
+        icon: 'zap',
+        tone: 'info',
+        tag: 'Usage',
+        title: 'API calls doubled week over week',
+        body: 'Two integrations account for the increase; neither is near its rate limit yet.',
+    },
+    {
+        icon: 'lightbulb',
+        tone: 'accent',
+        tag: 'Workload',
+        title: 'Rebalance three tickets off Priya',
+        body: 'Her queue is 40% above team median while two peers are under-allocated.',
+    },
+    {
+        icon: 'info',
+        tone: 'info',
+        tag: 'Data quality',
+        title: '412 rows missing a country code',
+        body: 'All of them were created by the legacy import job before the 3rd.',
+    },
+    {
+        icon: 'sparkles',
+        tone: 'pos',
+        tag: 'Conversion',
+        title: 'Checkout completion hit a 6-month high',
+        body: 'The shortened form is converting 8.1% better than the previous layout.',
+    },
+    {
+        icon: 'trend-down',
+        tone: 'warn',
+        tag: 'Support',
+        title: 'First-response time slipped to 4h 12m',
+        body: 'Ticket volume rose 22% while staffing stayed flat through the period.',
+    },
+];
+/**
+ * Deterministic `record-list` of ranked insights (04 §7.7). Every row carries a
+ * `score` so the widget's ranking is exercised, and a spark so the annex's
+ * "bold stat + sentence + mini sparkline" row has its third element.
+ */
+export function autoInsightsDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    // Walk the catalogue from a seeded offset rather than sampling with
+    // replacement, so no two visible insights repeat the same sentence.
+    const offset = Math.floor(random() * INSIGHT_POOL.length);
+    const count = 6 + Math.floor(random() * 4);
+    const rows = Array.from({ length: count }, (_, index) => {
+        const insight = INSIGHT_POOL[(offset + index) % INSIGHT_POOL.length];
+        return {
+            id: `insight-${index + 1}`,
+            icon: insight.icon,
+            tone: insight.tone,
+            tag: insight.tag,
+            title: insight.title,
+            body: insight.body,
+            score: Math.round(random() * 1000) / 10,
+            spark: demoSparkline(seed + index, 8),
+            href: `/p/insights/${index + 1}`,
+        };
+    });
+    return { rows, total: rows.length };
+}
+/** Re-exported so the definitions module's icon enum stays annex-anchored. */
+export { INSIGHT_ICONS };
+//# sourceMappingURL=kpi-config.js.map

package/dist/families/kpi/kpi-config.js.map

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

package/dist/families/kpi/kpi-icons.d.ts

@@ -0,0 +1,7 @@
+import type { ReactElement } from 'react';
+import type { InsightIcon } from './kpi-lib.js';
+/** The glyph for a narrowed insight icon key (`insightIconOf` guarantees the key). */
+export declare function insightIcon(icon: InsightIcon): ReactElement;
+/** The family's headline glyph — the auto-insights card header. */
+export declare function sparklesIcon(): ReactElement;
+//# sourceMappingURL=kpi-icons.d.ts.map

package/dist/families/kpi/kpi-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-icons.d.ts","sourceRoot":"","sources":["../../../src/families/kpi/kpi-icons.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqBhD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAE3D;AAED,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,YAAY,CAE3C"}

package/dist/families/kpi/kpi-icons.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AlertTriangle, Info, Lightbulb, Sparkles, Target, TrendingDown, TrendingUp, Zap, } from 'lucide-react';
+/**
+ * `kpi` family icon ELEMENTS (annex §1 `auto-insights`: sparkles glyph + the
+ * per-insight tone icon). Split out of `kpi-lib.ts` because that module is the
+ * PURE leaf the registry's eager metadata graph reaches through `kpi-config.ts`
+ * — JSX here would drag lucide-react into the eager chunk (04 §2.3). Only the
+ * component files import this.
+ */
+const INSIGHT_GLYPHS = {
+    sparkles: () => _jsx(Sparkles, {}),
+    'trend-up': () => _jsx(TrendingUp, {}),
+    'trend-down': () => _jsx(TrendingDown, {}),
+    alert: () => _jsx(AlertTriangle, {}),
+    info: () => _jsx(Info, {}),
+    target: () => _jsx(Target, {}),
+    zap: () => _jsx(Zap, {}),
+    lightbulb: () => _jsx(Lightbulb, {}),
+};
+/** The glyph for a narrowed insight icon key (`insightIconOf` guarantees the key). */
+export function insightIcon(icon) {
+    return INSIGHT_GLYPHS[icon]();
+}
+/** The family's headline glyph — the auto-insights card header. */
+export function sparklesIcon() {
+    return _jsx(Sparkles, {});
+}
+//# sourceMappingURL=kpi-icons.js.map

package/dist/families/kpi/kpi-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-icons.js","sourceRoot":"","sources":["../../../src/families/kpi/kpi-icons.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAU,EACV,GAAG,GACJ,MAAM,cAAc,CAAC;AAKtB;;;;;;GAMG;AAEH,MAAM,cAAc,GAA4C;IAC9D,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,KAAG;IAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,KAAC,UAAU,KAAG;IAChC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAC,YAAY,KAAG;IACpC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAC,aAAa,KAAG;IAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,KAAC,IAAI,KAAG;IACpB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,MAAM,KAAG;IACxB,GAAG,EAAE,GAAG,EAAE,CAAC,KAAC,GAAG,KAAG;IAClB,SAAS,EAAE,GAAG,EAAE,CAAC,KAAC,SAAS,KAAG;CAC/B,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAC,QAAQ,KAAG,CAAC;AACtB,CAAC"}