@pyric/ui 0.1.0-alpha.7

package/dist/rtdb/index.js

@@ -0,0 +1,21 @@
+/**
+ * `@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}).
+ */
+// Pure path + value helpers.
+export { normalizeRtdbPath, rtdbPathSegments, joinRtdbPath, parentRtdbPath, relativeRtdbPath, isRtdbObjectValue, hasRtdbChildren, rtdbChildEntries, rtdbValueAt, formatRtdbJson, parseRtdbJson, rtdbValueKind, previewRtdbValue, normalizeRtdbSnapshotValue, formatRtdbValueLabel, } from './values.js';
+// Path-bar input parsing + crumb derivation.
+export { parseRtdbPathInput, rtdbCrumbs } from './pathInput.js';
+// Inline value-editor logic.
+export { RTDB_EDITOR_TYPES, inferRtdbEditorType, formatRtdbEditorValue, coerceRtdbEditorValue, rtdbKeyInputError, } from './editor.js';
+// Tree state (pure reducer + selectors).
+export { initialRtdbTree, rtdbTreeReducer, rtdbTreeValueAt, isRtdbPathExpanded, rtdbVisibleChildren, } from './reducers/tree.js';
+// Hook + components.
+export { useRtdbTree, RTDB_DEFAULT_PAGE_SIZE, } from './hooks/useRtdbTree.js';
+export { RtdbPathBar } from './components/RtdbPathBar.js';
+export { RtdbTree } from './components/RtdbTree.js';
+//# sourceMappingURL=index.js.map

package/dist/rtdb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rtdb/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6BAA6B;AAC7B,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;AAErB,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAEhF,6BAA6B;AAC7B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GAGlB,MAAM,aAAa,CAAC;AAKrB,yCAAyC;AACzC,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,oBAAoB,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EACL,WAAW,EACX,sBAAsB,GAGvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC"}

package/dist/rtdb/pathInput.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Editable path-bar logic (pure): parse what a user TYPES OR PASTES into the
+ * path input, and derive the clickable crumb list for display mode. The
+ * interaction form follows the Firebase console / firebase-tools-ui database
+ * viewer's editable breadcrumb bar (clean-room adaptation — behavior only).
+ */
+/**
+ * Normalize raw path-input text to a database path. Tolerant of what people
+ * paste into a database URL bar:
+ *   - a plain path, with or without the leading slash (`rooms/r1`, `/rooms`)
+ *   - a full URL (`https://x.firebaseio.com/rooms/r1` → `/rooms/r1`)
+ *   - repeated/trailing slashes, surrounding whitespace
+ *   - a `?query` / `#hash` tail (dropped)
+ * Empty input is the root.
+ */
+export declare function parseRtdbPathInput(raw: string): string;
+export interface RtdbCrumb {
+    /** The path segment to display. */
+    label: string;
+    /** Absolute database path this crumb navigates to. */
+    path: string;
+}
+/**
+ * The non-root crumbs for a path, in order. `'/'` yields `[]` — the root crumb
+ * is the caller's (it carries the database/instance label, not a segment).
+ */
+export declare function rtdbCrumbs(path: string): RtdbCrumb[];
+//# sourceMappingURL=pathInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathInput.d.ts","sourceRoot":"","sources":["../../src/rtdb/pathInput.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAMpD"}

package/dist/rtdb/pathInput.js

