@chenzy-design/core 0.1.0

package/dist/calendar.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+import { eventCoversDay, eventsForDay, groupEventsByDays, timelineForDay, dayKey, isPastDay, } from './calendar.js';
+const d = (y, m, day, h = 0) => new Date(y, m, day, h);
+const events = [
+    { key: 'a', start: d(2026, 5, 10, 9), title: '会议 A' },
+    { key: 'b', start: d(2026, 5, 10, 14), title: '会议 B' },
+    { key: 'c', start: d(2026, 5, 10, 8), title: '全天 C', allDay: true },
+    { key: 'd', start: d(2026, 5, 10), end: d(2026, 5, 12), title: '跨天 D' },
+    { key: 'e', start: d(2026, 5, 20), title: '会议 E' },
+];
+describe('eventCoversDay', () => {
+    it('matches a same-day event', () => {
+        expect(eventCoversDay(events[0], d(2026, 5, 10))).toBe(true);
+        expect(eventCoversDay(events[0], d(2026, 5, 11))).toBe(false);
+    });
+    it('matches every day a multi-day event spans (inclusive)', () => {
+        const md = events[3];
+        expect(eventCoversDay(md, d(2026, 5, 10))).toBe(true);
+        expect(eventCoversDay(md, d(2026, 5, 11))).toBe(true);
+        expect(eventCoversDay(md, d(2026, 5, 12))).toBe(true);
+        expect(eventCoversDay(md, d(2026, 5, 13))).toBe(false);
+    });
+});
+describe('eventsForDay', () => {
+    it('collects all events on a day, all-day first then by start time', () => {
+        const day = eventsForDay(events, d(2026, 5, 10));
+        expect(day.total.map((e) => e.key)).toEqual(['c', 'd', 'a', 'b']);
+        // c is allDay → first; d has start 00:00 → before a(09:00); a before b(14:00)
+        expect(day.overflow).toBe(0);
+    });
+    it('caps to maxPerDay and reports overflow', () => {
+        const day = eventsForDay(events, d(2026, 5, 10), 2);
+        expect(day.visible.map((e) => e.key)).toEqual(['c', 'd']);
+        expect(day.overflow).toBe(2);
+    });
+    it('returns empty for a day with no events', () => {
+        const day = eventsForDay(events, d(2026, 5, 1));
+        expect(day.total).toEqual([]);
+        expect(day.overflow).toBe(0);
+    });
+});
+describe('groupEventsByDays', () => {
+    it('builds an O(1) lookup map keyed by day', () => {
+        const days = [d(2026, 5, 10), d(2026, 5, 11), d(2026, 5, 20)];
+        const map = groupEventsByDays(events, days, 3);
+        expect(map.get(dayKey(d(2026, 5, 10)))?.total.length).toBe(4);
+        expect(map.get(dayKey(d(2026, 5, 11)))?.total.map((e) => e.key)).toEqual(['d']);
+        expect(map.get(dayKey(d(2026, 5, 20)))?.total.map((e) => e.key)).toEqual(['e']);
+    });
+});
+describe('timelineForDay', () => {
+    it('buckets timed events by their start hour, sorted by start time', () => {
+        const tl = timelineForDay(events, d(2026, 5, 10));
+        // a@09 and b@14 are timed; c is allDay; d is multi-day starting same day 00:00
+        expect(tl.byHour.get(9)?.map((e) => e.key)).toEqual(['a']);
+        expect(tl.byHour.get(14)?.map((e) => e.key)).toEqual(['b']);
+        expect(tl.byHour.get(0)?.map((e) => e.key)).toEqual(['d']); // 00:00 start
+    });
+    it('puts all-day events into the allDay bucket', () => {
+        const tl = timelineForDay(events, d(2026, 5, 10));
+        expect(tl.allDay.map((e) => e.key)).toEqual(['c']);
+    });
+    it('routes multi-day events to allDay on continuation days (start on another day)', () => {
+        const tl = timelineForDay(events, d(2026, 5, 11));
+        // event d covers the 11th but starts on the 10th → all-day on the 11th
+        expect(tl.allDay.map((e) => e.key)).toEqual(['d']);
+        expect([...tl.byHour.keys()]).toEqual([]);
+    });
+    it('clamps event hours into the visible from/to range', () => {
+        const late = [{ key: 'z', start: d(2026, 5, 10, 22), title: '深夜' }];
+        const tl = timelineForDay(late, d(2026, 5, 10), 8, 18);
+        expect(tl.byHour.get(18)?.map((e) => e.key)).toEqual(['z']);
+    });
+    it('returns empty buckets for a day with no events', () => {
+        const tl = timelineForDay(events, d(2026, 5, 1));
+        expect(tl.allDay).toEqual([]);
+        expect(tl.byHour.size).toBe(0);
+    });
+});
+describe('isPastDay', () => {
+    it('compares at day granularity', () => {
+        const today = d(2026, 5, 15, 12);
+        expect(isPastDay(d(2026, 5, 14), today)).toBe(true);
+        expect(isPastDay(d(2026, 5, 15, 23), today)).toBe(false); // same day
+        expect(isPastDay(d(2026, 5, 16), today)).toBe(false);
+    });
+});
+//# sourceMappingURL=calendar.test.js.map

