@pyric/ui 0.1.0-alpha.7

package/dist/primitives/index.js

@@ -0,0 +1,10 @@
+export { CopyButton } from './CopyButton.js';
+export { Badge } from './Badge.js';
+export { JsonView, } from './JsonView.js';
+export { SegmentedControl, } from './SegmentedControl.js';
+export { ConfirmDialog } from './ConfirmDialog.js';
+export { ConfirmProvider, useConfirm, } from './useConfirm.js';
+export { ToastProvider, useToast, } from './Toast.js';
+export { VirtualList } from './VirtualList.js';
+export { useContainerSize, } from './hooks/useContainerSize.js';
+//# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAmB,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,QAAQ,GAET,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,UAAU,GAIX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,QAAQ,GAKT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EACL,gBAAgB,GAGjB,MAAM,6BAA6B,CAAC"}

package/dist/primitives/useConfirm.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from 'react';
+export interface ConfirmOptions {
+    title: string;
+    body?: ReactNode;
+    destructive?: boolean;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+export type ConfirmFn = (options: ConfirmOptions) => Promise<boolean>;
+/**
+ * Imperative confirmation hook. Returns a function that opens the
+ * provider-managed dialog and resolves to `true` on confirm, `false`
+ * on cancel/dismiss.
+ *
+ *   const confirm = useConfirm();
+ *   const ok = await confirm({ title: 'Delete?', destructive: true });
+ *   if (ok) await deleteDoc(ref);
+ *
+ * Requires a `<ConfirmProvider>` ancestor.
+ */
+export declare function useConfirm(): ConfirmFn;
+export interface ConfirmProviderProps {
+    children: ReactNode;
+    /** Forwarded to the rendered `<ConfirmDialog>`. */
+    dialogClassName?: string;
+}
+/**
+ * Mounts a single managed `<ConfirmDialog>` and exposes the
+ * imperative `confirm()` API through context. Scoped — multiple
+ * providers can coexist in different subtrees, each managing its
+ * own dialog.
+ */
+export declare function ConfirmProvider({ children, dialogClassName }: ConfirmProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=useConfirm.d.ts.map

package/dist/primitives/useConfirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfirm.d.ts","sourceRoot":"","sources":["../../src/primitives/useConfirm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAItE;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAMtC;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,oBAAoB,+BAqDlF"}

package/dist/primitives/useConfirm.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useRef, useState, } from 'react';
+import { ConfirmDialog } from './ConfirmDialog.js';
+const Ctx = createContext(null);
+/**
+ * Imperative confirmation hook. Returns a function that opens the
+ * provider-managed dialog and resolves to `true` on confirm, `false`
+ * on cancel/dismiss.
+ *
+ *   const confirm = useConfirm();
+ *   const ok = await confirm({ title: 'Delete?', destructive: true });
+ *   if (ok) await deleteDoc(ref);
+ *
+ * Requires a `<ConfirmProvider>` ancestor.
+ */
+export function useConfirm() {
+    const fn = useContext(Ctx);
+    if (!fn) {
+        throw new Error('useConfirm: missing <ConfirmProvider> ancestor');
+    }
+    return fn;
+}
+/**
+ * Mounts a single managed `<ConfirmDialog>` and exposes the
+ * imperative `confirm()` API through context. Scoped — multiple
+ * providers can coexist in different subtrees, each managing its
+ * own dialog.
+ */
+export function ConfirmProvider({ children, dialogClassName }) {
+    const [pending, setPending] = useState(null);
+    // Track which resolution path fired so the close handler doesn't
+    // double-resolve when both onConfirm + onOpenChange(false) trigger.
+    const resolvedRef = useRef(false);
+    const confirm = useCallback((options) => {
+        return new Promise((resolve) => {
+            resolvedRef.current = false;
+            setPending({ options, resolve });
+        });
+    }, []);
+    const handleConfirm = useCallback(() => {
+        if (!pending)
+            return;
+        if (resolvedRef.current)
+            return;
+        resolvedRef.current = true;
+        pending.resolve(true);
+        setPending(null);
+    }, [pending]);
+    const handleOpenChange = useCallback((open) => {
+        if (open)
+            return;
+        if (!pending)
+            return;
+        if (resolvedRef.current)
+            return;
+        resolvedRef.current = true;
+        pending.resolve(false);
+        setPending(null);
+    }, [pending]);
+    const ctxValue = useMemo(() => confirm, [confirm]);
+    return (_jsxs(Ctx.Provider, { value: ctxValue, children: [children, pending ? (_jsx(ConfirmDialog, { open: true, onOpenChange: handleOpenChange, title: pending.options.title, body: pending.options.body, destructive: pending.options.destructive, confirmLabel: pending.options.confirmLabel, cancelLabel: pending.options.cancelLabel, onConfirm: handleConfirm, className: dialogClassName })) : null] }));
+}
+//# sourceMappingURL=useConfirm.js.map

package/dist/primitives/useConfirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfirm.js","sourceRoot":"","sources":["../../src/primitives/useConfirm.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,MAAM,EACN,QAAQ,GAET,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,MAAM,GAAG,GAAG,aAAa,CAAmB,IAAI,CAAC,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAwB;IACjF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IACpE,iEAAiE;IACjE,oEAAoE;IACpE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,WAAW,CAAY,CAAC,OAAO,EAAE,EAAE;QACjD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;YAC5B,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,WAAW,CAAC,OAAO;YAAE,OAAO;QAChC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,gBAAgB,GAAG,WAAW,CAClC,CAAC,IAAa,EAAE,EAAE;QAChB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,WAAW,CAAC,OAAO;YAAE,OAAO;QAChC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnD,OAAO,CACL,MAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,aAC1B,QAAQ,EACR,OAAO,CAAC,CAAC,CAAC,CACT,KAAC,aAAa,IACZ,IAAI,QACJ,YAAY,EAAE,gBAAgB,EAC9B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAC5B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAC1B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,EACxC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,EAC1C,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,EACxC,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,eAAe,GAC1B,CACH,CAAC,CAAC,CAAC,IAAI,IACK,CAChB,CAAC;AACJ,CAAC"}

package/dist/rtdb/components/RtdbPathBar.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+export interface RtdbPathBarProps {
+    /** Current absolute database path (`'/'` for root). */
+    path: string;
+    /** Fired with the parsed absolute path on crumb click or input submit. */
+    onNavigate: (path: string) => void;
+    /** Root crumb label — the database/instance identity (e.g. the sandbox
+     *  slug). Default `'/'`. */
+    rootLabel?: ReactNode;
+    /** Text shown before the input while editing (the non-editable URL part). */
+    inputPrefix?: string;
+    className?: string;
+}
+/**
+ * The editable path bar of the RTDB viewer — the interaction form of the
+ * Firebase console / firebase-tools-ui database URL bar (clean-room
+ * adaptation): in DISPLAY mode the path renders as clickable crumbs
+ * (root → … → current) plus an edit affordance; EDIT mode swaps in a text
+ * input seeded with the current path — Enter navigates, Escape or blur
+ * cancels. Pasted full URLs and missing leading slashes are tolerated
+ * (`parseRtdbPathInput`).
+ *
+ * Headless. Consumers style via:
+ * - `[data-pyric-ui="rtdb-path-bar"]` — the root (`data-rtdb-editing` when editing)
+ * - `[data-rtdb-crumb]` / `[data-rtdb-crumb-root]` / `[data-pyric-current]`
+ * - `[data-rtdb-crumb-separator]`
+ * - `[data-rtdb-path-edit]` — the edit button
+ * - `[data-rtdb-path-form]`, `[data-rtdb-path-prefix]`, `[data-rtdb-path-input]`
+ */
+export declare function RtdbPathBar({ path, onNavigate, rootLabel, inputPrefix, className, }: RtdbPathBarProps): import("react").JSX.Element;
+//# sourceMappingURL=RtdbPathBar.d.ts.map

package/dist/rtdb/components/RtdbPathBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RtdbPathBar.d.ts","sourceRoot":"","sources":["../../../src/rtdb/components/RtdbPathBar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpF,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;gCAC4B;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,UAAU,EACV,SAAe,EACf,WAAW,EACX,SAAS,GACV,EAAE,gBAAgB,+BA+FlB"}

package/dist/rtdb/components/RtdbPathBar.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { parseRtdbPathInput, rtdbCrumbs } from '../pathInput.js';
+import { normalizeRtdbPath } from '../values.js';
+/**
+ * The editable path bar of the RTDB viewer — the interaction form of the
+ * Firebase console / firebase-tools-ui database URL bar (clean-room
+ * adaptation): in DISPLAY mode the path renders as clickable crumbs
+ * (root → … → current) plus an edit affordance; EDIT mode swaps in a text
+ * input seeded with the current path — Enter navigates, Escape or blur
+ * cancels. Pasted full URLs and missing leading slashes are tolerated
+ * (`parseRtdbPathInput`).
+ *
+ * Headless. Consumers style via:
+ * - `[data-pyric-ui="rtdb-path-bar"]` — the root (`data-rtdb-editing` when editing)
+ * - `[data-rtdb-crumb]` / `[data-rtdb-crumb-root]` / `[data-pyric-current]`
+ * - `[data-rtdb-crumb-separator]`
+ * - `[data-rtdb-path-edit]` — the edit button
+ * - `[data-rtdb-path-form]`, `[data-rtdb-path-prefix]`, `[data-rtdb-path-input]`
+ */
+export function RtdbPathBar({ path, onNavigate, rootLabel = '/', inputPrefix, className, }) {
+    const normalized = normalizeRtdbPath(path);
+    const [editing, setEditing] = useState(false);
+    // UNCONTROLLED input, read at submit: the input mounts fresh per edit
+    // session (display mode unmounts it) seeded with the current path, so a
+    // cancelled draft never leaks into the next session.
+    const inputRef = useRef(null);
+    useEffect(() => {
+        if (editing)
+            inputRef.current?.select();
+    }, [editing]);
+    const submit = (e) => {
+        e.preventDefault();
+        onNavigate(parseRtdbPathInput(inputRef.current?.value ?? ''));
+        setEditing(false);
+    };
+    const cancel = () => setEditing(false);
+    const crumbs = rtdbCrumbs(normalized);
+    return (_jsx("nav", { className: className, "data-pyric-ui": "rtdb-path-bar", "data-rtdb-editing": editing ? '' : undefined, "aria-label": "Database path", children: editing ? (_jsxs("form", { "data-rtdb-path-form": true, onSubmit: submit, children: [inputPrefix ? _jsx("span", { "data-rtdb-path-prefix": true, children: inputPrefix }) : null, _jsx("input", { ref: inputRef, "data-rtdb-path-input": true, "aria-label": "Database path", autoFocus: true, defaultValue: normalized, onBlur: cancel, onKeyDown: (e) => {
+                        if (e.key === 'Escape')
+                            cancel();
+                    }, spellCheck: false })] })) : (_jsxs(_Fragment, { children: [_jsxs("ol", { "data-rtdb-crumb-list": true, children: [_jsx("li", { "data-rtdb-crumb-item": true, children: _jsx("button", { type: "button", "data-rtdb-crumb": true, "data-rtdb-crumb-root": true, "data-pyric-current": crumbs.length === 0 ? '' : undefined, "aria-current": crumbs.length === 0 ? 'page' : undefined, onClick: () => onNavigate('/'), children: rootLabel }) }), crumbs.map((crumb, i) => {
+                            const isCurrent = i === crumbs.length - 1;
+                            return (_jsxs("li", { "data-rtdb-crumb-item": true, children: [_jsx("span", { "aria-hidden": true, "data-rtdb-crumb-separator": true, children: "/" }), _jsx("button", { type: "button", "data-rtdb-crumb": true, "data-pyric-current": isCurrent ? '' : undefined, "aria-current": isCurrent ? 'page' : undefined, onClick: () => onNavigate(crumb.path), children: crumb.label })] }, crumb.path));
+                        })] }), _jsx("button", { type: "button", "data-rtdb-path-edit": true, "aria-label": "Edit path", title: "Edit path", onClick: () => setEditing(true), children: _jsx("svg", { "aria-hidden": true, viewBox: "0 0 16 16", width: "12", height: "12", fill: "currentColor", children: _jsx("path", { d: "M11.7 1.3a1 1 0 0 1 1.4 0l1.6 1.6a1 1 0 0 1 0 1.4l-8.5 8.5-3.4 1.1a.5.5 0 0 1-.63-.63l1.1-3.4 8.43-8.57ZM10.9 3.5l1.6 1.6 1.2-1.2-1.6-1.6-1.2 1.2Z" }) }) })] })) }));
+}
+//# sourceMappingURL=RtdbPathBar.js.map

package/dist/rtdb/components/RtdbPathBar.js.map

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

package/dist/rtdb/components/RtdbTree.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+import type { RtdbApi } from '../rtdbApi.js';
+import type { RtdbTreeController } from '../hooks/useRtdbTree.js';
+export interface RtdbTreeProps {
+    /** The live tree controller from `useRtdbTree`. */
+    tree: RtdbTreeController;
+    /** Mutation backend (admin lens in Studio). */
+    api: RtdbApi;
+    /** Key-click navigation: re-roots the viewer at the clicked node (wire to
+     *  the same path state as the path bar). */
+    onNavigate?: (path: string) => void;
+    /** Label for the view-root row when the root is `'/'` — the database /
+     *  instance identity. Default `'/'`. */
+    rootLabel?: ReactNode;
+    className?: string;
+}
+/**
+ * The RTDB data tree — the interaction form of the Firebase console /
+ * firebase-tools-ui database viewer (clean-room adaptation of the
+ * NodeContainer/NodeParent/NodeLeaf split):
+ *
+ * - parents render a caret (expand/collapse), leaves a `key: value` row;
+ * - keys navigate (re-root the view), carets only toggle;
+ * - hover/focus reveals per-node actions: `+` add child, `×` delete —
+ *   delete flips to an INLINE two-step confirm (no modal, C3);
+ * - leaf values are click-to-edit inline (type select: string / number /
+ *   boolean / JSON);
+ * - wide levels page at `tree.pageSize` with a "show more" row (the console's
+ *   form — see `reducers/tree.ts` for why paging over virtualization).
+ *
+ * Headless: consumers style `[data-pyric-ui="rtdb-tree"]` and the
+ * `data-rtdb-*` attributes (`node`, `row`, `caret`, `key`, `sep`, `value`,
+ * `actions`, `action-add`, `action-delete`, `confirm`, `editor`, `children`,
+ * `show-more`, `error`, `loading`). An empty root renders the console's
+ * classic form — `<root>: null` — not an instructional empty state.
+ */
+export declare function RtdbTree({ tree, api, onNavigate, rootLabel, className }: RtdbTreeProps): import("react").JSX.Element;
+//# sourceMappingURL=RtdbTree.d.ts.map

package/dist/rtdb/components/RtdbTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RtdbTree.d.ts","sourceRoot":"","sources":["../../../src/rtdb/components/RtdbTree.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiBlE,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,IAAI,EAAE,kBAAkB,CAAC;IACzB,+CAA+C;IAC/C,GAAG,EAAE,OAAO,CAAC;IACb;gDAC4C;IAC5C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;4CACwC;IACxC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,SAAe,EAAE,SAAS,EAAE,EAAE,aAAa,+BA0B5F"}

package/dist/rtdb/components/RtdbTree.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { RTDB_EDITOR_TYPES, coerceRtdbEditorValue, formatRtdbEditorValue, inferRtdbEditorType, rtdbKeyInputError, } from '../editor.js';
+import { formatRtdbValueLabel, hasRtdbChildren, joinRtdbPath, rtdbPathSegments, rtdbValueKind, } from '../values.js';
+/**
+ * The RTDB data tree — the interaction form of the Firebase console /
+ * firebase-tools-ui database viewer (clean-room adaptation of the
+ * NodeContainer/NodeParent/NodeLeaf split):
+ *
+ * - parents render a caret (expand/collapse), leaves a `key: value` row;
+ * - keys navigate (re-root the view), carets only toggle;
+ * - hover/focus reveals per-node actions: `+` add child, `×` delete —
+ *   delete flips to an INLINE two-step confirm (no modal, C3);
+ * - leaf values are click-to-edit inline (type select: string / number /
+ *   boolean / JSON);
+ * - wide levels page at `tree.pageSize` with a "show more" row (the console's
+ *   form — see `reducers/tree.ts` for why paging over virtualization).
+ *
+ * Headless: consumers style `[data-pyric-ui="rtdb-tree"]` and the
+ * `data-rtdb-*` attributes (`node`, `row`, `caret`, `key`, `sep`, `value`,
+ * `actions`, `action-add`, `action-delete`, `confirm`, `editor`, `children`,
+ * `show-more`, `error`, `loading`). An empty root renders the console's
+ * classic form — `<root>: null` — not an instructional empty state.
+ */
+export function RtdbTree({ tree, api, onNavigate, rootLabel = '/', className }) {
+    const { state } = tree;
+    const rootSegments = rtdbPathSegments(state.path);
+    const rootKey = rootSegments.length === 0 ? rootLabel : rootSegments[rootSegments.length - 1];
+    return (_jsx("div", { className: className, "data-pyric-ui": "rtdb-tree", children: state.status === 'loading' ? (_jsx("p", { "data-rtdb-loading": true, children: "Loading\u2026" })) : state.status === 'error' ? (_jsx("p", { role: "alert", "data-rtdb-error": true, children: state.error })) : (_jsx(Node, { tree: tree, api: api, onNavigate: onNavigate, path: state.path, label: rootKey, isViewRoot: true })) }));
+}
+function Node({ tree, api, onNavigate, path, label, isViewRoot }) {
+    const value = tree.valueAt(path);
+    const isParent = hasRtdbChildren(value);
+    const expanded = tree.isExpanded(path);
+    const [adding, setAdding] = useState(false);
+    const [editing, setEditing] = useState(false);
+    const [confirming, setConfirming] = useState(false);
+    const [actionError, setActionError] = useState(null);
+    const run = async (op, done) => {
+        try {
+            await op();
+            setActionError(null);
+            done();
+        }
+        catch (e) {
+            setActionError(e instanceof Error ? e.message : String(e));
+        }
+    };
+    const openAdd = () => {
+        setAdding(true);
+        setConfirming(false);
+        if (isParent && !expanded)
+            tree.toggle(path);
+    };
+    const children = isParent && expanded ? tree.childrenAt(path) : null;
+    return (_jsxs("div", { "data-rtdb-node": true, "data-rtdb-kind": isParent ? 'parent' : 'leaf', "data-rtdb-view-root": isViewRoot ? '' : undefined, "data-rtdb-expanded": isParent && expanded ? '' : undefined, children: [_jsxs("div", { "data-rtdb-row": true, children: [isParent && !isViewRoot ? (_jsx("button", { type: "button", "data-rtdb-caret": true, "aria-expanded": expanded, "aria-label": expanded ? 'Collapse' : 'Expand', onClick: () => tree.toggle(path), children: _jsx("svg", { "aria-hidden": true, viewBox: "0 0 8 8", width: "8", height: "8", fill: "currentColor", children: _jsx("path", { d: "M1 0l6 4-6 4z" }) }) })) : (_jsx("span", { "aria-hidden": true, "data-rtdb-caret-spacer": true })), _jsx("button", { type: "button", "data-rtdb-key": true, "aria-label": "Key name", onClick: () => onNavigate?.(path), children: label }), !isParent ? (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": true, "data-rtdb-sep": true, children: ":" }), _jsx("button", { type: "button", "data-rtdb-value": true, "data-rtdb-type": rtdbValueKind(value), title: "Edit value", onClick: () => {
+                                    setEditing(true);
+                                    setConfirming(false);
+                                }, children: formatRtdbValueLabel(value) })] })) : null, _jsx("span", { "data-rtdb-actions": true, children: confirming ? (_jsxs("span", { "data-rtdb-confirm": true, children: [_jsxs("span", { "data-rtdb-confirm-label": true, children: ["Delete", isParent ? ' subtree' : '', "?"] }), _jsx("button", { type: "button", "data-rtdb-confirm-yes": true, onClick: () => void run(() => api.remove(path), () => setConfirming(false)), children: "Delete" }), _jsx("button", { type: "button", "data-rtdb-confirm-no": true, onClick: () => setConfirming(false), children: "Cancel" })] })) : (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", "data-rtdb-action-add": true, "aria-label": `Add child to ${pathLabel(path)}`, title: "Add child", onClick: openAdd, children: "+" }), _jsx("button", { type: "button", "data-rtdb-action-delete": true, "aria-label": `Delete ${pathLabel(path)}`, title: "Delete", onClick: () => setConfirming(true), children: "\u00D7" })] })) })] }), actionError ? (_jsx("p", { role: "alert", "data-rtdb-error": true, children: actionError })) : null, editing ? (_jsx(ValueEditor, { initialType: inferRtdbEditorType(value), initialText: formatRtdbEditorValue(value, inferRtdbEditorType(value)), submitLabel: "Save", onCancel: () => setEditing(false), onSubmit: (next) => run(() => api.set(path, next), () => setEditing(false)) })) : null, adding ? (_jsx(ValueEditor, { withKey: true, initialType: "string", initialText: "", submitLabel: "Add", onCancel: () => setAdding(false), onSubmit: (next, key) => run(() => api.set(joinRtdbPath(path, key), next), () => setAdding(false)) })) : null, children ? (_jsxs("ul", { "data-rtdb-children": true, children: [children.entries.map(([key]) => (_jsx("li", { children: _jsx(Node, { tree: tree, api: api, onNavigate: onNavigate, path: joinRtdbPath(path, key), label: key }) }, key))), children.hiddenCount > 0 ? (_jsx("li", { "data-rtdb-show-more-item": true, children: _jsxs("button", { type: "button", "data-rtdb-show-more": true, onClick: () => tree.showMore(path), children: ["Show more (", children.hiddenCount, " hidden)"] }) })) : null] })) : null] }));
+}
+/** Last segment for aria labels; `'/'` reads as "root". */
+function pathLabel(path) {
+    const segments = rtdbPathSegments(path);
+    return segments.length === 0 ? 'root' : segments[segments.length - 1];
+}
+/**
+ * Inline key/value editor row (add + edit flows). Escape cancels.
+ *
+ * The key + value fields are UNCONTROLLED and read at submit — validation
+ * happens on submit (errors render inline), so per-keystroke state buys
+ * nothing. Only the type select is controlled (it decides whether the value
+ * control is a text input or a true/false select).
+ */
+function ValueEditor({ withKey, initialType, initialText, submitLabel, onSubmit, onCancel, }) {
+    const keyRef = useRef(null);
+    const valueRef = useRef(null);
+    const [type, setType] = useState(initialType);
+    const [error, setError] = useState(null);
+    const submit = (e) => {
+        e.preventDefault();
+        const key = keyRef.current?.value ?? '';
+        if (withKey) {
+            const keyError = rtdbKeyInputError(key);
+            if (keyError) {
+                setError(keyError);
+                return;
+            }
+        }
+        const coerced = coerceRtdbEditorValue(type, valueRef.current?.value ?? '');
+        if (!coerced.ok) {
+            setError(coerced.error);
+            return;
+        }
+        setError(null);
+        void onSubmit(coerced.value, withKey ? key.trim() : undefined);
+    };
+    const onEscape = (e) => {
+        if (e.key === 'Escape')
+            onCancel();
+    };
+    return (_jsxs("form", { "data-rtdb-editor": true, onSubmit: submit, children: [withKey ? (_jsx("input", { ref: keyRef, "data-rtdb-editor-key": true, "aria-label": "Child key", placeholder: "key", autoFocus: true, onKeyDown: onEscape, spellCheck: false })) : null, _jsx("select", { "data-rtdb-editor-type": true, "aria-label": "Value type", value: type, onChange: (e) => setType(e.currentTarget.value), onKeyDown: onEscape, children: RTDB_EDITOR_TYPES.map((t) => (_jsx("option", { value: t, children: t }, t))) }), type === 'boolean' ? (_jsxs("select", { ref: valueRef, "data-rtdb-editor-value": true, "aria-label": "Value", defaultValue: initialText.trim().toLowerCase() === 'true' ? 'true' : 'false', onKeyDown: onEscape, children: [_jsx("option", { value: "true", children: "true" }), _jsx("option", { value: "false", children: "false" })] })) : (_jsx("input", { ref: valueRef, "data-rtdb-editor-value": true, "aria-label": "Value", placeholder: type === 'json' ? '{ "key": "value" }' : 'value', autoFocus: !withKey, defaultValue: initialText, onKeyDown: onEscape, spellCheck: false })), _jsx("button", { type: "submit", "data-rtdb-editor-save": true, children: submitLabel }), _jsx("button", { type: "button", "data-rtdb-editor-cancel": true, onClick: onCancel, children: "Cancel" }), error ? (_jsx("span", { role: "alert", "data-rtdb-editor-error": true, children: error })) : null] }));
+}
+//# sourceMappingURL=RtdbTree.js.map

package/dist/rtdb/components/RtdbTree.js.map

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

package/dist/rtdb/editor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Inline value-editor logic (pure): the type select + text input pair used by
+ * the tree's click-to-edit and add-child rows. Four author-facing types cover
+ * every RTDB value: string / number / boolean scalars, and `json` for
+ * objects/arrays/null (or any hand-written literal).
+ */
+export type RtdbEditorType = 'string' | 'number' | 'boolean' | 'json';
+export declare const RTDB_EDITOR_TYPES: readonly RtdbEditorType[];
+/** The editor type a value opens under when clicked. */
+export declare function inferRtdbEditorType(value: unknown): RtdbEditorType;
+/** Seed the editor's text field from the current value under a type. */
+export declare function formatRtdbEditorValue(value: unknown, type: RtdbEditorType): string;
+/** Why a typed child key is unusable, or `null` when it's fine. RTDB forbids
+ *  `. $ # [ ] /` in keys (a `/` would silently create a nested path). */
+export declare function rtdbKeyInputError(key: string): string | null;
+export type RtdbEditorResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+/** Coerce the editor's text under the selected type, or explain why not. */
+export declare function coerceRtdbEditorValue(type: RtdbEditorType, text: string): RtdbEditorResult;
+//# sourceMappingURL=editor.d.ts.map

package/dist/rtdb/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/rtdb/editor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtE,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAKtD,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAWlE;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAIlF;AAED;yEACyE;AACzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA2B1F"}

package/dist/rtdb/editor.js

@@ -0,0 +1,79 @@
+/**
+ * Inline value-editor logic (pure): the type select + text input pair used by
+ * the tree's click-to-edit and add-child rows. Four author-facing types cover
+ * every RTDB value: string / number / boolean scalars, and `json` for
+ * objects/arrays/null (or any hand-written literal).
+ */
+export const RTDB_EDITOR_TYPES = [
+    'string',
+    'number',
+    'boolean',
+    'json',
+];
+/** The editor type a value opens under when clicked. */
+export function inferRtdbEditorType(value) {
+    switch (typeof value) {
+        case 'string':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        default:
+            return 'json';
+    }
+}
+/** Seed the editor's text field from the current value under a type. */
+export function formatRtdbEditorValue(value, type) {
+    if (type === 'json')
+        return JSON.stringify(value ?? null);
+    if (value === null || value === undefined)
+        return '';
+    return String(value);
+}
+/** Why a typed child key is unusable, or `null` when it's fine. RTDB forbids
+ *  `. $ # [ ] /` in keys (a `/` would silently create a nested path). */
+export function rtdbKeyInputError(key) {
+    if (key.trim().length === 0)
+        return 'Enter a key.';
+    const bad = key.match(/[.$#[\]/]/);
+    if (bad)
+        return `Keys can't contain "${bad[0]}".`;
+    return null;
+}
+/** Coerce the editor's text under the selected type, or explain why not. */
+export function coerceRtdbEditorValue(type, text) {
+    switch (type) {
+        case 'string':
+            return { ok: true, value: text };
+        case 'number': {
+            const trimmed = text.trim();
+            if (trimmed.length === 0)
+                return { ok: false, error: 'Enter a number.' };
+            const n = Number(trimmed);
+            if (Number.isNaN(n))
+                return { ok: false, error: `"${text}" is not a number.` };
+            return { ok: true, value: n };
+        }
+        case 'boolean': {
+            const t = text.trim().toLowerCase();
+            if (t === 'true')
+                return { ok: true, value: true };
+            if (t === 'false')
+                return { ok: true, value: false };
+            return { ok: false, error: 'Enter true or false.' };
+        }
+        case 'json': {
+            const t = text.trim();
+            if (t.length === 0)
+                return { ok: true, value: null };
+            try {
+                return { ok: true, value: JSON.parse(t) };
+            }
+            catch (e) {
+                return { ok: false, error: e instanceof Error ? e.message : 'Invalid JSON.' };
+            }
+        }
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/rtdb/editor.js.map

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

package/dist/rtdb/hooks/useRtdbTree.d.ts

@@ -0,0 +1,31 @@
+import type { RtdbApi } from '../rtdbApi.js';
+import { type RtdbTreeState, type RtdbVisibleChildren } from '../reducers/tree.js';
+/** Console-style child paging (Firebase console shows 50, then "show more"). */
+export declare const RTDB_DEFAULT_PAGE_SIZE = 50;
+export interface UseRtdbTreeOptions {
+    /** Children rendered per level before "show more". Default 50. */
+    pageSize?: number;
+}
+/**
+ * Everything a tree view needs: the reducer state plus path-addressed
+ * selectors and the expansion/paging commands. All paths are ABSOLUTE
+ * database paths.
+ */
+export interface RtdbTreeController {
+    state: RtdbTreeState;
+    pageSize: number;
+    valueAt(path: string): unknown;
+    isExpanded(path: string): boolean;
+    childrenAt(path: string): RtdbVisibleChildren;
+    toggle(path: string): void;
+    showMore(path: string): void;
+}
+/**
+ * Live tree state for the RTDB viewer: subscribes to the value at the view
+ * root `path` (realtime — every write re-delivers the subtree) and runs the
+ * expansion/paging reducer over it. See `reducers/tree.ts` for the
+ * one-subscription-per-view-root loading strategy and why expansion is a
+ * pure render toggle rather than a fetch.
+ */
+export declare function useRtdbTree(api: RtdbApi, path: string, options?: UseRtdbTreeOptions): RtdbTreeController;
+//# sourceMappingURL=useRtdbTree.d.ts.map

package/dist/rtdb/hooks/useRtdbTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRtdbTree.d.ts","sourceRoot":"","sources":["../../../src/rtdb/hooks/useRtdbTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,kBAAkB,CAyDpB"}

package/dist/rtdb/hooks/useRtdbTree.js

@@ -0,0 +1,49 @@
+import { useCallback, useEffect, useMemo, useReducer } from 'react';
+import { normalizeRtdbPath } from '../values.js';
+import { initialRtdbTree, isRtdbPathExpanded, rtdbTreeReducer, rtdbTreeValueAt, rtdbVisibleChildren, } from '../reducers/tree.js';
+/** Console-style child paging (Firebase console shows 50, then "show more"). */
+export const RTDB_DEFAULT_PAGE_SIZE = 50;
+/**
+ * Live tree state for the RTDB viewer: subscribes to the value at the view
+ * root `path` (realtime — every write re-delivers the subtree) and runs the
+ * expansion/paging reducer over it. See `reducers/tree.ts` for the
+ * one-subscription-per-view-root loading strategy and why expansion is a
+ * pure render toggle rather than a fetch.
+ */
+export function useRtdbTree(api, path, options = {}) {
+    const pageSize = options.pageSize ?? RTDB_DEFAULT_PAGE_SIZE;
+    const normalized = normalizeRtdbPath(path);
+    const [state, dispatch] = useReducer(rtdbTreeReducer, normalized, initialRtdbTree);
+    // Keep the reducer's view root in lockstep with the prop BEFORE the
+    // subscription effect below re-runs, so a snapshot for the new root never
+    // lands on the old root's state.
+    if (state.path !== normalized) {
+        dispatch({ type: 'navigate', path: normalized });
+    }
+    useEffect(() => {
+        let cancelled = false;
+        const unsubscribe = api.subscribeValue(normalized, (value) => {
+            if (!cancelled)
+                dispatch({ type: 'value', path: normalized, value });
+        }, (err) => {
+            if (!cancelled) {
+                dispatch({
+                    type: 'error',
+                    path: normalized,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        });
+        return () => {
+            cancelled = true;
+            unsubscribe();
+        };
+    }, [api, normalized]);
+    const valueAt = useCallback((p) => rtdbTreeValueAt(state, p), [state]);
+    const isExpanded = useCallback((p) => isRtdbPathExpanded(state, p), [state]);
+    const childrenAt = useCallback((p) => rtdbVisibleChildren(state, p, pageSize), [state, pageSize]);
+    const toggle = useCallback((p) => dispatch({ type: 'toggle', path: p }), []);
+    const showMore = useCallback((p) => dispatch({ type: 'show-more', path: p, pageSize }), [pageSize]);
+    return useMemo(() => ({ state, pageSize, valueAt, isExpanded, childrenAt, toggle, showMore }), [state, pageSize, valueAt, isExpanded, childrenAt, toggle, showMore]);
+}
+//# sourceMappingURL=useRtdbTree.js.map

package/dist/rtdb/hooks/useRtdbTree.js.map

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

package/dist/rtdb/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@pyric/ui/rtdb` — the headless RTDB data viewer, in the Firebase console /
+ * firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+ * over an expandable tree with inline add/edit/delete affordances. Follows
+ * this package's firestore/auth/storage split: pure logic + hooks +
+ * unstyled components on `data-*` styling contracts; the consumer (Studio)
+ * brings the CSS and the backend bundle ({@link RtdbApi}).
+ */
+export { normalizeRtdbPath, rtdbPathSegments, joinRtdbPath, parentRtdbPath, relativeRtdbPath, isRtdbObjectValue, hasRtdbChildren, rtdbChildEntries, rtdbValueAt, formatRtdbJson, parseRtdbJson, rtdbValueKind, previewRtdbValue, normalizeRtdbSnapshotValue, formatRtdbValueLabel, } from './values.js';
+export { parseRtdbPathInput, rtdbCrumbs, type RtdbCrumb } from './pathInput.js';
+export { RTDB_EDITOR_TYPES, inferRtdbEditorType, formatRtdbEditorValue, coerceRtdbEditorValue, rtdbKeyInputError, type RtdbEditorType, type RtdbEditorResult, } from './editor.js';
+export type { RtdbApi } from './rtdbApi.js';
+export { initialRtdbTree, rtdbTreeReducer, rtdbTreeValueAt, isRtdbPathExpanded, rtdbVisibleChildren, type RtdbTreeState, type RtdbTreeAction, type RtdbVisibleChildren, } from './reducers/tree.js';
+export { useRtdbTree, RTDB_DEFAULT_PAGE_SIZE, type UseRtdbTreeOptions, type RtdbTreeController, } from './hooks/useRtdbTree.js';
+export { RtdbPathBar, type RtdbPathBarProps } from './components/RtdbPathBar.js';
+export { RtdbTree, type RtdbTreeProps } from './components/RtdbTree.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rtdb/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC"}