@modern-admin/react 0.1.0

package/dist/export.js

@@ -0,0 +1,114 @@
+// Client-side export helpers.
+//
+// Pulls every record matching the current list query by paginating with a
+// large pageSize, then serializes to CSV or JSON and triggers a browser
+// download. Pure functions live here so they're trivially unit-testable;
+// the dialog UI in pages/export-dialog.tsx wires them together.
+/**
+ * Page through `client.list()` until exhausted, returning every record that
+ * matches the same filters/sorting as the current list view. `query.page`
+ * and `query.perPage` are overwritten — pass the user's filters/sorting only.
+ */
+export async function fetchAllRecords(client, resourceId, query, opts = {}) {
+    // Backend caps `perPage` at 200 (see listQueryZ in @modern-admin/nest).
+    const batchSize = opts.batchSize ?? 200;
+    const baseQuery = { ...(query ?? {}), perPage: batchSize, page: 1 };
+    const all = [];
+    let total = 0;
+    for (let page = 1;; page++) {
+        if (opts.signal?.aborted)
+            throw new DOMException('Aborted', 'AbortError');
+        const res = await client.list(resourceId, { ...baseQuery, page });
+        total = res.meta.total;
+        all.push(...res.records);
+        opts.onProgress?.(all.length, total);
+        if (res.records.length < batchSize)
+            break;
+        if (all.length >= total)
+            break;
+    }
+    return all;
+}
+/** Escape a single CSV field per RFC 4180 (wrap in quotes when needed). */
+export function csvEscape(value) {
+    if (value == null)
+        return '';
+    let str;
+    if (typeof value === 'string')
+        str = value;
+    else if (typeof value === 'number' || typeof value === 'boolean')
+        str = String(value);
+    else if (value instanceof Date)
+        str = value.toISOString();
+    else
+        str = JSON.stringify(value);
+    // Quote if it contains comma, quote, CR or LF.
+    if (/[",\r\n]/.test(str)) {
+        return `"${str.replace(/"/g, '""')}"`;
+    }
+    return str;
+}
+/** Build a CSV document for the given records. UTF-8 BOM for Excel friendliness. */
+export function recordsToCsv(records, opts = {}) {
+    const columns = opts.properties
+        ? opts.properties.map((p) => ({ path: p.path, label: p.label }))
+        : columnsFromRecords(records);
+    const header = columns.map((c) => csvEscape(c.label)).join(',');
+    const lines = records.map((r) => columns.map((c) => csvEscape(r.params[c.path])).join(','));
+    const queryComment = opts.query
+        ? `# Query: ${JSON.stringify(opts.query)}\r\n`
+        : '';
+    return `\uFEFF${queryComment}${[header, ...lines].join('\r\n')}`;
+}
+/** Build a pretty-printed JSON document for the given records.
+ *  When `opts.query` is set, a `// Query: ...` comment is prepended so the
+ *  export is self-documenting (JSONC — understood by VS Code, TypeScript, etc.) */
+export function recordsToJson(records, opts = {}) {
+    const paths = opts.properties?.map((p) => p.path);
+    const items = records.map((r) => {
+        if (!paths)
+            return { id: r.id, ...r.params };
+        const row = { id: r.id };
+        for (const p of paths)
+            row[p] = r.params[p];
+        return row;
+    });
+    const json = JSON.stringify(items, null, 2);
+    return opts.query ? `// Query: ${JSON.stringify(opts.query)}\n${json}` : json;
+}
+function columnsFromRecords(records) {
+    const seen = new Set();
+    const out = [];
+    for (const r of records) {
+        for (const k of Object.keys(r.params)) {
+            if (seen.has(k))
+                continue;
+            seen.add(k);
+            out.push({ path: k, label: k });
+        }
+    }
+    return out;
+}
+/** Trigger a browser download for the given text payload. */
+export function downloadText(filename, mime, body) {
+    if (typeof window === 'undefined')
+        return;
+    const blob = new Blob([body], { type: `${mime};charset=utf-8` });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    a.remove();
+    // Revoke after a tick so Safari has time to start the download.
+    window.setTimeout(() => URL.revokeObjectURL(url), 1000);
+}
+/** Build a stable filename like `users-20260506-143015.csv`. */
+export function exportFilename(resourceId, format, now = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
+        `-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return `${resourceId}-${stamp}.${format}`;
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/extension-registry.d.ts

@@ -0,0 +1,122 @@
+import type * as React from 'react';
+import type { PropertyDisplayProps, PropertyEditorProps } from './types.js';
+/**
+ * Extra navigation item rendered in the sidebar below the built-in entries
+ * (Home, Audit Log) and above the resource list.
+ */
+export interface SidebarExtension {
+    /** Stable unique key (e.g. `'rbac'`). Duplicate keys are silently ignored. */
+    key: string;
+    /** Label rendered next to the icon in the sidebar. */
+    label: string;
+    /** Lucide-compatible icon component. */
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    /**
+     * Extension route key — navigates to `/ext/<extensionKey>` within the
+     * admin shell (i.e., `{ name: 'extension', key: extensionKey }`).
+     * Must match the `key` of a corresponding `registerExtensionRoute` call
+     * so the router can render the right component.
+     */
+    extensionKey: string;
+    /**
+     * Optional capability gate. When set, the item is rendered only when
+     * `features[featureGate] === true` in the admin config (i.e. the backend
+     * has explicitly enabled the subsystem). Leave unset to always show.
+     */
+    featureGate?: string;
+}
+/**
+ * Extra section added to the Settings page navigation. The consumer's
+ * `component` is rendered as the main content area when the section is active.
+ */
+export interface SettingsExtension {
+    /**
+     * Unique section key (appears in the URL as `/settings/<key>`). Must be
+     * URL-safe (no slashes, encodes cleanly). Duplicate keys are ignored.
+     */
+    key: string;
+    /**
+     * i18n translation key for the section label shown in the settings nav
+     * (e.g. `'rbac:settings.title'`). Falls back to `key` if the key is missing
+     * from the active locale.
+     */
+    labelKey: string;
+    /** Lucide-compatible icon component shown next to the label. */
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    /**
+     * Component rendered as the main content when this section is active.
+     * It receives no props — read what you need via hooks or internal state.
+     */
+    component: React.ComponentType;
+}
+/**
+ * Custom property type renderer pair. When registered for `type`, the
+ * built-in `PropertyDisplay` and `PropertyEditor` switches fall through
+ * to this extension instead of rendering the default plain-text fallback.
+ */
+export interface PropertyExtension {
+    /** Renders a read-only value cell (list / show view). */
+    display: React.ComponentType<PropertyDisplayProps>;
+    /** Renders an editable form field (edit / new view). */
+    editor: React.ComponentType<PropertyEditorProps>;
+}
+/**
+ * Full-page route rendered inside the authenticated admin shell at the
+ * reserved path `/ext/<key>`.
+ */
+export interface RouteExtension {
+    /**
+     * URL-safe key (no slashes). The route becomes `/ext/<key>`. Must be
+     * unique — duplicate keys are silently ignored.
+     */
+    key: string;
+    /** Component rendered as the page content inside the shell layout. */
+    component: React.ComponentType;
+}
+/**
+ * Register a sidebar navigation item for an extension page.
+ * Call this during module initialisation, before `<AdminApp>` renders.
+ * Re-registering the same `key` is a no-op.
+ */
+export declare function registerSidebarItem(ext: SidebarExtension): void;
+/**
+ * Register a custom section in the Settings page.
+ * Call this during module initialisation, before `<AdminApp>` renders.
+ * Re-registering the same `key` is a no-op.
+ */
+export declare function registerSettingsSection(ext: SettingsExtension): void;
+/**
+ * Register a custom property type renderer (display + editor pair).
+ * When `property.type === type`, the built-in switch delegates to this
+ * extension instead of the plain-text fallback.
+ * Re-registering the same `type` overwrites the previous entry.
+ */
+export declare function registerPropertyExtension(type: string, ext: PropertyExtension): void;
+/**
+ * Register a full-page extension route at `/ext/<key>` inside the admin
+ * shell. A matching `SidebarExtension` with `extensionKey === key` provides
+ * the navigation entry.
+ * Re-registering the same `key` is a no-op.
+ */
+export declare function registerExtensionRoute(ext: RouteExtension): void;
+/** Returns all registered sidebar extensions in registration order. */
+export declare function getSidebarExtensions(): SidebarExtension[];
+/** Returns all registered settings sections in registration order. */
+export declare function getSettingsSectionExtensions(): SettingsExtension[];
+/**
+ * Returns the registered property extension for `type`, or `undefined` if
+ * no extension covers it (fall through to plain-text).
+ */
+export declare function getPropertyExtension(type: string): PropertyExtension | undefined;
+/** Returns the registered route extension for `key`, or `undefined`. */
+export declare function getRouteExtension(key: string): RouteExtension | undefined;
+/**
+ * Clears all registrations.
+ * @internal For unit tests only — do not call in production code.
+ */
+export declare function _resetExtensionRegistry(): void;
+//# sourceMappingURL=extension-registry.d.ts.map

package/dist/extension-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry.d.ts","sourceRoot":"","sources":["../src/extension-registry.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAI3E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD;;;OAGG;IACH,SAAS,EAAE,KAAK,CAAC,aAAa,CAAA;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAClD,wDAAwD;IACxD,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAA;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,SAAS,EAAE,KAAK,CAAC,aAAa,CAAA;CAC/B;AAoBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAIpE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAIhE;AAID,uEAAuE;AACvE,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CAEzD;AAED,sEAAsE;AACtE,wBAAgB,4BAA4B,IAAI,iBAAiB,EAAE,CAElE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAK9C"}

package/dist/extension-registry.js

@@ -0,0 +1,93 @@
+// UI Extension Registry — lets Pro plugins add sidebar items, settings
+// sections, custom property renderers, and full-page routes without
+// modifying `packages/react` directly.
+//
+// Usage: call `register*` functions during module initialisation (before
+// `<AdminApp>` renders). Every consumer of `@modern-admin/react` can import
+// and call these helpers; the registry is a process-global singleton.
+//
+// Design notes:
+//  • Module-global (not React-context-based) so registration can happen in
+//    plain JS outside any component tree.
+//  • Idempotent: re-registering the same `key` is silently ignored so hot-
+//    reload doesn't produce duplicates.
+//  • Zero external runtime deps — only imports prop-type interfaces from
+//    `./types.ts` which is already bundled.
+const registry = {
+    sidebarItems: [],
+    settingsSections: [],
+    propertyEditors: new Map(),
+    routes: [],
+};
+// ─── Registration API ─────────────────────────────────────────────────────────
+/**
+ * Register a sidebar navigation item for an extension page.
+ * Call this during module initialisation, before `<AdminApp>` renders.
+ * Re-registering the same `key` is a no-op.
+ */
+export function registerSidebarItem(ext) {
+    if (!registry.sidebarItems.find((e) => e.key === ext.key)) {
+        registry.sidebarItems.push(ext);
+    }
+}
+/**
+ * Register a custom section in the Settings page.
+ * Call this during module initialisation, before `<AdminApp>` renders.
+ * Re-registering the same `key` is a no-op.
+ */
+export function registerSettingsSection(ext) {
+    if (!registry.settingsSections.find((e) => e.key === ext.key)) {
+        registry.settingsSections.push(ext);
+    }
+}
+/**
+ * Register a custom property type renderer (display + editor pair).
+ * When `property.type === type`, the built-in switch delegates to this
+ * extension instead of the plain-text fallback.
+ * Re-registering the same `type` overwrites the previous entry.
+ */
+export function registerPropertyExtension(type, ext) {
+    registry.propertyEditors.set(type, ext);
+}
+/**
+ * Register a full-page extension route at `/ext/<key>` inside the admin
+ * shell. A matching `SidebarExtension` with `extensionKey === key` provides
+ * the navigation entry.
+ * Re-registering the same `key` is a no-op.
+ */
+export function registerExtensionRoute(ext) {
+    if (!registry.routes.find((r) => r.key === ext.key)) {
+        registry.routes.push(ext);
+    }
+}
+// ─── Accessors (consumed by shell components at render time) ──────────────────
+/** Returns all registered sidebar extensions in registration order. */
+export function getSidebarExtensions() {
+    return registry.sidebarItems;
+}
+/** Returns all registered settings sections in registration order. */
+export function getSettingsSectionExtensions() {
+    return registry.settingsSections;
+}
+/**
+ * Returns the registered property extension for `type`, or `undefined` if
+ * no extension covers it (fall through to plain-text).
+ */
+export function getPropertyExtension(type) {
+    return registry.propertyEditors.get(type);
+}
+/** Returns the registered route extension for `key`, or `undefined`. */
+export function getRouteExtension(key) {
+    return registry.routes.find((r) => r.key === key);
+}
+/**
+ * Clears all registrations.
+ * @internal For unit tests only — do not call in production code.
+ */
+export function _resetExtensionRegistry() {
+    registry.sidebarItems = [];
+    registry.settingsSections = [];
+    registry.propertyEditors.clear();
+    registry.routes = [];
+}
+//# sourceMappingURL=extension-registry.js.map

package/dist/extension-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry.js","sourceRoot":"","sources":["../src/extension-registry.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,uCAAuC;AACvC,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,sEAAsE;AACtE,EAAE;AACF,gBAAgB;AAChB,2EAA2E;AAC3E,0CAA0C;AAC1C,2EAA2E;AAC3E,wCAAwC;AACxC,yEAAyE;AACzE,4CAA4C;AA6F5C,MAAM,QAAQ,GAAiB;IAC7B,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,IAAI,GAAG,EAAE;IAC1B,MAAM,EAAE,EAAE;CACX,CAAA;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAqB;IACvD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC5D,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,GAAsB;IAC5E,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAmB;IACxD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,uEAAuE;AACvE,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC,YAAY,CAAA;AAC9B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAC,gBAAgB,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,QAAQ,CAAC,YAAY,GAAG,EAAE,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,GAAG,EAAE,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,CAAA;IAChC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAA;AACtB,CAAC"}

package/dist/header-controls.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+export declare function ThemeToggle(): React.ReactElement;
+export declare function LanguageSwitcher(): React.ReactElement | null;
+//# sourceMappingURL=header-controls.d.ts.map

package/dist/header-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-controls.d.ts","sourceRoot":"","sources":["../src/header-controls.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA4C9B,wBAAgB,WAAW,IAAI,KAAK,CAAC,YAAY,CAyChD;AAED,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAiC5D"}

package/dist/header-controls.jsx

@@ -0,0 +1,70 @@
+// Theme + language switchers for the admin header. Both render as
+// dropdown menus using shadcn primitives and reflect persistent state
+// (theme via @modern-admin/ui's lib/theme; locale via I18nProvider).
+import * as React from 'react';
+import { Button, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, ScrollArea, readThemeMode, setThemeMode, } from '@modern-admin/ui';
+import { Check, Languages, Monitor, Moon, Sun } from 'lucide-react';
+import { useI18n } from './i18n.js';
+/** Single dropdown row with a leading icon, label, and trailing check when active. */
+function MenuOption({ icon, label, active, onSelect, }) {
+    return (<DropdownMenuItem onSelect={(e) => {
+            e.preventDefault();
+            onSelect();
+        }} className="gap-3 px-3 py-2">
+      {icon && <span className="flex size-4 items-center justify-center text-muted-foreground">{icon}</span>}
+      <span className="flex-1 truncate">{label}</span>
+      {active && <Check className="size-4 text-primary"/>}
+    </DropdownMenuItem>);
+}
+export function ThemeToggle() {
+    const { t } = useI18n();
+    const [mode, setMode] = React.useState(() => readThemeMode());
+    const apply = (next) => {
+        setThemeMode(next);
+        setMode(next);
+    };
+    const Icon = mode === 'dark' ? Moon : mode === 'light' ? Sun : Monitor;
+    return (<DropdownMenu>
+      <DropdownMenuTrigger asChild>
+        <Button variant="ghost" size="icon" aria-label={t('common:toggleTheme')}>
+          <Icon className="size-4"/>
+        </Button>
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="end" sideOffset={8} className="w-44 p-1">
+        <DropdownMenuLabel className="px-3 py-2 text-xs uppercase tracking-wide text-muted-foreground">
+          {t('common:theme')}
+        </DropdownMenuLabel>
+        <DropdownMenuSeparator />
+        <MenuOption icon={<Sun className="size-4"/>} label={t('common:themeLight')} active={mode === 'light'} onSelect={() => apply('light')}/>
+        <MenuOption icon={<Moon className="size-4"/>} label={t('common:themeDark')} active={mode === 'dark'} onSelect={() => apply('dark')}/>
+        <MenuOption icon={<Monitor className="size-4"/>} label={t('common:themeSystem')} active={mode === 'system'} onSelect={() => apply('system')}/>
+      </DropdownMenuContent>
+    </DropdownMenu>);
+}
+export function LanguageSwitcher() {
+    const { locale, setLocale, availableLocales, t } = useI18n();
+    const locales = availableLocales();
+    // With a single registered locale there is nothing to switch between —
+    // hide the control entirely (consumers control the set via I18nProvider's
+    // `locales` prop, which the standalone shell wires from runtime config).
+    if (locales.length <= 1)
+        return null;
+    return (<DropdownMenu>
+      <DropdownMenuTrigger asChild>
+        <Button variant="ghost" size="sm" className="gap-2">
+          <Languages className="size-4"/>
+          <span className="text-xs uppercase">{locale}</span>
+        </Button>
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="end" sideOffset={8} className="w-52 p-1">
+        <DropdownMenuLabel className="px-3 py-2 text-xs uppercase tracking-wide text-muted-foreground">
+          {t('common:language')}
+        </DropdownMenuLabel>
+        <DropdownMenuSeparator />
+        <ScrollArea className="max-h-72">
+          {locales.map((l) => (<MenuOption key={l.code} label={l.name} active={l.code === locale} onSelect={() => setLocale(l.code)}/>))}
+        </ScrollArea>
+      </DropdownMenuContent>
+    </DropdownMenu>);
+}
+//# sourceMappingURL=header-controls.jsx.map

package/dist/header-controls.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-controls.jsx","sourceRoot":"","sources":["../src/header-controls.tsx"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sEAAsE;AACtE,qEAAqE;AAErE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,YAAY,GAEb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,sFAAsF;AACtF,SAAS,UAAU,CAAC,EAClB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,GAMT;IACC,OAAO,CACL,CAAC,gBAAgB,CACf,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;YACd,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB,QAAQ,EAAE,CAAA;QACZ,CAAC,CAAC,CACF,SAAS,CAAC,iBAAiB,CAE3B;MAAA,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,+DAA+D,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CACtG;MAAA,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAC/C;MAAA,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,EAAG,CACtD;IAAA,EAAE,gBAAgB,CAAC,CACpB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAY,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;IACxE,MAAM,KAAK,GAAG,CAAC,IAAe,EAAQ,EAAE;QACtC,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAA;IACtE,OAAO,CACL,CAAC,YAAY,CACX;MAAA,CAAC,mBAAmB,CAAC,OAAO,CAC1B;QAAA,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CACtE;UAAA,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAC1B;QAAA,EAAE,MAAM,CACV;MAAA,EAAE,mBAAmB,CACrB;MAAA,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAClE;QAAA,CAAC,iBAAiB,CAAC,SAAS,CAAC,iEAAiE,CAC5F;UAAA,CAAC,CAAC,CAAC,cAAc,CAAC,CACpB;QAAA,EAAE,iBAAiB,CACnB;QAAA,CAAC,qBAAqB,CAAC,AAAD,EACtB;QAAA,CAAC,UAAU,CACT,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAG,CAAC,CACjC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAC9B,MAAM,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CACzB,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAEjC;QAAA,CAAC,UAAU,CACT,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAG,CAAC,CAClC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAC7B,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CACxB,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAEhC;QAAA,CAAC,UAAU,CACT,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAG,CAAC,CACrC,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAC/B,MAAM,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC1B,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAEpC;MAAA,EAAE,mBAAmB,CACvB;IAAA,EAAE,YAAY,CAAC,CAChB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAA;IAC5D,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAA;IAClC,uEAAuE;IACvE,0EAA0E;IAC1E,yEAAyE;IACzE,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,CACL,CAAC,YAAY,CACX;MAAA,CAAC,mBAAmB,CAAC,OAAO,CAC1B;QAAA,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CACjD;UAAA,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAC7B;UAAA,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CACpD;QAAA,EAAE,MAAM,CACV;MAAA,EAAE,mBAAmB,CACrB;MAAA,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAClE;QAAA,CAAC,iBAAiB,CAAC,SAAS,CAAC,iEAAiE,CAC5F;UAAA,CAAC,CAAC,CAAC,iBAAiB,CAAC,CACvB;QAAA,EAAE,iBAAiB,CACnB;QAAA,CAAC,qBAAqB,CAAC,AAAD,EACtB;QAAA,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAC9B;UAAA,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAClB,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACZ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACd,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAC1B,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAClC,CACH,CAAC,CACJ;QAAA,EAAE,UAAU,CACd;MAAA,EAAE,mBAAmB,CACvB;IAAA,EAAE,YAAY,CAAC,CAChB,CAAA;AACH,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,104 @@
+import { type InfiniteData, type UseInfiniteQueryResult, type UseMutationResult, type UseQueryResult } from '@tanstack/react-query';
+import type { AdminConfig, AdminFeatures, CustomActionResponse, CurrentUser, ListQuery, ListResponse, RecordResponse, ResourceJSON } from './types.js';
+import { type AuthUiProps, type AuditLogQuery, type AuditLogResponse, type GlobalSearchResponse, type HistoryListResponse, type HistoryRevisionResponse, type TimeSeriesQuery, type TimeSeriesResponse } from './client.js';
+export declare const useAdminConfig: () => UseQueryResult<AdminConfig>;
+export declare const useResource: (resourceId: string | undefined) => ResourceJSON | undefined;
+/**
+ * Capability flags advertised by the backend via `/admin/api/config`.
+ * Use to gate optional UI surfaces (audit-log link, settings sections,
+ * revisions button, AI assistant widget) — every flag is `false` until
+ * the bootstrap config is loaded, so consumers can render unconditionally
+ * and the gating logic short-circuits during the initial paint.
+ */
+export declare const useFeatures: () => AdminFeatures;
+export declare const useResources: () => ResourceJSON[];
+/**
+ * Fetch distinct values for a field, cached for 5 minutes.
+ * Used by the filter value picker to offer multi-select when cardinality is low.
+ * The `enabled` flag allows lazy loading only when the filter UI is open.
+ */
+export declare const useDistinctValues: (resourceId: string, field: string, options?: {
+    search?: string;
+    limit?: number;
+    enabled?: boolean;
+}) => UseQueryResult<{
+    values: string[];
+    hasMore: boolean;
+}>;
+export declare const useRecords: (resourceId: string, query?: ListQuery) => UseQueryResult<ListResponse>;
+export declare const useRecord: (resourceId: string, recordId: string | undefined) => UseQueryResult<RecordResponse>;
+export declare const useCreateRecord: (resourceId: string) => UseMutationResult<RecordResponse, Error, Record<string, unknown>>;
+export declare const useUpdateRecord: (resourceId: string) => UseMutationResult<RecordResponse, Error, {
+    id: string;
+    payload: Record<string, unknown>;
+}>;
+export declare const useDeleteRecord: (resourceId: string) => UseMutationResult<void, Error, string>;
+export declare const useBulkDeleteRecords: (resourceId: string) => UseMutationResult<unknown, Error, ReadonlyArray<string>>;
+export interface CurrentUserResult {
+    user: CurrentUser | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    error: Error | null;
+}
+/** Resolve the current admin via /admin/api/auth/me. A 401 response surfaces
+ *  as `user: null` (rather than an error) so callers can branch on it to
+ *  render the login screen. */
+export declare const useCurrentUser: () => CurrentUserResult;
+/** Fetch public auth UI metadata (enabled social providers, email/password flag).
+ *  Cached indefinitely — the provider list is static for a given deployment. */
+export declare const useAuthUiProps: () => UseQueryResult<AuthUiProps>;
+/** Initiate OAuth social login. Navigates the browser away to the provider;
+ *  `isPending` is true while the redirect URL is being fetched. */
+export declare const useSocialLogin: () => UseMutationResult<void, Error, string>;
+export declare const useLogin: () => UseMutationResult<void, Error, {
+    email: string;
+    password: string;
+}>;
+export declare const useLogout: () => UseMutationResult<void, Error, void>;
+export declare const useInvokeRecordAction: (resourceId: string) => UseMutationResult<CustomActionResponse, Error, {
+    recordId: string;
+    actionName: string;
+}>;
+export declare const useInvokeBulkAction: (resourceId: string) => UseMutationResult<CustomActionResponse, Error, {
+    actionName: string;
+    ids: string[];
+}>;
+export declare const useInvokeResourceAction: (resourceId: string) => UseMutationResult<CustomActionResponse, Error, {
+    actionName: string;
+    payload?: Record<string, unknown>;
+}>;
+/**
+ * Cross-resource search hook. Fires a single batched request that fans out
+ * to every registered resource's `search` action; results are grouped by
+ * resource. The empty-query case is handled by the caller (skip render);
+ * `enabled` allows lazy activation while the dialog is closed.
+ */
+export declare const useGlobalSearch: (query: string, enabled?: boolean) => UseQueryResult<GlobalSearchResponse>;
+export declare const useSearchRecords: (resourceId: string | undefined, query: string, enabled?: boolean) => UseQueryResult<ListResponse>;
+/**
+ * Distinct (deduplicated, sorted) values pulled from a single field of a
+ * resource — the data source for the autocomplete `suggestionsResource +
+ * suggestionsField` binding on `KeyValueFieldSpec`. Loads up to `perPage`
+ * records and projects `field` client-side; for typical admin resources
+ * (hundreds–low thousands of rows) this is plenty cheap. For very large
+ * tables, reach for a dedicated `distinct` endpoint.
+ */
+export declare const useFieldSuggestions: (resourceId: string | undefined, field: string | undefined, perPage?: number) => UseQueryResult<string[]>;
+export declare const useTimeSeries: (query: TimeSeriesQuery | null) => UseQueryResult<TimeSeriesResponse>;
+export declare const useRecordHistory: (resourceId: string, recordId: string | undefined, options?: {
+    limit?: number;
+    offset?: number;
+}) => UseQueryResult<HistoryListResponse>;
+export declare const useHistoryRevision: (resourceId: string, recordId: string | undefined, revisionId: string | undefined) => UseQueryResult<HistoryRevisionResponse>;
+export declare const useRevertRevision: (resourceId: string, recordId: string) => UseMutationResult<RecordResponse, Error, {
+    revisionId: string;
+    reason?: string;
+}>;
+export declare const useAuditLog: (query?: AuditLogQuery) => UseQueryResult<AuditLogResponse>;
+/**
+ * Cursor-based infinite scroll variant of `useAuditLog`.
+ * Each page passes the `at` timestamp of the last entry as the `before` cursor.
+ * `pageSize` entries are requested; if the response is full, there are more pages.
+ */
+export declare const useInfiniteAuditLog: (filters: Omit<AuditLogQuery, "before" | "offset" | "limit">, pageSize: number) => UseInfiniteQueryResult<InfiniteData<AuditLogResponse>, Error>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAA;AAepB,eAAO,MAAM,cAAc,QAAO,cAAc,CAAC,WAAW,CAG3D,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,GAAG,SAAS,KAAG,YAAY,GAAG,SAO3E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAO,aAG9B,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,YAAY,EAO3C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,OAAO,MAAM,EACb,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAC/D,cAAc,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAWvD,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,YAAY,MAAM,EAClB,QAAQ,SAAS,KAChB,cAAc,CAAC,YAAY,CAM7B,CAAA;AAED,eAAO,MAAM,SAAS,GACpB,YAAY,MAAM,EAClB,UAAU,MAAM,GAAG,SAAS,KAC3B,cAAc,CAAC,cAAc,CAO/B,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,KACjB,iBAAiB,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASlE,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,KACjB,iBAAiB,CAClB,cAAc,EACd,KAAK,EACL;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAWjD,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,KACjB,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CASvC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,KACjB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CASzD,CAAA;AAcD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;+BAE+B;AAC/B,eAAO,MAAM,cAAc,QAAO,iBAwBjC,CAAA;AAED;gFACgF;AAChF,eAAO,MAAM,cAAc,QAAO,cAAc,CAAC,WAAW,CAO3D,CAAA;AAED;mEACmE;AACnE,eAAO,MAAM,cAAc,QAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAKtE,CAAA;AAED,eAAO,MAAM,QAAQ,QAAO,iBAAiB,CAC3C,IAAI,EACJ,KAAK,EACL;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAWpC,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CA0B/D,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,KACjB,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAWzF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,KACjB,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAStF,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,KACjB,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAS1G,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,iBAAc,KACb,cAAc,CAAC,oBAAoB,CAWrC,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,YAAY,MAAM,GAAG,SAAS,EAC9B,OAAO,MAAM,EACb,iBAAc,KACb,cAAc,CAAC,YAAY,CAQ7B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,GAAG,SAAS,EAC9B,OAAO,MAAM,GAAG,SAAS,EACzB,gBAAa,KACZ,cAAc,CAAC,MAAM,EAAE,CAsBzB,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,OAAO,eAAe,GAAG,IAAI,KAC5B,cAAc,CAAC,kBAAkB,CAQnC,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,YAAY,MAAM,EAClB,UAAU,MAAM,GAAG,SAAS,EAC5B,UAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,KAChD,cAAc,CAAC,mBAAmB,CAQpC,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,UAAU,MAAM,GAAG,SAAS,EAC5B,YAAY,MAAM,GAAG,SAAS,KAC7B,cAAc,CAAC,uBAAuB,CAQxC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,UAAU,MAAM,KACf,iBAAiB,CAAC,cAAc,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAalF,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,QAAO,aAAkB,KACxB,cAAc,CAAC,gBAAgB,CAOjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,EAC3D,UAAU,MAAM,KACf,sBAAsB,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAkB9D,CAAA"}