package/dist/calendar.test.js.map

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

package/dist/cascader.d.ts

@@ -0,0 +1,64 @@
+/**
+ * cascader — framework-agnostic pure helpers for the Cascader render layer.
+ * ZERO framework deps. Only pure data → data transforms (red line #2):
+ * - flattenCascaderPaths: tree → flat selectable paths (leaf, or all levels)
+ * - filterCascaderPaths:  query + predicate → matched flat paths
+ * - resolveColumnWidth:   columnWidth prop (number | number[]) → per-column px
+ * See specs/components/input/Cascader.spec.md §4.
+ */
+export type CascaderKey = string | number;
+/** Minimal node shape consumed by the pure helpers (label/value/children). */
+export interface CascaderPathNode {
+    label: string;
+    value: CascaderKey;
+    disabled?: boolean;
+    children?: CascaderPathNode[];
+}
+/** A fully-resolved selectable path through the tree. */
+export interface CascaderFlatPath<N extends CascaderPathNode = CascaderPathNode> {
+    /** value keys from root → this node */
+    values: CascaderKey[];
+    /** labels from root → this node */
+    labels: string[];
+    /** node chain from root → this node */
+    nodes: N[];
+    /** whether this path ends on a leaf (no children) */
+    isLeaf: boolean;
+    /** disabled if any node along the path is disabled */
+    disabled: boolean;
+}
+/** Predicate for custom search matching: (query, flat path) → matched. */
+export type CascaderFilterFn<N extends CascaderPathNode = CascaderPathNode> = (query: string, path: CascaderFlatPath<N>) => boolean;
+/**
+ * Flatten a tree into selectable paths.
+ * - `includeNonLeaf=false` (default): only leaf paths.
+ * - `includeNonLeaf=true`: every level's path (for changeOnSelect).
+ * `childrenOf` lets the caller fold in async-loaded children without mutating
+ * the source tree. Disabled flags propagate down the chain.
+ */
+export declare function flattenCascaderPaths<N extends CascaderPathNode>(data: N[], options?: {
+    includeNonLeaf?: boolean;
+    childrenOf?: (node: N) => N[] | undefined;
+}): CascaderFlatPath<N>[];
+/**
+ * Filter flat paths by a query.
+ * - `filter === false`: no matches ([]).
+ * - `filter === true`: default substring match on the joined label chain
+ *   (case-insensitive), honoring `separator`.
+ * - `filter` is a function: custom predicate per path.
+ * `leafOnly` (default true) restricts the default-match result to leaf paths.
+ * An empty/blank query yields [] (caller decides to show columns instead).
+ */
+export declare function filterCascaderPaths<N extends CascaderPathNode>(paths: CascaderFlatPath<N>[], query: string, filter: boolean | CascaderFilterFn<N>, options?: {
+    separator?: string;
+    leafOnly?: boolean;
+}): CascaderFlatPath<N>[];
+/**
+ * Resolve per-column widths from the `columnWidth` prop.
+ * - `number`: uniform width for all columns.
+ * - `number[]`: per-column; columns past the array length fall back to the last
+ *   entry (or `fallback` if the array is empty).
+ * Returns the width (px) for column `index`.
+ */
+export declare function resolveColumnWidth(columnWidth: number | number[] | undefined, index: number, fallback?: number): number;
+//# sourceMappingURL=cascader.d.ts.map

