@pyric/ui 0.1.0-alpha.7

package/dist/firestore/reducers/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/firestore/reducers/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAmDhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAkDA"}

package/dist/firestore/reducers/validation.js

@@ -0,0 +1,121 @@
+import { Timestamp, GeoPoint, Bytes } from 'pyric/firestore';
+import { asVectorView } from '../types.js';
+/**
+ * Per-type leaf validator. Returns an error message when the value
+ * doesn't satisfy the type's constraints, `undefined` when valid.
+ *
+ * `map` and `array` aren't validated here — their integrity comes
+ * from their children + (for maps) sibling-key uniqueness, which
+ * is enforced in {@link validateTree}.
+ */
+export function validateLeaf(type, value) {
+    switch (type) {
+        case 'string':
+            return typeof value === 'string' ? undefined : 'Expected a string';
+        case 'number':
+            if (typeof value !== 'number')
+                return 'Expected a number';
+            if (!Number.isFinite(value))
+                return 'Number must be finite';
+            return undefined;
+        case 'boolean':
+            return typeof value === 'boolean' ? undefined : 'Expected a boolean';
+        case 'null':
+            return value === null || value === undefined ? undefined : 'Expected null';
+        case 'timestamp':
+            return value instanceof Timestamp ? undefined : 'Expected a Timestamp';
+        case 'geopoint':
+            if (!(value instanceof GeoPoint))
+                return 'Expected a GeoPoint';
+            if (value.latitude < -90 || value.latitude > 90)
+                return 'Latitude must be between -90 and 90';
+            if (value.longitude < -180 || value.longitude > 180)
+                return 'Longitude must be between -180 and 180';
+            return undefined;
+        case 'reference':
+            // Structural reference check matches `inferType`. A reference's
+            // path must be non-empty and have an even segment count
+            // (collection/doc/collection/doc/...).
+            if (value === null || typeof value !== 'object')
+                return 'Expected a DocumentReference';
+            const obj = value;
+            if (typeof obj.path !== 'string')
+                return 'Reference missing `path`';
+            if (!obj.path)
+                return 'Reference path is empty';
+            const segments = obj.path.split('/').filter(Boolean);
+            if (segments.length % 2 !== 0)
+                return 'Reference path must have an even segment count';
+            return undefined;
+        case 'bytes':
+            return value instanceof Bytes ? undefined : 'Expected a Bytes value';
+        case 'vector':
+            return asVectorView(value) !== null ? undefined : 'Expected a vector value';
+        case 'map':
+        case 'array':
+            return undefined; // structural; see validateTree
+    }
+}
+/**
+ * Walk the tree, attach an `error` to each node, and return the
+ * mutated tree along with the total error count. The function does
+ * not mutate the input; it returns a fresh tree.
+ *
+ * Per-leaf errors come from {@link validateLeaf}. Map nodes
+ * additionally surface duplicate-key + empty-key errors on the
+ * offending children (not on the parent).
+ */
+export function validateTree(tree) {
+    const nodes = {};
+    let errorCount = 0;
+    for (const [id, node] of Object.entries(tree.nodes)) {
+        nodes[id] = { ...node, error: undefined };
+    }
+    // Leaf validation
+    for (const node of Object.values(nodes)) {
+        if (node.type === 'map' || node.type === 'array')
+            continue;
+        const err = validateLeaf(node.type, node.value);
+        if (err) {
+            nodes[node.id].error = err;
+            errorCount++;
+        }
+    }
+    // Map sibling-key checks: empty + duplicate
+    for (const [parentId, parent] of Object.entries(nodes)) {
+        if (parent.type !== 'map')
+            continue;
+        const childIds = tree.childIds[parentId] ?? [];
+        const keys = new Map(); // key -> child ids
+        for (const childId of childIds) {
+            const child = nodes[childId];
+            if (!child)
+                continue;
+            const key = child.key ?? '';
+            if (!key) {
+                if (!child.error)
+                    errorCount++;
+                nodes[childId].error = nodes[childId].error ?? 'Field name is required';
+            }
+            const bucket = keys.get(key) ?? [];
+            bucket.push(childId);
+            keys.set(key, bucket);
+        }
+        for (const [key, ids] of keys) {
+            if (!key)
+                continue; // already flagged as required
+            if (ids.length > 1) {
+                for (const id of ids) {
+                    if (!nodes[id].error)
+                        errorCount++;
+                    nodes[id].error = nodes[id].error ?? 'Field name must be unique';
+                }
+            }
+        }
+    }
+    return {
+        tree: { rootId: tree.rootId, nodes, childIds: tree.childIds },
+        errorCount,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/firestore/reducers/validation.js.map

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

package/dist/firestore/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The set of value types `@pyric/ui` knows how to display + edit.
+ * Maps 1:1 to Firestore's serializable value shapes; consumers can
+ * extend the registry but the built-in editors cover these.
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'null' | 'timestamp' | 'geopoint' | 'reference' | 'bytes' | 'map' | 'array' | 'vector';
+/**
+ * Runtime-classify a value into one of the {@link FieldType}s.
+ *
+ * The discrimination order matters:
+ *   - `null` checked before `typeof === 'object'` (null is an object)
+ *   - vector (a typed embedding wrapper) checked before `Array.isArray`
+ *     and before generic objects — its wire-sentinel shape is a plain
+ *     object, and a bare `number[]` must stay `array`, not `vector`
+ *   - `Array.isArray` checked before generic objects
+ *   - Firestore special types (Timestamp/GeoPoint/Bytes/DocumentRef)
+ *     checked before falling through to `map`
+ *
+ * `undefined` values aren't legal Firestore field values; we coerce
+ * them to `'null'` rather than throw — the caller can decide whether
+ * to display or filter.
+ */
+export declare function inferType(value: unknown): FieldType;
+/**
+ * A serialized Timestamp: exactly `{ seconds, nanoseconds }` (or the firebase
+ * `{ _seconds, _nanoseconds }` variant), both numbers, no other keys. The
+ * "exactly two keys" guard keeps a genuine map that merely contains those
+ * fields from being misclassified.
+ */
+export declare function isTimestampShape(v: object): boolean;
+/** A serialized GeoPoint: exactly `{ latitude, longitude }`, both numbers. The
+ *  GeoPoint display reads `.latitude` / `.longitude`, so the plain shape renders
+ *  unchanged. */
+export declare function isGeoPointShape(v: object): boolean;
+/**
+ * Normalized read-side view of a Firestore vector (embedding) value.
+ * Editors and the renderer work against this rather than the raw shape
+ * so they don't have to care which backend produced the value.
+ */
+export interface VectorView {
+    /** The embedding components. Defensive copy — safe to read freely. */
+    readonly values: number[];
+    /** Number of components. Equivalent to `values.length`; surfaced
+     *  separately because that's what the UI labels (`vector · <dims>`). */
+    readonly dimension: number;
+}
+/**
+ * Detect + normalize a Firestore vector value, or return `null` if the
+ * value isn't a vector. Vectors reach `@pyric/ui` in several runtime
+ * shapes depending on the backend the snapshot came from — there is no
+ * single `VectorValue` class `pyric/firestore` re-exports, so we match
+ * structurally (the same strategy {@link isDocumentReferenceShape} uses
+ * for refs):
+ *
+ *   1. **pyric `Vector` wrapper** — frozen `.value: number[]` array plus
+ *      a `.dimension` getter (sandbox / rules-side reads).
+ *   2. **firebase/firestore (web) `VectorValue`** — exposes `.toArray()`
+ *      and nothing else publicly.
+ *   3. **firebase-admin `VectorValue`** — internal `._values: number[]`
+ *      (also a `.toArray()`).
+ *   4. **wire sentinel** — `{ __type__: '__vector__', value: number[] }`,
+ *      the plain-object encoded form a discover crawler / seed emits.
+ *
+ * A bare `number[]` is intentionally NOT a vector — those stay `array`.
+ * Only the typed/branded shapes above match.
+ */
+export declare function asVectorView(value: unknown): VectorView | null;
+/** Compact, display-safe rendering of a vector: `vector · <dim> [a, b, c, …]`.
+ *  So a real embedding never dumps its full array into a diff, a rules trace, or
+ *  a debugger panel. */
+export declare function vectorPreview(view: VectorView): string;
+/** Deep-replace any vector-shaped value with a compact preview STRING, so the
+ *  result can be `JSON.stringify`'d / formatted without dumping full embeddings.
+ *  Recurses plain objects + arrays; class instances (Timestamp/GeoPoint) and
+ *  scalars pass through untouched. Vector instances/sentinels are caught first. */
+export declare function truncateVectorsForDisplay(value: unknown): unknown;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,WAAW,GACX,UAAU,GACV,WAAW,GACX,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,CAAC;AAEb;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CA6CnD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;iBAEiB;AACjB,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlD;AAgBD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B;4EACwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAiC9D;AAcD;;wBAEwB;AACxB,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAItD;AAED;;;mFAGmF;AACnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAejE"}

package/dist/firestore/types.js

@@ -0,0 +1,196 @@
+import { Timestamp, GeoPoint, Bytes } from 'pyric/firestore';
+/**
+ * Runtime-classify a value into one of the {@link FieldType}s.
+ *
+ * The discrimination order matters:
+ *   - `null` checked before `typeof === 'object'` (null is an object)
+ *   - vector (a typed embedding wrapper) checked before `Array.isArray`
+ *     and before generic objects — its wire-sentinel shape is a plain
+ *     object, and a bare `number[]` must stay `array`, not `vector`
+ *   - `Array.isArray` checked before generic objects
+ *   - Firestore special types (Timestamp/GeoPoint/Bytes/DocumentRef)
+ *     checked before falling through to `map`
+ *
+ * `undefined` values aren't legal Firestore field values; we coerce
+ * them to `'null'` rather than throw — the caller can decide whether
+ * to display or filter.
+ */
+export function inferType(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'string')
+        return 'string';
+    if (typeof value === 'number')
+        return 'number';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    // Vector (embedding) before array + map: a vector arrives as one of
+    // several typed shapes (see {@link asVectorView}), one of which is a
+    // plain `{__type__:'__vector__', value}` object. A bare numeric array
+    // is deliberately NOT a vector — only the typed VectorValue / wrapper
+    // / sentinel shapes classify here, so ordinary `number[]` data stays
+    // `array`.
+    if (typeof value === 'object' && asVectorView(value) !== null)
+        return 'vector';
+    if (Array.isArray(value))
+        return 'array';
+    // Firestore SDK value types — these are class instances at runtime.
+    // `instanceof` works against the same import pyric/firestore
+    // re-exports (Bytes / GeoPoint from firebase/firestore directly;
+    // Timestamp from either backend's compatible class).
+    if (value instanceof Timestamp)
+        return 'timestamp';
+    if (value instanceof GeoPoint)
+        return 'geopoint';
+    if (value instanceof Bytes)
+        return 'bytes';
+    // Serialized Timestamp / GeoPoint: crossing a worker / postMessage boundary
+    // strips the class, leaving plain `{ seconds, nanoseconds }` /
+    // `{ latitude, longitude }`. Detect them structurally (same rationale as
+    // references below) rather than rendering them as maps of internal fields.
+    if (typeof value === 'object' && isTimestampShape(value))
+        return 'timestamp';
+    if (typeof value === 'object' && isGeoPointShape(value))
+        return 'geopoint';
+    // DocumentReference has no shared class identity across the two
+    // backends (sandbox-chainable vs. firebase/firestore). Use a
+    // structural check on the brand-bearing fields. Any object that
+    // looks reference-shaped (path + firestore handle + id) is
+    // classified as a reference; the alternative is rendering it as
+    // a map of those three fields, which is strictly worse.
+    if (typeof value === 'object' && isDocumentReferenceShape(value)) {
+        return 'reference';
+    }
+    if (typeof value === 'object')
+        return 'map';
+    // Unreachable for Firestore-shaped data, but TS wants exhaustivity.
+    return 'null';
+}
+/**
+ * A serialized Timestamp: exactly `{ seconds, nanoseconds }` (or the firebase
+ * `{ _seconds, _nanoseconds }` variant), both numbers, no other keys. The
+ * "exactly two keys" guard keeps a genuine map that merely contains those
+ * fields from being misclassified.
+ */
+export function isTimestampShape(v) {
+    const obj = v;
+    const keys = Object.keys(obj);
+    if (keys.length !== 2)
+        return false;
+    return ((typeof obj.seconds === 'number' && typeof obj.nanoseconds === 'number') ||
+        (typeof obj._seconds === 'number' && typeof obj._nanoseconds === 'number'));
+}
+/** A serialized GeoPoint: exactly `{ latitude, longitude }`, both numbers. The
+ *  GeoPoint display reads `.latitude` / `.longitude`, so the plain shape renders
+ *  unchanged. */
+export function isGeoPointShape(v) {
+    const obj = v;
+    const keys = Object.keys(obj);
+    return keys.length === 2 && typeof obj.latitude === 'number' && typeof obj.longitude === 'number';
+}
+function isDocumentReferenceShape(v) {
+    const obj = v;
+    if (typeof obj.path !== 'string' || typeof obj.id !== 'string')
+        return false;
+    // The Web SDK ref exposes a `.firestore` handle; the chainable
+    // (sandbox) ref exposes `.env` instead. Either signals "this is a
+    // ref, not a plain map that happens to have `path` + `id` fields."
+    // Also accept `.type === 'document'` which both backends set on
+    // their ref class instances.
+    const hasFirestore = typeof obj.firestore === 'object' && obj.firestore !== null;
+    const hasEnv = typeof obj.env === 'object' && obj.env !== null;
+    const hasDocBrand = obj.type === 'document';
+    return hasFirestore || hasEnv || hasDocBrand;
+}
+/**
+ * Detect + normalize a Firestore vector value, or return `null` if the
+ * value isn't a vector. Vectors reach `@pyric/ui` in several runtime
+ * shapes depending on the backend the snapshot came from — there is no
+ * single `VectorValue` class `pyric/firestore` re-exports, so we match
+ * structurally (the same strategy {@link isDocumentReferenceShape} uses
+ * for refs):
+ *
+ *   1. **pyric `Vector` wrapper** — frozen `.value: number[]` array plus
+ *      a `.dimension` getter (sandbox / rules-side reads).
+ *   2. **firebase/firestore (web) `VectorValue`** — exposes `.toArray()`
+ *      and nothing else publicly.
+ *   3. **firebase-admin `VectorValue`** — internal `._values: number[]`
+ *      (also a `.toArray()`).
+ *   4. **wire sentinel** — `{ __type__: '__vector__', value: number[] }`,
+ *      the plain-object encoded form a discover crawler / seed emits.
+ *
+ * A bare `number[]` is intentionally NOT a vector — those stay `array`.
+ * Only the typed/branded shapes above match.
+ */
+export function asVectorView(value) {
+    if (value === null || typeof value !== 'object')
+        return null;
+    const obj = value;
+    // (1) pyric Vector wrapper: branded by `typeName === 'vector'` with a
+    // numeric `.value` array. `.dimension` is a getter on the class.
+    if (obj.typeName === 'vector' && isNumberArray(obj.value)) {
+        return freezeView(obj.value);
+    }
+    // (4) wire sentinel: `{ __type__: '__vector__', value: number[] }`.
+    if (obj.__type__ === '__vector__' && isNumberArray(obj.value)) {
+        return freezeView(obj.value);
+    }
+    // (3) firebase-admin VectorValue: internal `_values` array.
+    if (isNumberArray(obj._values)) {
+        return freezeView(obj._values);
+    }
+    // (2) firebase/firestore (web) VectorValue: only a `.toArray()`. Guard
+    // the call so a plain object with an unrelated `toArray` can't throw —
+    // a non-numeric result fails the `isNumberArray` gate below.
+    if (typeof obj.toArray === 'function') {
+        try {
+            const arr = obj.toArray();
+            if (isNumberArray(arr))
+                return freezeView(arr);
+        }
+        catch {
+            // Not a vector — fall through.
+        }
+    }
+    return null;
+}
+function isNumberArray(v) {
+    return Array.isArray(v) && v.every((n) => typeof n === 'number');
+}
+function freezeView(values) {
+    const copy = values.slice();
+    return { values: copy, dimension: copy.length };
+}
+/** How many leading components to show in a truncated vector preview. */
+const VECTOR_PREVIEW_COUNT = 4;
+/** Compact, display-safe rendering of a vector: `vector · <dim> [a, b, c, …]`.
+ *  So a real embedding never dumps its full array into a diff, a rules trace, or
+ *  a debugger panel. */
+export function vectorPreview(view) {
+    const head = view.values.slice(0, VECTOR_PREVIEW_COUNT).join(', ');
+    const tail = view.values.length > VECTOR_PREVIEW_COUNT ? ', …' : '';
+    return `vector · ${view.dimension} [${head}${tail}]`;
+}
+/** Deep-replace any vector-shaped value with a compact preview STRING, so the
+ *  result can be `JSON.stringify`'d / formatted without dumping full embeddings.
+ *  Recurses plain objects + arrays; class instances (Timestamp/GeoPoint) and
+ *  scalars pass through untouched. Vector instances/sentinels are caught first. */
+export function truncateVectorsForDisplay(value) {
+    const view = asVectorView(value);
+    if (view)
+        return vectorPreview(view);
+    if (Array.isArray(value))
+        return value.map(truncateVectorsForDisplay);
+    if (value && typeof value === 'object') {
+        const proto = Object.getPrototypeOf(value);
+        if (proto === Object.prototype || proto === null) {
+            const out = {};
+            for (const [k, v] of Object.entries(value)) {
+                out[k] = truncateVectorsForDisplay(v);
+            }
+            return out;
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=types.js.map

package/dist/firestore/types.js.map

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

package/dist/firestore/validation/ids.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Firestore collection/document id validation (create-collection /
+ * create-document / JSON-import flows).
+ *
+ * Pure, dependency-free, and deliberately narrow: it mirrors the rules the
+ * real backend enforces (see Firestore's "Rules and limits" docs), so a form
+ * can reject an invalid id BEFORE the write round-trip rather than
+ * surfacing a raw backend error string.
+ *
+ * Rules (both collection and document ids):
+ *   - non-empty
+ *   - no `/` (that's a path separator, not part of an id)
+ *   - not solely `.` or `..`
+ *   - doesn't match `__.*__` (reserved for internal use)
+ *   - at most 1500 bytes (UTF-8) — Firestore caps BOTH collection ids and
+ *     document ids at 1500 bytes ("Rules and limits": "Maximum size for a
+ *     collection ID" / "Maximum size for a document ID", both 1,500 bytes).
+ */
+/** Validate a collection id. Returns an error message, or `undefined` when valid. */
+export declare function validateCollectionId(id: string): string | undefined;
+/** Validate a document id. Returns an error message, or `undefined` when valid. */
+export declare function validateDocumentId(id: string): string | undefined;
+//# sourceMappingURL=ids.d.ts.map

package/dist/firestore/validation/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/firestore/validation/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAOD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}

package/dist/firestore/validation/ids.js

@@ -0,0 +1,46 @@
+/**
+ * Firestore collection/document id validation (create-collection /
+ * create-document / JSON-import flows).
+ *
+ * Pure, dependency-free, and deliberately narrow: it mirrors the rules the
+ * real backend enforces (see Firestore's "Rules and limits" docs), so a form
+ * can reject an invalid id BEFORE the write round-trip rather than
+ * surfacing a raw backend error string.
+ *
+ * Rules (both collection and document ids):
+ *   - non-empty
+ *   - no `/` (that's a path separator, not part of an id)
+ *   - not solely `.` or `..`
+ *   - doesn't match `__.*__` (reserved for internal use)
+ *   - at most 1500 bytes (UTF-8) — Firestore caps BOTH collection ids and
+ *     document ids at 1500 bytes ("Rules and limits": "Maximum size for a
+ *     collection ID" / "Maximum size for a document ID", both 1,500 bytes).
+ */
+const RESERVED_DUNDER = /^__.*__$/;
+/** Shared structural checks common to both collection and document ids. */
+function structuralError(id) {
+    if (id.length === 0)
+        return 'Cannot be empty';
+    if (id.includes('/'))
+        return 'Cannot contain "/"';
+    if (id === '.' || id === '..')
+        return 'Cannot be "." or ".."';
+    if (RESERVED_DUNDER.test(id))
+        return 'Cannot match __.*__ (reserved)';
+    if (utf8ByteLength(id) > 1500)
+        return 'Cannot exceed 1500 bytes';
+    return undefined;
+}
+/** Validate a collection id. Returns an error message, or `undefined` when valid. */
+export function validateCollectionId(id) {
+    return structuralError(id);
+}
+/** UTF-8 byte length of a string (Firestore's 1500-byte id cap). */
+function utf8ByteLength(s) {
+    return new TextEncoder().encode(s).length;
+}
+/** Validate a document id. Returns an error message, or `undefined` when valid. */
+export function validateDocumentId(id) {
+    return structuralError(id);
+}
+//# sourceMappingURL=ids.js.map

package/dist/firestore/validation/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/firestore/validation/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC,2EAA2E;AAC3E,SAAS,eAAe,CAAC,EAAU;IACjC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAC9C,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAClD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,uBAAuB,CAAC;IAC9D,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,gCAAgC,CAAC;IACtE,IAAI,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI;QAAE,OAAO,0BAA0B,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/primitives/Badge.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from 'react';
+export interface BadgeProps {
+    /** Badge content — usually a short word like "ALLOW" or "GET". */
+    children: ReactNode;
+    /**
+     * Freeform category surfaced as `data-pyric-badge-kind`. The
+     * library doesn't enumerate kinds — the consumer decides what
+     * values exist (`allow`, `deny`, `get`, `update`, …) and styles
+     * them via `[data-pyric-badge-kind="…"]`.
+     */
+    kind?: string;
+    /** Forwarded to the underlying `<span>`. */
+    className?: string;
+    /**
+     * Accessible label. When set, the visible text becomes
+     * `aria-hidden` and screen readers announce this instead — useful
+     * when the badge is a terse glyph but the meaning is longer.
+     */
+    ariaLabel?: string;
+}
+/**
+ * Headless pill / tag. Renders an inline `<span>` carrying
+ * `data-pyric-badge` and (when `kind` is set) `data-pyric-badge-kind`
+ * so consumers can style categories with attribute selectors. Ships
+ * no visual styling of its own.
+ */
+export declare function Badge({ children, kind, className, ariaLabel }: BadgeProps): import("react").JSX.Element;
+//# sourceMappingURL=Badge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/primitives/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,UAAU,+BAWzE"}

package/dist/primitives/Badge.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Headless pill / tag. Renders an inline `<span>` carrying
+ * `data-pyric-badge` and (when `kind` is set) `data-pyric-badge-kind`
+ * so consumers can style categories with attribute selectors. Ships
+ * no visual styling of its own.
+ */
+export function Badge({ children, kind, className, ariaLabel }) {
+    return (_jsx("span", { "data-pyric-badge": "", "data-pyric-badge-kind": kind, className: className, "aria-label": ariaLabel, children: ariaLabel ? _jsx("span", { "aria-hidden": "true", children: children }) : children }));
+}
+//# sourceMappingURL=Badge.js.map

package/dist/primitives/Badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.js","sourceRoot":"","sources":["../../src/primitives/Badge.tsx"],"names":[],"mappings":";AAsBA;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAc;IACxE,OAAO,CACL,mCACmB,EAAE,2BACI,IAAI,EAC3B,SAAS,EAAE,SAAS,gBACR,SAAS,YAEpB,SAAS,CAAC,CAAC,CAAC,8BAAkB,MAAM,YAAE,QAAQ,GAAQ,CAAC,CAAC,CAAC,QAAQ,GAC7D,CACR,CAAC;AACJ,CAAC"}

package/dist/primitives/ConfirmDialog.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+export interface ConfirmDialogProps {
+    /** Controlled open state. */
+    open: boolean;
+    /** Called when the user dismisses via overlay click, Escape, or
+     *  the cancel button. NOT called by `onConfirm`. */
+    onOpenChange: (open: boolean) => void;
+    /** Heading. */
+    title: string;
+    /** Body content — explanation, consequences, paths affected. */
+    body?: ReactNode;
+    /** When `true`, the confirm button carries `data-pyric-destructive`
+     *  so consumers can style it differently (e.g. red). */
+    destructive?: boolean;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    /** Fires when the user presses confirm. The component does NOT
+     *  close itself on confirm — the consumer typically dismisses
+     *  after the destructive action resolves. */
+    onConfirm: () => void;
+    /** Forwarded to the content node so consumers can style. */
+    className?: string;
+}
+/**
+ * Headless confirmation dialog. Hand-rolled (we evaluated Radix
+ * Dialog at M4 but Radix's Presence + Portal stack doesn't render
+ * under our bun:test + JSDOM env — see plan section 7 risk #1).
+ *
+ * Provides:
+ *   - Portal to `document.body` (so the dialog can escape parent
+ *     stacking contexts)
+ *   - Escape-to-close
+ *   - Overlay click to close
+ *   - ARIA `role="dialog" aria-modal="true"` wiring
+ *   - Focus restoration to the previously-focused element on close
+ *   - Initial focus on the confirm button when opening
+ *
+ * Ships no visual CSS. Consumers style via the structural
+ * `data-pyric-*` attributes.
+ */
+export declare function ConfirmDialog({ open, onOpenChange, title, body, destructive, confirmLabel, cancelLabel, onConfirm, className, }: ConfirmDialogProps): import("react").ReactPortal | null;
+//# sourceMappingURL=ConfirmDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmDialog.d.ts","sourceRoot":"","sources":["../../src/primitives/ConfirmDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG1D,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd;wDACoD;IACpD,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;4DACwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;iDAE6C;IAC7C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,WAAW,EACX,YAAwB,EACxB,WAAsB,EACtB,SAAS,EACT,SAAS,GACV,EAAE,kBAAkB,sCAmFpB"}