@pilotiq/pilotiq 0.1.0

package/dist/theme/resolve.js

@@ -0,0 +1,91 @@
+import { presets, PRESET_FONTS, PRESET_RADIUS, PRESET_SPACING } from './presets.js';
+import { baseColors } from './base-colors.js';
+import { resolveThemeColor } from './theme-colors.js';
+import { resolveChartColor } from './chart-colors.js';
+import { radiusMap } from './radius.js';
+import { spacingMap } from './spacing.js';
+/**
+ * Resolves a user-facing `ThemeConfig` into a serializable `ThemeMeta`.
+ *
+ * Layering order (each overrides the previous):
+ * 1. Preset (full variable set)
+ * 2. Base color (gray/neutral overrides)
+ * 3. Theme color (primary/ring overrides — `'base'` derives from base color)
+ * 4. Chart color (chart-1..5 ramp — `'base'` derives from base color)
+ * 5. Raw cssVariables escape hatch
+ */
+export function resolveTheme(config) {
+    // 1. Start with preset. Validate the name once so every downstream
+    //    preset-keyed lookup (PRESET_RADIUS, PRESET_SPACING, PRESET_FONTS) is
+    //    safe — bogus names from deserialized data fall through to 'vega'
+    //    instead of crashing with "Cannot read properties of undefined".
+    const requestedName = config.preset ?? 'vega';
+    const presetName = presets[requestedName] ? requestedName : 'vega';
+    const preset = presets[presetName];
+    const light = { ...preset.light };
+    const dark = { ...preset.dark };
+    // 2. Apply base color — always layered, defaulting to neutral so the
+    //    "default state" and an explicit `baseColor: 'neutral'` resolve to the
+    //    same tokens. Without this, the preset's hardcoded surface values
+    //    (e.g. WHITE for --background) would leak through whenever no base
+    //    color is selected, making the picker show "Neutral" while the actual
+    //    rendered colors didn't match a neutral selection.
+    const effectiveBase = config.baseColor ?? 'neutral';
+    const base = baseColors[effectiveBase];
+    Object.assign(light, base.light);
+    Object.assign(dark, base.dark);
+    // 3 + 4. Always apply theme + chart color (default to `'base'` sentinel).
+    // We default these so the editor's trigger ("Theme: Neutral", "Chart: Neutral")
+    // matches what the resolver actually renders. Otherwise the trigger would
+    // show "Neutral" but the preset's hardcoded primary/chart values would
+    // still leak through.
+    const themeColor = config.themeColor ?? 'base';
+    const tc = resolveThemeColor(themeColor, effectiveBase);
+    Object.assign(light, tc.light);
+    Object.assign(dark, tc.dark);
+    const chartColor = config.chartColor ?? 'base';
+    const cc = resolveChartColor(chartColor, effectiveBase);
+    Object.assign(light, cc.light);
+    Object.assign(dark, cc.dark);
+    // 5. Raw CSS variable overrides — highest priority escape hatch
+    if (config.cssVariables?.light)
+        Object.assign(light, config.cssVariables.light);
+    if (config.cssVariables?.dark)
+        Object.assign(dark, config.cssVariables.dark);
+    // Resolve radius — `'default'` (or undefined) routes through PRESET_RADIUS
+    // so each style can pick its own baseline (e.g. Maia = large). An explicit
+    // pick (none/small/medium/large) always wins over the preset default.
+    const isExplicit = config.radius && config.radius !== 'default';
+    const radiusKey = isExplicit ? config.radius : PRESET_RADIUS[presetName];
+    const radius = radiusMap[radiusKey];
+    // Resolve spacing density — same pattern as radius. Drives `--spacing`,
+    // which Tailwind v4 multiplies into every `p-*` / `gap-*` / `m-*` utility.
+    const isSpacingExplicit = config.spacing && config.spacing !== 'default';
+    const spacingKey = isSpacingExplicit ? config.spacing : PRESET_SPACING[presetName];
+    const spacing = spacingMap[spacingKey];
+    // Resolve fonts — fall through to the per-style font pairing in PRESET_FONTS.
+    // Field-level fallback (not object-level ??) so `fonts: { body: '...' }`
+    // doesn't accidentally drop the heading default.
+    const presetFonts = PRESET_FONTS[presetName];
+    const fonts = {
+        body: config.fonts?.body ?? presetFonts.body,
+        heading: config.fonts?.heading ?? presetFonts.heading,
+    };
+    const fontFamily = {};
+    if (fonts.heading)
+        fontFamily.heading = `'${fonts.heading}', system-ui, sans-serif`;
+    if (fonts.body)
+        fontFamily.body = `'${fonts.body}', system-ui, sans-serif`;
+    const result = {
+        light,
+        dark,
+        radius,
+        spacing,
+        iconLibrary: config.iconLibrary ?? 'lucide',
+    };
+    result.fonts = fonts;
+    if (Object.keys(fontFamily).length > 0)
+        result.fontFamily = fontFamily;
+    return result;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/theme/resolve.js.map

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

package/dist/theme/spacing.d.ts

@@ -0,0 +1,14 @@
+import type { SpacingPreset } from './types.js';
+/**
+ * Maps spacing density presets to Tailwind v4 `--spacing` values.
+ *
+ * Tailwind compiles every `p-*`, `gap-*`, `m-*` utility as
+ * `calc(var(--spacing) * N)`, so swapping this single token uniformly tightens
+ * or loosens every gap and padding in the panel — no per-component edits.
+ *
+ * `'default'` is the sentinel resolver; the picker shows it as the first
+ * option and falls through to `PRESET_SPACING[preset]`. `0.25rem` matches
+ * Tailwind's stock value, kept as `default`'s rendered fallback for parity.
+ */
+export declare const spacingMap: Record<SpacingPreset, string>;
+//# sourceMappingURL=spacing.d.ts.map

package/dist/theme/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/theme/spacing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAIpD,CAAA"}

package/dist/theme/spacing.js

@@ -0,0 +1,17 @@
+/**
+ * Maps spacing density presets to Tailwind v4 `--spacing` values.
+ *
+ * Tailwind compiles every `p-*`, `gap-*`, `m-*` utility as
+ * `calc(var(--spacing) * N)`, so swapping this single token uniformly tightens
+ * or loosens every gap and padding in the panel — no per-component edits.
+ *
+ * `'default'` is the sentinel resolver; the picker shows it as the first
+ * option and falls through to `PRESET_SPACING[preset]`. `0.25rem` matches
+ * Tailwind's stock value, kept as `default`'s rendered fallback for parity.
+ */
+export const spacingMap = {
+    default: '0.25rem',
+    compact: '0.2rem',
+    comfortable: '0.3rem',
+};
+//# sourceMappingURL=spacing.js.map

package/dist/theme/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../src/theme/spacing.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkC;IACvD,OAAO,EAAM,SAAS;IACtB,OAAO,EAAM,QAAQ;IACrB,WAAW,EAAE,QAAQ;CACtB,CAAA"}

package/dist/theme/theme-colors.d.ts

@@ -0,0 +1,9 @@
+import type { BaseColor, ThemeColor, PresetDefinition } from './types.js';
+/**
+ * Resolve a theme color value to its CSS variable overrides.
+ *
+ * @param themeColor  selected value — `'base'`, a known hue, or a raw seed string
+ * @param baseColor   current base color (used to resolve `'base'` sentinel)
+ */
+export declare function resolveThemeColor(themeColor: ThemeColor, baseColor: BaseColor): PresetDefinition;
+//# sourceMappingURL=theme-colors.d.ts.map

package/dist/theme/theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.d.ts","sourceRoot":"","sources":["../../src/theme/theme-colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAY,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AA0EnF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAMhG"}

package/dist/theme/theme-colors.js

@@ -0,0 +1,84 @@
+import { colors, HUE_NAMES } from './colors.js';
+import { parseSeedToScale } from './generate-scale.js';
+/**
+ * Theme (primary) color resolution.
+ *
+ * The theme color drives `--primary`, `--primary-foreground`, `--ring`, and
+ * the matching sidebar variants. Built from a `ColorScale` so adding a new
+ * hue is just adding an entry to `colors.ts`.
+ *
+ * The `'base'` sentinel means "use the current base color" — resolution
+ * pulls the matching scale from `colors[baseColor]` at call time.
+ *
+ * Custom seeds (raw hex / oklch strings outside the `HueColor` union) are
+ * parsed into a synthetic 50…950 scale via `parseSeedToScale`.
+ */
+/**
+ * Build the primary/ring overrides for a given color scale.
+ *
+ * `isBase` toggles between two strategies:
+ *  - **base sentinel** (e.g. Theme = "Neutral"): use the strongest contrast
+ *    *within the same scale* — primary is scale[900] in light, scale[50] in
+ *    dark. Matches shadcn's neutral theme behavior (very dark/light primary).
+ *  - **hue** (e.g. Theme = "Blue"): use scale[600] in BOTH light and dark so
+ *    the brand color stays consistent across modes (instead of lifting to
+ *    scale[400] in dark, which dilutes brand identity). Foreground stays the
+ *    near-white neutral[50] for AA contrast against the saturated mid-tone.
+ */
+function buildTheme(scale, isBase = false) {
+    if (isBase) {
+        return {
+            light: {
+                '--primary': scale[900],
+                '--primary-foreground': scale[50],
+                '--ring': scale[400],
+                '--sidebar-primary': scale[900],
+                '--sidebar-primary-foreground': scale[50],
+                '--sidebar-ring': scale[400],
+            },
+            dark: {
+                '--primary': scale[50],
+                '--primary-foreground': scale[900],
+                '--ring': scale[600],
+                '--sidebar-primary': scale[50],
+                '--sidebar-primary-foreground': scale[900],
+                '--sidebar-ring': scale[600],
+            },
+        };
+    }
+    return {
+        light: {
+            '--primary': scale[600],
+            '--primary-foreground': colors.neutral[50],
+            '--ring': scale[600],
+            '--sidebar-primary': scale[600],
+            '--sidebar-primary-foreground': colors.neutral[50],
+            '--sidebar-ring': scale[600],
+        },
+        dark: {
+            '--primary': scale[600],
+            '--primary-foreground': colors.neutral[50],
+            '--ring': scale[600],
+            '--sidebar-primary': scale[600],
+            '--sidebar-primary-foreground': colors.neutral[50],
+            '--sidebar-ring': scale[600],
+        },
+    };
+}
+const themeColorMap = Object.fromEntries(HUE_NAMES.map(name => [name, buildTheme(colors[name])]));
+/**
+ * Resolve a theme color value to its CSS variable overrides.
+ *
+ * @param themeColor  selected value — `'base'`, a known hue, or a raw seed string
+ * @param baseColor   current base color (used to resolve `'base'` sentinel)
+ */
+export function resolveThemeColor(themeColor, baseColor) {
+    if (themeColor === 'base')
+        return buildTheme(colors[baseColor], true);
+    if (themeColor in themeColorMap)
+        return themeColorMap[themeColor];
+    // Custom seed — parse and synthesize a scale.
+    const synthetic = parseSeedToScale(themeColor);
+    return synthetic ? buildTheme(synthetic) : buildTheme(colors[baseColor], true);
+}
+//# sourceMappingURL=theme-colors.js.map

package/dist/theme/theme-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.js","sourceRoot":"","sources":["../../src/theme/theme-colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,KAAiB,EAAE,MAAM,GAAG,KAAK;IACnD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE;gBACL,WAAW,EAAuB,KAAK,CAAC,GAAG,CAAC;gBAC5C,sBAAsB,EAAY,KAAK,CAAC,EAAE,CAAC;gBAC3C,QAAQ,EAA0B,KAAK,CAAC,GAAG,CAAC;gBAC5C,mBAAmB,EAAe,KAAK,CAAC,GAAG,CAAC;gBAC5C,8BAA8B,EAAI,KAAK,CAAC,EAAE,CAAC;gBAC3C,gBAAgB,EAAkB,KAAK,CAAC,GAAG,CAAC;aAC7C;YACD,IAAI,EAAE;gBACJ,WAAW,EAAuB,KAAK,CAAC,EAAE,CAAC;gBAC3C,sBAAsB,EAAY,KAAK,CAAC,GAAG,CAAC;gBAC5C,QAAQ,EAA0B,KAAK,CAAC,GAAG,CAAC;gBAC5C,mBAAmB,EAAe,KAAK,CAAC,EAAE,CAAC;gBAC3C,8BAA8B,EAAI,KAAK,CAAC,GAAG,CAAC;gBAC5C,gBAAgB,EAAkB,KAAK,CAAC,GAAG,CAAC;aAC7C;SACF,CAAA;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,WAAW,EAAuB,KAAK,CAAC,GAAG,CAAC;YAC5C,sBAAsB,EAAY,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,QAAQ,EAA0B,KAAK,CAAC,GAAG,CAAC;YAC5C,mBAAmB,EAAe,KAAK,CAAC,GAAG,CAAC;YAC5C,8BAA8B,EAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,gBAAgB,EAAkB,KAAK,CAAC,GAAG,CAAC;SAC7C;QACD,IAAI,EAAE;YACJ,WAAW,EAAuB,KAAK,CAAC,GAAG,CAAC;YAC5C,sBAAsB,EAAY,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,QAAQ,EAA0B,KAAK,CAAC,GAAG,CAAC;YAC5C,mBAAmB,EAAe,KAAK,CAAC,GAAG,CAAC;YAC5C,8BAA8B,EAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,gBAAgB,EAAkB,KAAK,CAAC,GAAG,CAAC;SAC7C;KACF,CAAA;AACH,CAAC;AAED,MAAM,aAAa,GAAuC,MAAM,CAAC,WAAW,CAC1E,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAClB,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAsB,EAAE,SAAoB;IAC5E,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,IAAI,UAAU,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC,UAAsB,CAAC,CAAA;IAC7E,8CAA8C;IAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAC9C,OAAO,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAA;AAChF,CAAC"}

package/dist/theme/types.d.ts

@@ -0,0 +1,94 @@
+import { BASE_COLOR_NAMES, HUE_NAMES } from './colors.js';
+/** Built-in style presets — each defines a complete set of OKLCH CSS variables.
+ *  `vega` is the Pilotiq brand (terracotta on cream, Satoshi). The other six are
+ *  placeholder neutrals awaiting visual differentiation. */
+export type StylePreset = 'vega' | 'nova' | 'maia' | 'lyra' | 'mira' | 'luma' | 'sera';
+/** Base color scale — controls the neutral/gray tones across the UI. */
+export type BaseColor = typeof BASE_COLOR_NAMES[number];
+/** Hue tokens shared by both the Theme color and Chart color pickers. */
+export type HueColor = typeof HUE_NAMES[number];
+/** Theme (primary) color — drives buttons, links, active states, ring.
+ *  `'base'` means "use the current base color's hue". Strings outside the
+ *  union are treated as raw hex/oklch seeds (custom color escape hatch). */
+export type ThemeColor = 'base' | HueColor | (string & {});
+/** Chart palette color — drives `--chart-1..5` as a single-hue ramp.
+ *  Same shape as `ThemeColor`. */
+export type ChartColor = ThemeColor;
+/** Border radius preset. */
+export type RadiusPreset = 'none' | 'small' | 'default' | 'medium' | 'large' | 'xlarge';
+/** Spacing density preset — drives Tailwind's `--spacing` multiplier so every
+ *  `p-*`, `gap-*`, `m-*` utility scales uniformly across the panel. */
+export type SpacingPreset = 'default' | 'compact' | 'comfortable';
+/** Icon library identifier — controls which icon set is resolved. */
+export type IconLibrary = 'lucide' | 'tabler' | 'remix' | 'phosphor';
+export interface ThemeFonts {
+    /** Google Fonts family name for headings, e.g. 'Space Grotesk'. */
+    heading?: string;
+    /** Google Fonts family name for body text, e.g. 'Inter'. */
+    body?: string;
+}
+/**
+ * Theme configuration — passed to `Pilotiq.theme()`.
+ *
+ * @example
+ * ```ts
+ * Pilotiq.make('admin').theme({
+ *   preset: 'vega',
+ *   baseColor: 'taupe',
+ *   themeColor: 'orange',
+ *   chartColor: 'base',
+ *   radius: 'medium',
+ *   fonts: { heading: 'Space Grotesk', body: 'Inter' },
+ * })
+ * ```
+ */
+export interface ThemeConfig {
+    /** Style preset — sets all CSS variables at once. Defaults to `'vega'`. */
+    preset?: StylePreset;
+    /** Base color scale — overrides neutral/gray tones from the preset. */
+    baseColor?: BaseColor;
+    /** Theme (primary) color. `'base'` = derive from current base color. */
+    themeColor?: ThemeColor;
+    /** Chart color. `'base'` = derive ramp from current base color. */
+    chartColor?: ChartColor;
+    /** Border radius preset. Defaults to `'medium'` (Pilotiq brand). */
+    radius?: RadiusPreset;
+    /** Spacing density preset. `'default'` falls through to the per-style value
+     *  in `PRESET_SPACING` (e.g. Mira → compact, Vega → comfortable). */
+    spacing?: SpacingPreset;
+    /** Font families (loaded from Google Fonts / Fontshare). */
+    fonts?: ThemeFonts;
+    /** Icon library. */
+    iconLibrary?: IconLibrary;
+    /** Escape hatch: raw CSS variable overrides in OKLCH. Applied last, highest priority. */
+    cssVariables?: {
+        light?: Record<string, string>;
+        dark?: Record<string, string>;
+    };
+}
+/** Resolved theme data sent from server to client via viewProps. */
+export interface ThemeMeta {
+    /** CSS variable map for :root (light mode). Keys are CSS custom property names. */
+    light: Record<string, string>;
+    /** CSS variable map for .dark (dark mode). */
+    dark: Record<string, string>;
+    /** Border radius value (e.g. '0.625rem'). */
+    radius: string;
+    /** Spacing multiplier for Tailwind's `--spacing` token (e.g. '0.25rem'). */
+    spacing: string;
+    /** Google Fonts families to load via <link> tag. */
+    fonts?: ThemeFonts;
+    /** Font family CSS values with fallbacks (e.g. "'Inter', sans-serif"). */
+    fontFamily?: {
+        heading?: string;
+        body?: string;
+    };
+    /** Icon library identifier for frontend icon resolution. */
+    iconLibrary: IconLibrary;
+}
+/** A complete set of CSS variable values for light and dark modes (OKLCH strings). */
+export interface PresetDefinition {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAIzD;;4DAE4D;AAC5D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAItF,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAIvD,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,CAAA;AAE/C;;4EAE4E;AAC5E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1D;kCACkC;AAClC,MAAM,MAAM,UAAU,GAAG,UAAU,CAAA;AAInC,4BAA4B;AAC5B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAIvF;uEACuE;AACvE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;AAIjE,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;AAIpE,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAO,WAAW,CAAA;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAI,SAAS,CAAA;IACvB,wEAAwE;IACxE,UAAU,CAAC,EAAG,UAAU,CAAA;IACxB,mEAAmE;IACnE,UAAU,CAAC,EAAG,UAAU,CAAA;IACxB,oEAAoE;IACpE,MAAM,CAAC,EAAO,YAAY,CAAA;IAC1B;yEACqE;IACrE,OAAO,CAAC,EAAM,aAAa,CAAA;IAC3B,4DAA4D;IAC5D,KAAK,CAAC,EAAQ,UAAU,CAAA;IACxB,oBAAoB;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,yFAAyF;IACzF,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC/B,CAAA;CACF;AAID,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,8CAA8C;IAC9C,IAAI,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAK,MAAM,CAAA;KACjB,CAAA;IACD,4DAA4D;IAC5D,WAAW,EAAE,WAAW,CAAA;CACzB;AAID,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,IAAI,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B"}

package/dist/theme/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":""}

package/dist/uploads/UploadAdapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pilotiq's upload contract. Apps register an adapter via
+ * `Pilotiq.uploads({ adapter })`; the `_uploads` route hands every
+ * incoming file to it. Pilotiq stays storage-agnostic — disk, S3,
+ * R2, GCS, or a custom storage backend all implement the same shape.
+ */
+export interface UploadAdapter {
+    /**
+     * Persist the file. Receive `{ file, directory? }`; return the
+     * URL the field should store. Throw to fail the upload — the
+     * route handler converts thrown errors into a 500 + toast.
+     */
+    put(req: UploadRequest): Promise<UploadResult>;
+}
+export interface UploadRequest {
+    /** The browser-supplied File. Has `.name`, `.size`, `.type`, `.arrayBuffer()`. */
+    file: File;
+    /** Optional sub-directory hint set by `FileUpload.directory(...)`. */
+    directory?: string;
+    /** The source field name — useful for adapter routing or audit logs. */
+    fieldName: string;
+}
+export interface UploadResult {
+    /** The public URL the field stores in the form value. */
+    url: string;
+    /**
+     * Optional metadata to round-trip alongside the URL — file size,
+     * content type, etc. Renderers that show previews may use this.
+     * Not part of the form value; can be used by `afterStateUpdated`
+     * hooks server-side.
+     */
+    meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=UploadAdapter.d.ts.map

package/dist/uploads/UploadAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadAdapter.d.ts","sourceRoot":"","sources":["../../src/uploads/UploadAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,IAAI,EAAQ,IAAI,CAAA;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,SAAS,EAAG,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B"}

package/dist/uploads/UploadAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UploadAdapter.js.map

package/dist/uploads/UploadAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadAdapter.js","sourceRoot":"","sources":["../../src/uploads/UploadAdapter.ts"],"names":[],"mappings":""}

package/dist/uploads/index.d.ts

@@ -0,0 +1,3 @@
+export type { UploadAdapter, UploadRequest, UploadResult } from './UploadAdapter.js';
+export { localUpload, type LocalUploadConfig } from './localUpload.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/uploads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uploads/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/uploads/index.js

@@ -0,0 +1,2 @@
+export { localUpload } from './localUpload.js';
+//# sourceMappingURL=index.js.map

package/dist/uploads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/uploads/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA0B,MAAM,kBAAkB,CAAA"}

package/dist/uploads/localUpload.d.ts

@@ -0,0 +1,25 @@
+import type { UploadAdapter } from './UploadAdapter.js';
+export interface LocalUploadConfig {
+    /**
+     * Filesystem directory where files are written. Resolved relative to
+     * `process.cwd()` if not absolute. The app's static-file middleware
+     * must serve this directory at `urlPrefix`.
+     *
+     * Example: `{ root: 'public/uploads', urlPrefix: '/uploads' }` writes
+     * to `<cwd>/public/uploads/<dir>/<id>.<ext>` and returns
+     * `/uploads/<dir>/<id>.<ext>`.
+     */
+    root: string;
+    /** URL prefix the file is served from. Without trailing slash. */
+    urlPrefix: string;
+}
+/**
+ * Disk-backed upload adapter. Writes incoming files under
+ * `config.root/<directory>/<random-id>.<ext>` and returns the public
+ * URL `<urlPrefix>/<directory>/<random-id>.<ext>`.
+ *
+ * v1: synchronous-ish (single `writeFile` per upload). No chunking,
+ * no resumable uploads, no image processing.
+ */
+export declare function localUpload(config: LocalUploadConfig): UploadAdapter;
+//# sourceMappingURL=localUpload.d.ts.map

package/dist/uploads/localUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localUpload.d.ts","sourceRoot":"","sources":["../../src/uploads/localUpload.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,oBAAoB,CAAA;AAEpF,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,IAAI,EAAO,MAAM,CAAA;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CA+BpE"}

package/dist/uploads/localUpload.js

@@ -0,0 +1,65 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { randomBytes } from 'node:crypto';
+/**
+ * Disk-backed upload adapter. Writes incoming files under
+ * `config.root/<directory>/<random-id>.<ext>` and returns the public
+ * URL `<urlPrefix>/<directory>/<random-id>.<ext>`.
+ *
+ * v1: synchronous-ish (single `writeFile` per upload). No chunking,
+ * no resumable uploads, no image processing.
+ */
+export function localUpload(config) {
+    return {
+        async put(req) {
+            const { file, directory } = req;
+            const ext = sanitizeExt(extname(file.name));
+            const id = randomId();
+            const subDir = sanitizeDir(directory);
+            const fullDir = subDir
+                ? join(config.root, subDir)
+                : config.root;
+            await mkdir(fullDir, { recursive: true });
+            const filename = `${id}${ext}`;
+            const fullPath = join(fullDir, filename);
+            const buffer = Buffer.from(await file.arrayBuffer());
+            await writeFile(fullPath, buffer);
+            const urlParts = [config.urlPrefix.replace(/\/$/, '')];
+            if (subDir)
+                urlParts.push(subDir);
+            urlParts.push(filename);
+            return {
+                url: urlParts.join('/'),
+                meta: {
+                    name: file.name,
+                    size: file.size,
+                    type: file.type,
+                },
+            };
+        },
+    };
+}
+function sanitizeDir(d) {
+    if (!d)
+        return '';
+    // Strip leading/trailing slashes and any ../ segments to avoid path
+    // traversal. Adapters are responsible for their own input validation.
+    return d
+        .replace(/^[/\\]+/, '')
+        .replace(/[/\\]+$/, '')
+        .split(/[/\\]/)
+        .filter(s => s !== '' && s !== '..' && s !== '.')
+        .join('/');
+}
+function sanitizeExt(ext) {
+    // Extension comes from a user-uploaded filename — keep it conservative.
+    if (!ext || ext.length > 10)
+        return '';
+    if (!/^\.[A-Za-z0-9]+$/.test(ext))
+        return '';
+    return ext.toLowerCase();
+}
+function randomId() {
+    return randomBytes(16).toString('hex');
+}
+//# sourceMappingURL=localUpload.js.map

package/dist/uploads/localUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localUpload.js","sourceRoot":"","sources":["../../src/uploads/localUpload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAmBzC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB;IACnD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAkB;YAC1B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,CAAA;YAC/B,MAAM,GAAG,GAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YAC/C,MAAM,EAAE,GAAQ,QAAQ,EAAE,CAAA;YAC1B,MAAM,MAAM,GAAI,WAAW,CAAC,SAAS,CAAC,CAAA;YACtC,MAAM,OAAO,GAAG,MAAM;gBACpB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;gBAC3B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;YAEf,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAEzC,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACxC,MAAM,MAAM,GAAK,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YACtD,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAEjC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;YACtD,IAAI,MAAM;gBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACjC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACvB,OAAO;gBACL,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvB,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,CAAqB;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,oEAAoE;IACpE,sEAAsE;IACtE,OAAO,CAAC;SACL,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;SAChD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,wEAAwE;IACxE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,EAAE,CAAA;IACtC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC5C,OAAO,GAAG,CAAC,WAAW,EAAE,CAAA;AAC1B,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC"}

package/dist/validation/Validator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Validation primitives.
+ *
+ * A `Validator` is a function: `(value, ctx?) => string | null | Promise<string | null>`.
+ * It returns an error message when invalid, or `null` when the value
+ * passes. Validators may carry an optional `serialized` descriptor — a
+ * JSON-safe shape mirrored to the client via `Field.toMeta()` so the
+ * browser can run the same rule for live UX before submit.
+ *
+ * The runtime is server-of-truth: client-side mirroring is best-effort.
+ * If `serialized` is omitted, the validator runs only on the server.
+ *
+ * Async validators (e.g. `unique()` probing the DB) return a `Promise`;
+ * the pipeline awaits each result before collecting the next field's
+ * errors. They are NOT mirrored to the client — the descriptor is omitted
+ * or marks itself `async: true` so the client skips the live check.
+ */
+/** JSON-safe descriptor of a built-in rule. Mirrored to the client. */
+export interface SerializedRule {
+    rule: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/**
+ * Optional context passed to a validator. `values` is the full submit
+ * payload — useful for cross-field rules (e.g. confirm-password). `record`
+ * is the persisted record under edit, when present.
+ */
+export interface ValidatorContext {
+    values?: Record<string, unknown>;
+    record?: unknown;
+}
+export type ValidatorFn = (value: unknown, ctx?: ValidatorContext) => string | null | Promise<string | null>;
+/** A validator function, optionally tagged with a serialized descriptor. */
+export type Validator = ValidatorFn & {
+    serialized?: SerializedRule;
+};
+/** Wrap a `ValidatorFn` and attach an optional serialized descriptor. */
+export declare function makeValidator(fn: ValidatorFn, serialized?: SerializedRule): Validator;
+//# sourceMappingURL=Validator.d.ts.map

package/dist/validation/Validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../src/validation/Validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,CAAC,EAAG,gBAAgB,KACpB,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;AAE3C,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAErE,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAIrF"}

package/dist/validation/Validator.js

@@ -0,0 +1,25 @@
+/**
+ * Validation primitives.
+ *
+ * A `Validator` is a function: `(value, ctx?) => string | null | Promise<string | null>`.
+ * It returns an error message when invalid, or `null` when the value
+ * passes. Validators may carry an optional `serialized` descriptor — a
+ * JSON-safe shape mirrored to the client via `Field.toMeta()` so the
+ * browser can run the same rule for live UX before submit.
+ *
+ * The runtime is server-of-truth: client-side mirroring is best-effort.
+ * If `serialized` is omitted, the validator runs only on the server.
+ *
+ * Async validators (e.g. `unique()` probing the DB) return a `Promise`;
+ * the pipeline awaits each result before collecting the next field's
+ * errors. They are NOT mirrored to the client — the descriptor is omitted
+ * or marks itself `async: true` so the client skips the live check.
+ */
+/** Wrap a `ValidatorFn` and attach an optional serialized descriptor. */
+export function makeValidator(fn, serialized) {
+    const v = fn;
+    if (serialized)
+        v.serialized = serialized;
+    return v;
+}
+//# sourceMappingURL=Validator.js.map

package/dist/validation/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../src/validation/Validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2BH,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,EAAe,EAAE,UAA2B;IACxE,MAAM,CAAC,GAAG,EAAe,CAAA;IACzB,IAAI,UAAU;QAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAAA;IACzC,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,5 @@
+export { makeValidator, type Validator, type ValidatorFn, type ValidatorContext, type SerializedRule, } from './Validator.js';
+export { required, email, minLength, maxLength, min, max, pattern, } from './rules.js';
+export { validateSchema, isValid, type ValidationErrors, } from './runValidators.js';
+export { unique, type UniqueOptions, } from './uniqueValidator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,SAAS,EACT,GAAG,EACH,GAAG,EACH,OAAO,GACR,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,cAAc,EACd,OAAO,EACP,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,MAAM,EACN,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA"}

package/dist/validation/index.js

@@ -0,0 +1,5 @@
+export { makeValidator, } from './Validator.js';
+export { required, email, minLength, maxLength, min, max, pattern, } from './rules.js';
+export { validateSchema, isValid, } from './runValidators.js';
+export { unique, } from './uniqueValidator.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAKd,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,SAAS,EACT,GAAG,EACH,GAAG,EACH,OAAO,GACR,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,cAAc,EACd,OAAO,GAER,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,MAAM,GAEP,MAAM,sBAAsB,CAAA"}

package/dist/validation/rules.d.ts

@@ -0,0 +1,9 @@
+import { type Validator } from './Validator.js';
+export declare function required(message?: string): Validator;
+export declare function email(message?: string): Validator;
+export declare function minLength(n: number, message?: string): Validator;
+export declare function maxLength(n: number, message?: string): Validator;
+export declare function min(n: number, message?: string): Validator;
+export declare function max(n: number, message?: string): Validator;
+export declare function pattern(regex: RegExp, message?: string): Validator;
+//# sourceMappingURL=rules.d.ts.map

package/dist/validation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/validation/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI9D,wBAAgB,QAAQ,CAAC,OAAO,SAA2B,GAAG,SAAS,CAKtE;AAID,wBAAgB,KAAK,CAAC,OAAO,SAA0B,GAAG,SAAS,CASlE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,SAAqC,GAAG,SAAS,CAS5F;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,SAAoC,GAAG,SAAS,CAS3F;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,SAA0B,GAAG,SAAS,CAS3E;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,SAAyB,GAAG,SAAS,CAS1E;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG,SAAS,CAS5E"}