package/dist/cascader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascader.d.ts","sourceRoot":"","sources":["../src/cascader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAC7E,uCAAuC;IACvC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAC5E,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KACtB,OAAO,CAAC;AAEb;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC;CACtC,GACL,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAyBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,EAC5D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,EACrC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAavB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,SAAM,GACb,MAAM,CAKR"}

package/dist/cascader.js

@@ -0,0 +1,79 @@
+/**
+ * cascader — framework-agnostic pure helpers for the Cascader render layer.
+ * ZERO framework deps. Only pure data → data transforms (red line #2):
+ * - flattenCascaderPaths: tree → flat selectable paths (leaf, or all levels)
+ * - filterCascaderPaths:  query + predicate → matched flat paths
+ * - resolveColumnWidth:   columnWidth prop (number | number[]) → per-column px
+ * See specs/components/input/Cascader.spec.md §4.
+ */
+/**
+ * Flatten a tree into selectable paths.
+ * - `includeNonLeaf=false` (default): only leaf paths.
+ * - `includeNonLeaf=true`: every level's path (for changeOnSelect).
+ * `childrenOf` lets the caller fold in async-loaded children without mutating
+ * the source tree. Disabled flags propagate down the chain.
+ */
+export function flattenCascaderPaths(data, options = {}) {
+    const { includeNonLeaf = false, childrenOf } = options;
+    const out = [];
+    const walk = (nodes, values, labels, chain, parentDisabled) => {
+        for (const n of nodes) {
+            const kids = (childrenOf ? childrenOf(n) : n.children) ?? undefined;
+            const isLeaf = !kids || kids.length === 0;
+            const nv = [...values, n.value];
+            const nl = [...labels, n.label];
+            const nc = [...chain, n];
+            const dis = parentDisabled || !!n.disabled;
+            if (isLeaf || includeNonLeaf) {
+                out.push({ values: nv, labels: nl, nodes: nc, isLeaf, disabled: dis });
+            }
+            if (!isLeaf)
+                walk(kids, nv, nl, nc, dis);
+        }
+    };
+    walk(data, [], [], [], false);
+    return out;
+}
+/**
+ * Filter flat paths by a query.
+ * - `filter === false`: no matches ([]).
+ * - `filter === true`: default substring match on the joined label chain
+ *   (case-insensitive), honoring `separator`.
+ * - `filter` is a function: custom predicate per path.
+ * `leafOnly` (default true) restricts the default-match result to leaf paths.
+ * An empty/blank query yields [] (caller decides to show columns instead).
+ */
+export function filterCascaderPaths(paths, query, filter, options = {}) {
+    if (filter === false)
+        return [];
+    const q = query.trim();
+    if (q.length === 0)
+        return [];
+    const { separator = ' / ', leafOnly = true } = options;
+    if (typeof filter === 'function') {
+        return paths.filter((p) => filter(q, p));
+    }
+    const lower = q.toLowerCase();
+    return paths.filter((p) => {
+        if (leafOnly && !p.isLeaf)
+            return false;
+        return p.labels.join(separator).toLowerCase().includes(lower);
+    });
+}
+/**
+ * Resolve per-column widths from the `columnWidth` prop.
+ * - `number`: uniform width for all columns.
+ * - `number[]`: per-column; columns past the array length fall back to the last
+ *   entry (or `fallback` if the array is empty).
+ * Returns the width (px) for column `index`.
+ */
+export function resolveColumnWidth(columnWidth, index, fallback = 180) {
+    if (columnWidth === undefined)
+        return fallback;
+    if (typeof columnWidth === 'number')
+        return columnWidth;
+    if (columnWidth.length === 0)
+        return fallback;
+    return columnWidth[index] ?? columnWidth[columnWidth.length - 1];
+}
+//# sourceMappingURL=cascader.js.map

package/dist/cascader.js.map

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

package/dist/cascader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cascader.test.d.ts.map

package/dist/cascader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascader.test.d.ts","sourceRoot":"","sources":["../src/cascader.test.ts"],"names":[],"mappings":""}