@@ -0,0 +1,40 @@
+/**
+ * Editable path-bar logic (pure): parse what a user TYPES OR PASTES into the
+ * path input, and derive the clickable crumb list for display mode. The
+ * interaction form follows the Firebase console / firebase-tools-ui database
+ * viewer's editable breadcrumb bar (clean-room adaptation — behavior only).
+ */
+import { normalizeRtdbPath, rtdbPathSegments } from './values.js';
+/**
+ * Normalize raw path-input text to a database path. Tolerant of what people
+ * paste into a database URL bar:
+ *   - a plain path, with or without the leading slash (`rooms/r1`, `/rooms`)
+ *   - a full URL (`https://x.firebaseio.com/rooms/r1` → `/rooms/r1`)
+ *   - repeated/trailing slashes, surrounding whitespace
+ *   - a `?query` / `#hash` tail (dropped)
+ * Empty input is the root.
+ */
+export function parseRtdbPathInput(raw) {
+    let text = raw.trim();
+    if (text.length === 0)
+        return '/';
+    // A pasted absolute URL: strip `scheme://host[:port]`.
+    const url = /^[a-z][a-z0-9+.-]*:\/\/[^/?#]+/i.exec(text);
+    if (url)
+        text = text.slice(url[0].length);
+    // Drop a query/hash tail (URL bars carry them; database paths do not).
+    text = text.replace(/[?#].*$/, '');
+    return normalizeRtdbPath(text);
+}
+/**
+ * The non-root crumbs for a path, in order. `'/'` yields `[]` — the root crumb
+ * is the caller's (it carries the database/instance label, not a segment).
+ */
+export function rtdbCrumbs(path) {
+    const segments = rtdbPathSegments(path);
+    return segments.map((label, i) => ({
+        label,
+        path: `/${segments.slice(0, i + 1).join('/')}`,
+    }));
+}
+//# sourceMappingURL=pathInput.js.map

package/dist/rtdb/pathInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathInput.js","sourceRoot":"","sources":["../../src/rtdb/pathInput.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAClC,uDAAuD;IACvD,MAAM,GAAG,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,GAAG;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,KAAK;QACL,IAAI,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;KAC/C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/rtdb/reducers/tree.d.ts

@@ -0,0 +1,86 @@
+/**
+ * RTDB viewer tree state (pure reducer). The interaction form is the Firebase
+ * console / firebase-tools-ui data viewer: one view root (set by the path
+ * bar), expandable/collapsible descendants, and per-level paging for wide
+ * child lists.
+ *
+ * DATA-LOADING STRATEGY (documented decision): the worker protocol exposes
+ * `rtdb.get` / value subscriptions per PATH but no shallow or depth-limited
+ * reads — a read at a path always ships that path's WHOLE subtree over the
+ * MessagePort. A per-expand fetch would therefore re-ship data the view-root
+ * read already delivered. So the viewer holds ONE live value subscription at
+ * the view root (realtime by construction) and makes RENDERING lazy instead:
+ * nodes below the root start collapsed and mount nothing until expanded, and
+ * an expanded level renders at most `pageSize` children until "show more"
+ * (console-style paging at 50, chosen over virtualization for its simplicity —
+ * it bounds the mounted DOM the same way). Cost is bounded by navigating the
+ * view root deeper, which is the path bar's job.
+ */
+export interface RtdbTreeState {
+    /** The view root — the absolute database path the path bar points at. */
+    path: string;
+    /** `loading` until the first snapshot after a navigate; then `live`. */
+    status: 'loading' | 'live' | 'error';
+    /** The subtree value AT `path` (plain JSON; `null` = nothing there). */
+    value: unknown;
+    error: string | null;
+    /** Expanded descendant paths (absolute). The view root itself is always
+     *  expanded and is never in this set. */
+    expanded: Record<string, true>;
+    /** Per-path shown-children override (absolute path → count). Absent means
+     *  one page. */
+    pages: Record<string, number>;
+}
+export type RtdbTreeAction = 
+/** Path bar navigation: reset to a new view root. */
+{
+    type: 'navigate';
+    path: string;
+}
+/** A value snapshot arrived. `path` is the subscription's view root — a
+ *  snapshot from a superseded subscription (its path no longer the state's)
+ *  is ignored. */
+ | {
+    type: 'value';
+    path: string;
+    value: unknown;
+}
+/** The view-root subscription failed (same `path` guard as `value`). */
+ | {
+    type: 'error';
+    path: string;
+    message: string;
+} | {
+    type: 'toggle';
+    path: string;
+} | {
+    type: 'expand';
+    path: string;
+} | {
+    type: 'collapse';
+    path: string;
+}
+/** Reveal one more page of children at `path`. */
+ | {
+    type: 'show-more';
+    path: string;
+    pageSize: number;
+};
+export declare function initialRtdbTree(path: string): RtdbTreeState;
+/** The subtree value at an ABSOLUTE database path, resolved against the
+ *  loaded view-root value. `null` outside the view root. */
+export declare function rtdbTreeValueAt(state: RtdbTreeState, path: string): unknown;
+/** Is this absolute path expanded? The view root always is. */
+export declare function isRtdbPathExpanded(state: RtdbTreeState, path: string): boolean;
+export interface RtdbVisibleChildren {
+    /** The children to render, in key order, capped at the shown count. */
+    entries: Array<[string, unknown]>;
+    /** Total direct children at this path. */
+    total: number;
+    /** How many more "show more" would reveal (0 = all shown). */
+    hiddenCount: number;
+}
+/** The page-capped child list at an absolute path (console pages at 50). */
+export declare function rtdbVisibleChildren(state: RtdbTreeState, path: string, pageSize: number): RtdbVisibleChildren;
+export declare function rtdbTreeReducer(state: RtdbTreeState, action: RtdbTreeAction): RtdbTreeState;
+//# sourceMappingURL=tree.d.ts.map

package/dist/rtdb/reducers/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/rtdb/reducers/tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;6CACyC;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B;oBACgB;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc;AACxB,qDAAqD;AACnD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACpC;;kBAEkB;GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AACjD,wEAAwE;GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACpC,kDAAkD;GAChD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAS3D;AAED;4DAC4D;AAC5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG9E;AAED,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,mBAAmB,CAWrB;AAqBD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,GACrB,aAAa,CA0Df"}

package/dist/rtdb/reducers/tree.js

@@ -0,0 +1,131 @@
+/**
+ * RTDB viewer tree state (pure reducer). The interaction form is the Firebase
+ * console / firebase-tools-ui data viewer: one view root (set by the path
+ * bar), expandable/collapsible descendants, and per-level paging for wide
+ * child lists.
+ *
+ * DATA-LOADING STRATEGY (documented decision): the worker protocol exposes
+ * `rtdb.get` / value subscriptions per PATH but no shallow or depth-limited
+ * reads — a read at a path always ships that path's WHOLE subtree over the
+ * MessagePort. A per-expand fetch would therefore re-ship data the view-root
+ * read already delivered. So the viewer holds ONE live value subscription at
+ * the view root (realtime by construction) and makes RENDERING lazy instead:
+ * nodes below the root start collapsed and mount nothing until expanded, and
+ * an expanded level renders at most `pageSize` children until "show more"
+ * (console-style paging at 50, chosen over virtualization for its simplicity —
+ * it bounds the mounted DOM the same way). Cost is bounded by navigating the
+ * view root deeper, which is the path bar's job.
+ */
+import { hasRtdbChildren, normalizeRtdbPath, normalizeRtdbSnapshotValue, relativeRtdbPath, rtdbChildEntries, rtdbValueAt, } from '../values.js';
+export function initialRtdbTree(path) {
+    return {
+        path: normalizeRtdbPath(path),
+        status: 'loading',
+        value: null,
+        error: null,
+        expanded: {},
+        pages: {},
+    };
+}
+/** The subtree value at an ABSOLUTE database path, resolved against the
+ *  loaded view-root value. `null` outside the view root. */
+export function rtdbTreeValueAt(state, path) {
+    const rel = relativeRtdbPath(state.path, path);
+    return rel === null ? null : rtdbValueAt(state.value, rel);
+}
+/** Is this absolute path expanded? The view root always is. */
+export function isRtdbPathExpanded(state, path) {
+    const normalized = normalizeRtdbPath(path);
+    return normalized === state.path || state.expanded[normalized] === true;
+}
+/** The page-capped child list at an absolute path (console pages at 50). */
+export function rtdbVisibleChildren(state, path, pageSize) {
+    const entries = rtdbChildEntries(rtdbTreeValueAt(state, path));
+    const shown = Math.min(entries.length, state.pages[normalizeRtdbPath(path)] ?? pageSize);
+    return {
+        entries: entries.slice(0, shown),
+        total: entries.length,
+        hiddenCount: entries.length - shown,
+    };
+}
+/** Keep only entries whose path still resolves to a node WITH children under
+ *  the new value — a removed or scalar-ified node can't stay expanded/paged. */
+function pruneByValue(record, state) {
+    const next = {};
+    let changed = false;
+    for (const [path, v] of Object.entries(record)) {
+        const rel = relativeRtdbPath(state.path, path);
+        if (rel !== null && hasRtdbChildren(rtdbValueAt(state.value, rel))) {
+            next[path] = v;
+        }
+        else {
+            changed = true;
+        }
+    }
+    return changed ? next : record;
+}
+export function rtdbTreeReducer(state, action) {
+    switch (action.type) {
+        case 'navigate': {
+            const path = normalizeRtdbPath(action.path);
+            // Re-navigating to the current root keeps the loaded value + expansion.
+            if (path === state.path)
+                return state;
+            return initialRtdbTree(path);
+        }
+        case 'value': {
+            if (normalizeRtdbPath(action.path) !== state.path)
+                return state;
+            const next = {
+                ...state,
+                status: 'live',
+                // RTDB semantics at the ingestion seam: an empty object IS null (an
+                // empty database reads back as `{}`), so the tree never holds a
+                // childless object that would render as a scalar leaf.
+                value: normalizeRtdbSnapshotValue(action.value),
+                error: null,
+            };
+            // UPDATE-MERGE: a live snapshot keeps expansion/paging for surviving
+            // paths and prunes state for nodes that vanished or became scalars.
+            next.expanded = pruneByValue(state.expanded, next);
+            next.pages = pruneByValue(state.pages, next);
+            return next;
+        }
+        case 'error':
+            if (normalizeRtdbPath(action.path) !== state.path)
+                return state;
+            return { ...state, status: 'error', error: action.message };
+        case 'expand': {
+            const path = normalizeRtdbPath(action.path);
+            if (path === state.path || state.expanded[path])
+                return state;
+            // LAZY RENDER: expanding only flips the flag — children mount from the
+            // already-loaded subtree (see the data-loading strategy note above).
+            return { ...state, expanded: { ...state.expanded, [path]: true } };
+        }
+        case 'collapse': {
+            const path = normalizeRtdbPath(action.path);
+            if (!state.expanded[path])
+                return state;
+            const expanded = { ...state.expanded };
+            delete expanded[path];
+            return { ...state, expanded };
+        }
+        case 'toggle': {
+            const path = normalizeRtdbPath(action.path);
+            return rtdbTreeReducer(state, {
+                type: state.expanded[path] ? 'collapse' : 'expand',
+                path,
+            });
+        }
+        case 'show-more': {
+            const path = normalizeRtdbPath(action.path);
+            const shown = state.pages[path] ?? action.pageSize;
+            return {
+                ...state,
+                pages: { ...state.pages, [path]: shown + action.pageSize },
+            };
+        }
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/rtdb/reducers/tree.js.map

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

package/dist/rtdb/rtdbApi.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The RTDB backend seam the viewer drives — an EXPLICIT bundle, not a context
+ * default. Unlike Firestore/Auth/Storage there is no in-process handle typed
+ * into `@pyric/ui`, so the consumer constructs the bundle and passes it to the
+ * hook/components directly (Studio wires it to the SharedWorker client's
+ * admin-lens ops; data views are always admin — PRINCIPLES M3).
+ */
+export interface RtdbApi {
+    /** Replace the value at `path` (`null` deletes, RTDB semantics). */
+    set(path: string, value: unknown): Promise<void>;
+    /** Delete the subtree at `path`. */
+    remove(path: string): Promise<void>;
+    /**
+     * Live value subscription at `path`: `next` fires with the subtree's plain
+     * JSON value (`null` when absent) on subscribe and after every change.
+     * Returns the unsubscribe.
+     */
+    subscribeValue(path: string, next: (value: unknown) => void, error?: (err: unknown) => void): () => void;
+}
+//# sourceMappingURL=rtdbApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rtdbApi.d.ts","sourceRoot":"","sources":["../../src/rtdb/rtdbApi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,oEAAoE;IACpE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,oCAAoC;IACpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;OAIG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAC9B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC7B,MAAM,IAAI,CAAC;CACf"}

package/dist/rtdb/rtdbApi.js

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

package/dist/rtdb/rtdbApi.js.map

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

package/dist/rtdb/values.d.ts

@@ -0,0 +1,44 @@
+/**
+ * RTDB path + value helpers (pure). Paths are ALWAYS normalized to the
+ * `'/'`-rooted form (`'/'` for the root, `'/a/b'` otherwise) so every module in
+ * this package — the tree reducer, the path bar, the viewer components — agrees
+ * on what a path is.
+ */
+export declare function normalizeRtdbPath(path: string): string;
+export declare function rtdbPathSegments(path: string): string[];
+export declare function joinRtdbPath(base: string, child: string): string;
+export declare function parentRtdbPath(path: string): string;
+/**
+ * The path of `target` RELATIVE to `base`, or `null` when `target` is not
+ * `base` or one of its descendants. `'/'` means "target IS base". Lets the
+ * tree address nodes by absolute database path while the loaded value sits at
+ * the view root.
+ */
+export declare function relativeRtdbPath(base: string, target: string): string | null;
+export declare function isRtdbObjectValue(value: unknown): value is Record<string, unknown>;
+/**
+ * Normalize a snapshot value to RTDB semantics before it enters tree state:
+ * an empty object IS null (RTDB has no empty containers — the server prunes
+ * them), so `{}` — and any object whose children all normalize away — becomes
+ * `null`. Without this, an empty database's root value `{}` fails
+ * `hasRtdbChildren` and renders as a scalar leaf (`String({})` →
+ * `"[object Object]"`). Reuses the input object when nothing changed.
+ */
+export declare function normalizeRtdbSnapshotValue(value: unknown): unknown;
+/** Leaf value text, console style: strings quoted, primitives literal.
+ *  Defensive on objects: never `String`-coerce (that's `[object Object]`) —
+ *  fall back to JSON. Object values should have been normalized/expanded away
+ *  before reaching a leaf label; this keeps the label honest if one slips in. */
+export declare function formatRtdbValueLabel(value: unknown): string;
+/** Does this value render as a PARENT node (has child keys)? RTDB has no true
+ *  arrays — an array is an object with numeric keys, and renders as one. */
+export declare function hasRtdbChildren(value: unknown): boolean;
+/** Child entries sorted RTDB-console style: numeric-aware key order
+ *  (`2` before `10`), then lexicographic. */
+export declare function rtdbChildEntries(value: unknown): Array<[string, unknown]>;
+export declare function rtdbValueAt(root: unknown, path: string): unknown;
+export declare function formatRtdbJson(value: unknown): string;
+export declare function parseRtdbJson(value: string): unknown;
+export declare function rtdbValueKind(value: unknown): string;
+export declare function previewRtdbValue(value: unknown): string;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/rtdb/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBlE;AAED;;;iFAGiF;AACjF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW3D;AAED;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED;6CAC6C;AAC7C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKzE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASvD"}

package/dist/rtdb/values.js

@@ -0,0 +1,143 @@
+/**
+ * RTDB path + value helpers (pure). Paths are ALWAYS normalized to the
+ * `'/'`-rooted form (`'/'` for the root, `'/a/b'` otherwise) so every module in
+ * this package — the tree reducer, the path bar, the viewer components — agrees
+ * on what a path is.
+ */
+export function normalizeRtdbPath(path) {
+    const segments = path.split('/').filter(Boolean);
+    return segments.length === 0 ? '/' : `/${segments.join('/')}`;
+}
+export function rtdbPathSegments(path) {
+    return normalizeRtdbPath(path).split('/').filter(Boolean);
+}
+export function joinRtdbPath(base, child) {
+    return normalizeRtdbPath([...rtdbPathSegments(base), ...child.split('/').filter(Boolean)].join('/'));
+}
+export function parentRtdbPath(path) {
+    const segments = rtdbPathSegments(path);
+    if (segments.length <= 1)
+        return '/';
+    return `/${segments.slice(0, -1).join('/')}`;
+}
+/**
+ * The path of `target` RELATIVE to `base`, or `null` when `target` is not
+ * `base` or one of its descendants. `'/'` means "target IS base". Lets the
+ * tree address nodes by absolute database path while the loaded value sits at
+ * the view root.
+ */
+export function relativeRtdbPath(base, target) {
+    const baseSegs = rtdbPathSegments(base);
+    const targetSegs = rtdbPathSegments(target);
+    if (targetSegs.length < baseSegs.length)
+        return null;
+    for (let i = 0; i < baseSegs.length; i++) {
+        if (targetSegs[i] !== baseSegs[i])
+            return null;
+    }
+    const rest = targetSegs.slice(baseSegs.length);
+    return rest.length === 0 ? '/' : `/${rest.join('/')}`;
+}
+export function isRtdbObjectValue(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Normalize a snapshot value to RTDB semantics before it enters tree state:
+ * an empty object IS null (RTDB has no empty containers — the server prunes
+ * them), so `{}` — and any object whose children all normalize away — becomes
+ * `null`. Without this, an empty database's root value `{}` fails
+ * `hasRtdbChildren` and renders as a scalar leaf (`String({})` →
+ * `"[object Object]"`). Reuses the input object when nothing changed.
+ */
+export function normalizeRtdbSnapshotValue(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== 'object')
+        return value;
+    const record = value;
+    let changed = false;
+    const next = {};
+    for (const [key, child] of Object.entries(record)) {
+        const normalized = normalizeRtdbSnapshotValue(child);
+        if (normalized === null) {
+            changed = true;
+            continue;
+        }
+        if (normalized !== child)
+            changed = true;
+        next[key] = normalized;
+    }
+    if (Object.keys(next).length === 0)
+        return null;
+    return changed ? next : value;
+}
+/** Leaf value text, console style: strings quoted, primitives literal.
+ *  Defensive on objects: never `String`-coerce (that's `[object Object]`) —
+ *  fall back to JSON. Object values should have been normalized/expanded away
+ *  before reaching a leaf label; this keeps the label honest if one slips in. */
+export function formatRtdbValueLabel(value) {
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'object') {
+        try {
+            return JSON.stringify(value) ?? 'null';
+        }
+        catch {
+            return 'null';
+        }
+    }
+    return String(value);
+}
+/** Does this value render as a PARENT node (has child keys)? RTDB has no true
+ *  arrays — an array is an object with numeric keys, and renders as one. */
+export function hasRtdbChildren(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    return Object.keys(value).length > 0;
+}
+/** Child entries sorted RTDB-console style: numeric-aware key order
+ *  (`2` before `10`), then lexicographic. */
+export function rtdbChildEntries(value) {
+    if (value === null || typeof value !== 'object')
+        return [];
+    return Object.entries(value).sort(([a], [b]) => a.localeCompare(b, undefined, { numeric: true }));
+}
+export function rtdbValueAt(root, path) {
+    let value = root ?? null;
+    for (const segment of rtdbPathSegments(path)) {
+        if (value === null || typeof value !== 'object')
+            return null;
+        value = value[segment] ?? null;
+    }
+    return value;
+}
+export function formatRtdbJson(value) {
+    return JSON.stringify(value ?? null, null, 2);
+}
+export function parseRtdbJson(value) {
+    const text = value.trim();
+    return text.length === 0 ? null : JSON.parse(text);
+}
+export function rtdbValueKind(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+export function previewRtdbValue(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (Array.isArray(value))
+        return `${value.length} items`;
+    if (isRtdbObjectValue(value)) {
+        const count = Object.keys(value).length;
+        return count === 1 ? '1 child' : `${count} children`;
+    }
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    return String(value);
+}
+//# sourceMappingURL=values.js.map

package/dist/rtdb/values.js.map

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

package/dist/rules/components/DenialInspector.d.ts

@@ -0,0 +1,18 @@
+import type { DenialInspectorProps } from '../types.js';
+/**
+ * Headless inspector for a single denied Firestore request. Renders, per
+ * the `denial-inspector-spec`:
+ *   - the plain-language reason (`data-pyric-denial-reason`)
+ *   - the rule source, line-marked (`data-pyric-rule-source`, per-line
+ *     `data-pyric-line-verdict="deny|allow|skip"`)
+ *   - the expression step-through (`data-pyric-trace` + per-node hooks)
+ *   - data in scope (`data-pyric-scope`, `-scope-var`, `-scope-hit`)
+ *   - the re-run / verify loop (`data-pyric-rerun`)
+ *   - the cluster of sibling denials (`data-pyric-denial-cluster`)
+ *   - path resolution for no-match denials (`data-pyric-path-resolution`)
+ *
+ * Zero styling — every visual decision is a consumer's via the
+ * `data-pyric-*` hooks. `mocks/c-debug.html` is the CSS spec.
+ */
+export declare function DenialInspector({ denial, cluster, onRerunAs, onTestEditedRule, onSelectCluster, className, }: DenialInspectorProps): import("react").JSX.Element;
+//# sourceMappingURL=DenialInspector.d.ts.map

package/dist/rules/components/DenialInspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenialInspector.d.ts","sourceRoot":"","sources":["../../../src/rules/components/DenialInspector.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,oBAAoB,EAAkB,MAAM,aAAa,CAAC;AAyEhF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,EAAE,oBAAoB,+BAkItB"}