@pyric/ui 0.1.0-alpha.10

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

@@ -0,0 +1,33 @@
+import type { RtdbApi } from '../rtdbApi.js';
+import { type UpdateHighlight } from '../../primitives/hooks/useUpdateHighlights.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;
+    updateAt(path: string): UpdateHighlight | undefined;
+}
+/**
+ * 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;AAM7C,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+CAA+C,CAAC;AACvD,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;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,kBAAkB,CAgFpB"}

package/dist/rtdb/hooks/useRtdbTree.js

@@ -0,0 +1,67 @@
+import { useCallback, useEffect, useMemo, useReducer } from 'react';
+import { normalizeRtdbPath, rtdbUpdateEntries, rtdbValuesEqual, } from '../values.js';
+import { useUpdateHighlights, } from '../../primitives/hooks/useUpdateHighlights.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);
+    const updateEntries = useMemo(() => rtdbUpdateEntries(state.value, state.path), [state.path, state.value]);
+    const updates = useUpdateHighlights({
+        scope: state.path,
+        entries: updateEntries,
+        equals: rtdbValuesEqual,
+        ready: state.status === 'live',
+    });
+    // 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]);
+    const updateAt = useCallback((p) => updates.get(normalizeRtdbPath(p)), [updates]);
+    return useMemo(() => ({
+        state,
+        pageSize,
+        valueAt,
+        isExpanded,
+        childrenAt,
+        toggle,
+        showMore,
+        updateAt,
+    }), [state, pageSize, valueAt, isExpanded, childrenAt, toggle, showMore, updateAt]);
+}
+//# 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"}

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,50 @@
+/**
+ * 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;
+/** Structural equality for JSON-shaped RTDB snapshots and row fingerprints. */
+export declare function rtdbValuesEqual(previous: unknown, next: unknown): boolean;
+/** One comparison fingerprint per RTDB row. Parent fingerprints contain only
+ * direct child keys, so leaf changes remain local while additions/removals
+ * also light the immediate parent. */
+export declare function rtdbUpdateEntries(value: unknown, rootPath: string): ReadonlyMap<string, unknown>;
+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,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAuBzE;AAED;;sCAEsC;AACtC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAa9B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASvD"}