package/dist/cascader.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect } from 'vitest';
+import { flattenCascaderPaths, filterCascaderPaths, resolveColumnWidth, } from './cascader.js';
+const tree = [
+    {
+        label: '浙江',
+        value: 'zj',
+        children: [
+            {
+                label: '杭州',
+                value: 'hz',
+                children: [
+                    { label: '西湖', value: 'xh' },
+                    { label: '余杭', value: 'yh', disabled: true },
+                ],
+            },
+        ],
+    },
+    {
+        label: '江苏',
+        value: 'js',
+        disabled: true,
+        children: [{ label: '南京', value: 'nj', children: [{ label: '玄武', value: 'xw' }] }],
+    },
+];
+describe('flattenCascaderPaths', () => {
+    it('collects only leaf paths by default', () => {
+        const paths = flattenCascaderPaths(tree);
+        expect(paths.map((p) => p.values.join('/'))).toEqual([
+            'zj/hz/xh',
+            'zj/hz/yh',
+            'js/nj/xw',
+        ]);
+        expect(paths.every((p) => p.isLeaf)).toBe(true);
+    });
+    it('includes non-leaf paths when requested (changeOnSelect)', () => {
+        const paths = flattenCascaderPaths(tree, { includeNonLeaf: true });
+        expect(paths.map((p) => p.values.join('/'))).toContain('zj');
+        expect(paths.map((p) => p.values.join('/'))).toContain('zj/hz');
+    });
+    it('propagates disabled down the chain', () => {
+        const paths = flattenCascaderPaths(tree);
+        const yh = paths.find((p) => p.values.at(-1) === 'yh');
+        const xw = paths.find((p) => p.values.at(-1) === 'xw');
+        expect(yh?.disabled).toBe(true); // own disabled
+        expect(xw?.disabled).toBe(true); // inherited from 江苏
+    });
+    it('folds in async children via childrenOf without mutating source', () => {
+        const lazy = [{ label: 'A', value: 'a' }];
+        const extra = new Map([
+            ['a', [{ label: 'B', value: 'b' }]],
+        ]);
+        const paths = flattenCascaderPaths(lazy, {
+            childrenOf: (n) => n.children ?? extra.get(n.value),
+        });
+        expect(paths.map((p) => p.values.join('/'))).toEqual(['a/b']);
+        expect(lazy[0].children).toBeUndefined();
+    });
+});
+describe('filterCascaderPaths', () => {
+    const flat = flattenCascaderPaths(tree, { includeNonLeaf: true });
+    it('returns [] when filter disabled', () => {
+        expect(filterCascaderPaths(flat, '杭', false)).toEqual([]);
+    });
+    it('returns [] for blank query', () => {
+        expect(filterCascaderPaths(flat, '   ', true)).toEqual([]);
+    });
+    it('default match is case-insensitive substring over the label chain', () => {
+        const r = filterCascaderPaths(flat, 'xh'.toUpperCase(), true);
+        // default leafOnly=true → only leaf paths
+        expect(r.length).toBe(0); // 'XH' not in labels (labels are chinese); sanity
+        const r2 = filterCascaderPaths(flat, '西湖', true);
+        expect(r2.map((p) => p.values.join('/'))).toEqual(['zj/hz/xh']);
+    });
+    it('respects custom separator in default match', () => {
+        const r = filterCascaderPaths(flat, '浙江>杭州', true, { separator: '>' });
+        expect(r.length).toBeGreaterThan(0);
+        const none = filterCascaderPaths(flat, '浙江 / 杭州', true, { separator: '>' });
+        expect(none.length).toBe(0);
+    });
+    it('leafOnly=false includes non-leaf matches', () => {
+        const r = filterCascaderPaths(flat, '杭州', true, { leafOnly: false });
+        expect(r.map((p) => p.values.join('/'))).toContain('zj/hz');
+    });
+    it('accepts a custom predicate', () => {
+        const r = filterCascaderPaths(flat, 'q', (_q, p) => p.values.at(-1) === 'nj');
+        expect(r.map((p) => p.values.join('/'))).toEqual(['js/nj']);
+    });
+});
+describe('resolveColumnWidth', () => {
+    it('returns fallback when undefined', () => {
+        expect(resolveColumnWidth(undefined, 0)).toBe(180);
+        expect(resolveColumnWidth(undefined, 2, 200)).toBe(200);
+    });
+    it('returns uniform width for a number', () => {
+        expect(resolveColumnWidth(220, 0)).toBe(220);
+        expect(resolveColumnWidth(220, 5)).toBe(220);
+    });
+    it('returns per-column width from an array, last entry past the end', () => {
+        expect(resolveColumnWidth([100, 200, 300], 0)).toBe(100);
+        expect(resolveColumnWidth([100, 200, 300], 1)).toBe(200);
+        expect(resolveColumnWidth([100, 200, 300], 9)).toBe(300);
+    });
+    it('falls back when the array is empty', () => {
+        expect(resolveColumnWidth([], 0, 150)).toBe(150);
+    });
+});
+//# sourceMappingURL=cascader.test.js.map

package/dist/cascader.test.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 颜色空间转换纯函数（framework-agnostic）。
+ * 红线 #2：转换为纯函数，渲染层只做格式化派生。
+ * 角度 h: 0-360；s/v/l/a: 0-1；r/g/b: 0-255。
+ */
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface Hsv {
+    h: number;
+    s: number;
+    v: number;
+    a: number;
+}
+export interface Hsl {
+    h: number;
+    s: number;
+    l: number;
+    a: number;
+}
+export type ColorFormat = 'hex' | 'rgb' | 'hsv' | 'hsl';
+export declare function clamp01(n: number): number;
+/** 解析 hex 字符串（#rgb / #rgba / #rrggbb / #rrggbbaa，带不带 # 均可）。失败返回 null。 */
+export declare function parseHex(input: string): Rgb | null;
+export interface RgbToHexOptions {
+    /** 输出是否包含 alpha 段（仅在 a<1 时）。默认 true。 */
+    alpha?: boolean;
+    /** 输出大写。默认 true。 */
+    uppercase?: boolean;
+}
+/** RGB → hex 字符串。 */
+export declare function rgbToHex(rgb: Rgb, options?: RgbToHexOptions): string;
+/** RGB → HSV。 */
+export declare function rgbToHsv(rgb: Rgb): Hsv;
+/** HSV → RGB。 */
+export declare function hsvToRgb({ h, s, v, a }: Hsv): Rgb;
+/** HSV → HSL（同一色相，转换 s/l）。 */
+export declare function hsvToHsl({ h, s, v, a }: Hsv): Hsl;
+/** HSL → HSV。 */
+export declare function hslToHsv({ h, s, l, a }: Hsl): Hsv;
+/** RGB → HSL（经 HSV 桥接）。 */
+export declare function rgbToHsl(rgb: Rgb): Hsl;
+/** HSL → RGB（经 HSV 桥接）。 */
+export declare function hslToRgb(hsl: Hsl): Rgb;
+/** hex → HSV。失败返回黑色不透明。 */
+export declare function hexToHsv(hex: string): Hsv;
+/** HSV → hex。 */
+export declare function hsvToHex(hsv: Hsv, options?: RgbToHexOptions): string;
+export interface FormatOptions {
+    /** 是否输出 alpha 段（hex 末尾 / rgba / hsva / hsla）。默认按 a<1 自动。 */
+    alpha?: boolean;
+    /** hex 输出大写。默认 true。 */
+    uppercase?: boolean;
+}
+/**
+ * 把 HSV 状态格式化为指定 format 的可读字符串（用于输入框显示）。
+ * rgb: rgb(r, g, b) / rgba(r, g, b, a)
+ * hsv: hsv(h, s%, v%) / hsva(h, s%, v%, a)
+ * hsl: hsl(h, s%, l%) / hsla(h, s%, l%, a)
+ */
+export declare function formatColor(hsv: Hsv, format: ColorFormat, options?: FormatOptions): string;
+/**
+ * 解析任意 format 的输入字符串为 HSV。失败返回 null（不改值）。
+ * 兼容 hex / rgb()/rgba() / hsv()/hsva() / hsl()/hsla()，逗号或空格分隔均可。
+ */
+export declare function parseColor(input: string, format: ColorFormat): Hsv | null;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAMD,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAyBlD;AAMD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAqB;AACrB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAKxE;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAkBtC;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAmBjD;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAIjD;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAIjD;AAED,2BAA2B;AAC3B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAEtC;AAED,2BAA2B;AAC3B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAEtC;AAED,2BAA2B;AAC3B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAIzC;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAEpE;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAiCR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,GAAG,GAAG,IAAI,CAwCzE"}