@pyric/ui 0.1.0-alpha.20 → 0.1.0-alpha.22

package/dist/agents/Modal.d.ts

@@ -1,25 +1,2 @@
-import { type ReactNode } from 'react';
-export interface ModalProps {
-    open: boolean;
-    onClose: () => void;
-    children: ReactNode;
-    ariaLabel?: string;
-    /** Forwarded to the root wrapper (covers the full viewport). */
-    className?: string;
-    /** Forwarded to the backdrop element. */
-    backdropClassName?: string;
-    /** Forwarded to the inner panel. */
-    panelClassName?: string;
-}
-/**
- * Headless modal — provides behavior only (Escape-to-close, backdrop
- * click, `aria-modal`). Consumers attach all visual styling via the
- * three `className` slots or by selecting on the emitted data
- * attributes:
- *
- *   [data-pyric-ui="modal"]            — root viewport wrapper
- *   [data-pyric-modal-backdrop]        — clickable backdrop
- *   [data-pyric-modal-panel]           — inner panel containing children
- */
-export declare function Modal({ open, onClose, children, ariaLabel, className, backdropClassName, panelClassName, }: ModalProps): import("react").JSX.Element | null;
+export { Modal, type ModalProps } from '../primitives/Modal.js';
 //# sourceMappingURL=Modal.d.ts.map

package/dist/agents/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/agents/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,cAAc,GACf,EAAE,UAAU,sCA+BZ"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/agents/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/agents/Modal.js

@@ -1,28 +1,2 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect } from 'react';
-/**
- * Headless modal — provides behavior only (Escape-to-close, backdrop
- * click, `aria-modal`). Consumers attach all visual styling via the
- * three `className` slots or by selecting on the emitted data
- * attributes:
- *
- *   [data-pyric-ui="modal"]            — root viewport wrapper
- *   [data-pyric-modal-backdrop]        — clickable backdrop
- *   [data-pyric-modal-panel]           — inner panel containing children
- */
-export function Modal({ open, onClose, children, ariaLabel, className, backdropClassName, panelClassName, }) {
-    useEffect(() => {
-        if (!open)
-            return;
-        const handler = (e) => {
-            if (e.key === 'Escape')
-                onClose();
-        };
-        window.addEventListener('keydown', handler);
-        return () => window.removeEventListener('keydown', handler);
-    }, [open, onClose]);
-    if (!open)
-        return null;
-    return (_jsxs("div", { role: "dialog", "aria-modal": "true", "aria-label": ariaLabel, "data-pyric-ui": "modal", className: className, children: [_jsx("div", { "data-pyric-modal-backdrop": true, className: backdropClassName, onClick: onClose, "aria-hidden": "true" }), _jsx("div", { "data-pyric-modal-panel": true, className: panelClassName, children: children })] }));
-}
+export { Modal } from '../primitives/Modal.js';
 //# sourceMappingURL=Modal.js.map

package/dist/agents/Modal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../src/agents/Modal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAelD;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,cAAc,GACH;IACX,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,EAAE;YACnC,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;QACpC,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,OAAO,CACL,eACE,IAAI,EAAC,QAAQ,gBACF,MAAM,gBACL,SAAS,mBACP,OAAO,EACrB,SAAS,EAAE,SAAS,aAEpB,iDAEE,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,OAAO,iBACJ,MAAM,GAClB,EACF,8CAA4B,SAAS,EAAE,cAAc,YAClD,QAAQ,GACL,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../src/agents/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,wBAAwB,CAAC"}

package/dist/auth/authApi.d.ts

@@ -23,7 +23,7 @@ export declare function useAuthApi(): AuthApi;
 /**
  * Provide an auth API bundle to the subtree. Pyric Studio supplies the
  * in-process bundle for dev-seed review and the SharedWorker client bundle under
- * `pyric dev --ui`.
+ * `pyric sandbox --ui`.
  */
 export declare function AuthApiProvider({ value, children, }: {
     value: AuthApi;

package/dist/auth/authApi.js

@@ -19,7 +19,7 @@ export function useAuthApi() {
 /**
  * Provide an auth API bundle to the subtree. Pyric Studio supplies the
  * in-process bundle for dev-seed review and the SharedWorker client bundle under
- * `pyric dev --ui`.
+ * `pyric sandbox --ui`.
  */
 export function AuthApiProvider({ value, children, }) {
     return createElement(AuthApiContext.Provider, { value }, children);

package/dist/firestore/firestoreApi.d.ts

@@ -26,7 +26,7 @@ export declare function useFirestoreApi(): FirestoreApi;
 /**
  * Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
  * surface with this, supplying the in-process bundle for dev-seed review and the
- * SharedWorker client bundle under `pyric dev --ui`.
+ * SharedWorker client bundle under `pyric sandbox --ui`.
  */
 export declare function FirestoreApiProvider({ value, children, }: {
     value: FirestoreApi;

package/dist/firestore/firestoreApi.js

@@ -21,7 +21,7 @@ export function useFirestoreApi() {
 /**
  * Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
  * surface with this, supplying the in-process bundle for dev-seed review and the
- * SharedWorker client bundle under `pyric dev --ui`.
+ * SharedWorker client bundle under `pyric sandbox --ui`.
  */
 export function FirestoreApiProvider({ value, children, }) {
     return createElement(FirestoreApiContext.Provider, { value }, children);

package/dist/primitives/Modal.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode, type RefObject } from 'react';
+export interface ModalProps {
+    /** Controlled open state. */
+    open: boolean;
+    /** Called when the user dismisses via backdrop click or Escape. */
+    onClose: () => void;
+    /** Content rendered inside the inner panel. */
+    children: ReactNode;
+    /** Accessible name for the dialog. */
+    ariaLabel?: string;
+    /** Accessible label element ID. */
+    ariaLabelledBy?: string;
+    /** Accessible description element ID. */
+    ariaDescribedBy?: string;
+    /** Optional ref to focus when the modal opens. Defaults to first focusable element. */
+    initialFocusRef?: RefObject<HTMLElement | null>;
+    /** Forwarded to the root wrapper (covers the full viewport). */
+    className?: string;
+    /** Forwarded to the backdrop element. */
+    backdropClassName?: string;
+    /** Forwarded to the inner panel. */
+    panelClassName?: string;
+}
+/**
+ * Headless modal primitive — provides accessible behavior:
+ * - Traps keyboard focus within panel (`Tab` and `Shift+Tab` cycling)
+ * - Restores focus to original trigger element on close
+ * - Dismisses on `Escape` key or backdrop click
+ * - Emits ARIA dialog attributes (`role="dialog"`, `aria-modal="true"`)
+ *
+ * Ships zero visual styling. Consumers attach styles via `className` slots
+ * or by targeting emitted attributes:
+ *   [data-pyric-ui="modal"]      — root viewport wrapper
+ *   [data-pyric-modal-backdrop]  — clickable backdrop
+ *   [data-pyric-modal-panel]     — inner panel containing children
+ */
+export declare function Modal({ open, onClose, children, ariaLabel, ariaLabelledBy, ariaDescribedBy, initialFocusRef, className, backdropClassName, panelClassName, }: ModalProps): import("react").JSX.Element | null;
+//# sourceMappingURL=Modal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/primitives/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,mEAAmE;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,eAAe,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChD,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,cAAc,GACf,EAAE,UAAU,sCA2IZ"}

package/dist/primitives/Modal.js

@@ -0,0 +1,162 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+const FOCUSABLE_SELECTOR = [
+    'a[href]',
+    'area[href]',
+    'input:not([disabled]):not([type="hidden"])',
+    'select:not([disabled])',
+    'textarea:not([disabled])',
+    'button:not([disabled])',
+    'iframe',
+    'object',
+    'embed',
+    '[contenteditable="true"]',
+    '[tabindex]:not([tabindex^="-"])',
+].join(', ');
+function getFocusableElements(container) {
+    return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).filter((el) => {
+        if (el.disabled)
+            return false;
+        if (el.hasAttribute('disabled'))
+            return false;
+        if (el.getAttribute('aria-hidden') === 'true')
+            return false;
+        if (el.tabIndex < 0)
+            return false;
+        if (typeof window !== 'undefined' && typeof window.getComputedStyle === 'function') {
+            try {
+                const style = window.getComputedStyle(el);
+                if (style.display === 'none' || style.visibility === 'hidden')
+                    return false;
+            }
+            catch {
+                // Safe fallback in test environments
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Headless modal primitive — provides accessible behavior:
+ * - Traps keyboard focus within panel (`Tab` and `Shift+Tab` cycling)
+ * - Restores focus to original trigger element on close
+ * - Dismisses on `Escape` key or backdrop click
+ * - Emits ARIA dialog attributes (`role="dialog"`, `aria-modal="true"`)
+ *
+ * Ships zero visual styling. Consumers attach styles via `className` slots
+ * or by targeting emitted attributes:
+ *   [data-pyric-ui="modal"]      — root viewport wrapper
+ *   [data-pyric-modal-backdrop]  — clickable backdrop
+ *   [data-pyric-modal-panel]     — inner panel containing children
+ */
+export function Modal({ open, onClose, children, ariaLabel, ariaLabelledBy, ariaDescribedBy, initialFocusRef, className, backdropClassName, panelClassName, }) {
+    const panelRef = useRef(null);
+    const previouslyFocused = useRef(null);
+    const onCloseRef = useRef(onClose);
+    onCloseRef.current = onClose;
+    const initialFocusRefProp = useRef(initialFocusRef);
+    initialFocusRefProp.current = initialFocusRef;
+    // Focus management: capture activeElement on open, set initial focus,
+    // and restore focus to trigger element on close / unmount.
+    useEffect(() => {
+        if (!open)
+            return;
+        previouslyFocused.current = document.activeElement ?? null;
+        const panel = panelRef.current;
+        if (panel) {
+            const preferred = initialFocusRefProp.current?.current;
+            if (preferred && typeof preferred.focus === 'function') {
+                preferred.focus();
+            }
+            else {
+                const focusables = getFocusableElements(panel);
+                if (focusables.length > 0) {
+                    focusables[0].focus();
+                }
+                else {
+                    panel.focus();
+                }
+            }
+        }
+        return () => {
+            const prev = previouslyFocused.current;
+            if (prev && typeof prev.focus === 'function' && prev.isConnected !== false) {
+                prev.focus();
+                queueMicrotask(() => {
+                    if (document.activeElement !== prev && typeof prev.focus === 'function' && prev.isConnected !== false) {
+                        prev.focus();
+                    }
+                });
+            }
+        };
+    }, [open]);
+    // Keyboard navigation: Escape-to-close and Tab/Shift+Tab focus cycling
+    useEffect(() => {
+        if (!open)
+            return;
+        const handleKeyDown = (e) => {
+            if (e.key === 'Escape') {
+                e.stopPropagation();
+                onCloseRef.current();
+                return;
+            }
+            if (e.key === 'Tab') {
+                const panel = panelRef.current;
+                if (!panel)
+                    return;
+                const focusables = getFocusableElements(panel);
+                if (focusables.length === 0) {
+                    e.preventDefault();
+                    panel.focus();
+                    return;
+                }
+                const first = focusables[0];
+                const last = focusables[focusables.length - 1];
+                const active = document.activeElement;
+                let currentIndex = focusables.indexOf(active);
+                if (currentIndex === -1 && active && panel.contains(active)) {
+                    const parentFocusable = active.closest?.(FOCUSABLE_SELECTOR);
+                    if (parentFocusable) {
+                        currentIndex = focusables.indexOf(parentFocusable);
+                    }
+                }
+                if (currentIndex === -1) {
+                    e.preventDefault();
+                    if (e.shiftKey) {
+                        last.focus();
+                    }
+                    else {
+                        first.focus();
+                    }
+                    return;
+                }
+                if (e.shiftKey) {
+                    // Shift + Tab (backward)
+                    e.preventDefault();
+                    if (currentIndex <= 0) {
+                        last.focus();
+                    }
+                    else {
+                        focusables[currentIndex - 1].focus();
+                    }
+                }
+                else {
+                    // Tab (forward)
+                    e.preventDefault();
+                    if (currentIndex >= focusables.length - 1) {
+                        first.focus();
+                    }
+                    else {
+                        focusables[currentIndex + 1].focus();
+                    }
+                }
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [open]);
+    if (!open)
+        return null;
+    return (_jsxs("div", { role: "dialog", "aria-modal": "true", "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, "data-pyric-ui": "modal", className: className, children: [_jsx("div", { "data-pyric-modal-backdrop": true, className: backdropClassName, onClick: onClose, "aria-hidden": "true" }), _jsx("div", { ref: panelRef, tabIndex: -1, "data-pyric-modal-panel": true, className: panelClassName, children: children })] }));
+}
+//# sourceMappingURL=Modal.js.map

package/dist/primitives/Modal.js.map

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

package/dist/primitives/index.d.ts

@@ -8,4 +8,5 @@ export { ToastProvider, useToast, type ToastInput, type ToastRecord, type ToastK
 export { VirtualList, type VirtualListProps } from './VirtualList.js';
 export { useContainerSize, type ContainerSize, type UseContainerSizeOptions, } from './hooks/useContainerSize.js';
 export { useUpdateHighlights, type UpdateHighlight, type UpdateHighlightKind, type UseUpdateHighlightsOptions, } from './hooks/useUpdateHighlights.js';
+export { Modal, type ModalProps } from './Modal.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/primitives/index.js

@@ -8,4 +8,5 @@ export { ToastProvider, useToast, } from './Toast.js';
 export { VirtualList } from './VirtualList.js';
 export { useContainerSize, } from './hooks/useContainerSize.js';
 export { useUpdateHighlights, } from './hooks/useUpdateHighlights.js';
+export { Modal } from './Modal.js';
 //# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

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

package/dist/storage/hooks/useStorageRulesGate.d.ts

@@ -6,9 +6,8 @@ export type StorageRulesGateStatus = 'idle' | 'loading' | 'ready' | 'error';
  * - `'sandbox'` — the ruleset deployed on the sandbox handle
  *   (`getStorageSandbox(ctx, { rules })`), read off the handle's
  *   `StorageService`.
- * - `'none'` — no rules reachable. Every verdict allows
- *   (open-by-default, the same semantics `pyric/storage`'s
- *   enforcement layer applies when no rules are configured).
+ * - `'none'` — no rules reachable. Once resolution completes, every verdict
+ *   denies, matching `pyric/storage`'s fail-closed enforcement.
  */
 export type StorageRulesSource = 'option' | 'sandbox' | 'none';
 /**
@@ -80,10 +79,8 @@ export interface UseStorageRulesGateResult {
     /**
      * Evaluate an arbitrary path under the current ruleset + identity.
      * Pure and synchronous once `status` is `'ready'`; before that
-     * (and whenever no rules are reachable) it returns the allow-all
-     * verdict — the gate FAILS OPEN, because affordances are advisory
-     * and the real enforcement (sandbox throw / server denial) stays
-     * authoritative.
+     * it returns the allow-all verdict. A ready rules-less handle returns the
+     * deny-all verdict, matching the enforcement layer's default.
      */
     verdictFor: (path: string) => StorageGateVerdict;
     /** Rules-resolution failure (e.g. a malformed `rules` string). */

package/dist/storage/hooks/useStorageRulesGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useStorageRulesGate.d.ts","sourceRoot":"","sources":["../../../src/storage/hooks/useStorageRulesGate.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACjD,kEAAkE;IAClE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B;AAqBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA6H3B"}
+{"version":3,"file":"useStorageRulesGate.d.ts","sourceRoot":"","sources":["../../../src/storage/hooks/useStorageRulesGate.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACjD,kEAAkE;IAClE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B;AAiCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA6H3B"}

package/dist/storage/hooks/useStorageRulesGate.js

@@ -12,6 +12,17 @@ const ALLOW_ALL = Object.freeze({
         write: [],
     }),
 });
+/** Shared fail-closed verdict for a ready handle with no deployed rules. */
+const DENY_ALL = Object.freeze({
+    read: false,
+    write: false,
+    delete: false,
+    upload: false,
+    reasons: Object.freeze({
+        read: ['No Storage rules configured; default deny.'],
+        write: ['No Storage rules configured; default deny.'],
+    }),
+});
 /**
  * Pre-flight rules evaluation — the M7 differentiator. Evaluates the
  * current identity against paths BEFORE the click, so components can
@@ -98,7 +109,7 @@ export function useStorageRulesGate(storage, options = {}) {
     const writeContentType = writeResource?.contentType;
     const verdictFor = useCallback((path) => {
         if (rules == null)
-            return ALLOW_ALL;
+            return status === 'ready' ? DENY_ALL : ALLOW_ALL;
         const objectPath = normalizeStoragePath(path);
         const bucket = target?.bucket ?? 'pyric-default';
         const rulesPath = objectPath === '' ? `b/${bucket}/o` : `b/${bucket}/o/${objectPath}`;
@@ -127,7 +138,7 @@ export function useStorageRulesGate(storage, options = {}) {
                 write: write.allowed ? [] : write.reasons,
             },
         };
-    }, [rules, target?.bucket, identity, writeSize, writeContentType]);
+    }, [rules, status, target?.bucket, identity, writeSize, writeContentType]);
     const pathsKey = typeof paths === 'string' ? paths : (paths ?? []).join('\n');
     const verdicts = useMemo(() => {
         const list = typeof paths === 'string' ? [paths] : (paths ?? []);

package/dist/storage/hooks/useStorageRulesGate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyric/ui",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "license": "Apache-2.0",
   "homepage": "https://pyric.dev",
   "repository": {
@@ -93,7 +93,7 @@
     "react": ">=18",
     "react-dom": ">=18",
     "firebase": ">=12",
-    "pyric": "^0.1.0-alpha.20"
+    "pyric": "^0.1.0-alpha.22"
   },
   "peerDependenciesMeta": {
     "@inbrowser/agent": {
@@ -109,8 +109,8 @@
     "fake-indexeddb": "^6.0.0",
     "firebase": "^12.12.0",
     "jsdom": "^29.1.1",
-    "pyric": "^0.1.0-alpha.20",
-    "pyric-admin": "^0.1.0-alpha.20",
+    "pyric": "^0.1.0-alpha.22",
+    "pyric-admin": "^0.1.0-alpha.22",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-test-renderer": "^19.2.6",

package/src/agents/Modal.tsx

@@ -1,65 +1 @@
-import { useEffect, type ReactNode } from 'react';
-
-export interface ModalProps {
-  open: boolean;
-  onClose: () => void;
-  children: ReactNode;
-  ariaLabel?: string;
-  /** Forwarded to the root wrapper (covers the full viewport). */
-  className?: string;
-  /** Forwarded to the backdrop element. */
-  backdropClassName?: string;
-  /** Forwarded to the inner panel. */
-  panelClassName?: string;
-}
-
-/**
- * Headless modal — provides behavior only (Escape-to-close, backdrop
- * click, `aria-modal`). Consumers attach all visual styling via the
- * three `className` slots or by selecting on the emitted data
- * attributes:
- *
- *   [data-pyric-ui="modal"]            — root viewport wrapper
- *   [data-pyric-modal-backdrop]        — clickable backdrop
- *   [data-pyric-modal-panel]           — inner panel containing children
- */
-export function Modal({
-  open,
-  onClose,
-  children,
-  ariaLabel,
-  className,
-  backdropClassName,
-  panelClassName,
-}: ModalProps) {
-  useEffect(() => {
-    if (!open) return;
-    const handler = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') onClose();
-    };
-    window.addEventListener('keydown', handler);
-    return () => window.removeEventListener('keydown', handler);
-  }, [open, onClose]);
-
-  if (!open) return null;
-
-  return (
-    <div
-      role="dialog"
-      aria-modal="true"
-      aria-label={ariaLabel}
-      data-pyric-ui="modal"
-      className={className}
-    >
-      <div
-        data-pyric-modal-backdrop
-        className={backdropClassName}
-        onClick={onClose}
-        aria-hidden="true"
-      />
-      <div data-pyric-modal-panel className={panelClassName}>
-        {children}
-      </div>
-    </div>
-  );
-}
+export { Modal, type ModalProps } from '../primitives/Modal.js';

package/src/auth/authApi.ts

@@ -59,7 +59,7 @@ export function useAuthApi(): AuthApi {
 /**
  * Provide an auth API bundle to the subtree. Pyric Studio supplies the
  * in-process bundle for dev-seed review and the SharedWorker client bundle under
- * `pyric dev --ui`.
+ * `pyric sandbox --ui`.
  */
 export function AuthApiProvider({
   value,

package/src/firestore/firestoreApi.ts

@@ -73,7 +73,7 @@ export function useFirestoreApi(): FirestoreApi {
 /**
  * Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
  * surface with this, supplying the in-process bundle for dev-seed review and the
- * SharedWorker client bundle under `pyric dev --ui`.
+ * SharedWorker client bundle under `pyric sandbox --ui`.
  */
 export function FirestoreApiProvider({
   value,

package/src/primitives/Modal.tsx

@@ -0,0 +1,223 @@
+import { useEffect, useRef, type ReactNode, type RefObject } from 'react';
+
+export interface ModalProps {
+  /** Controlled open state. */
+  open: boolean;
+  /** Called when the user dismisses via backdrop click or Escape. */
+  onClose: () => void;
+  /** Content rendered inside the inner panel. */
+  children: ReactNode;
+  /** Accessible name for the dialog. */
+  ariaLabel?: string;
+  /** Accessible label element ID. */
+  ariaLabelledBy?: string;
+  /** Accessible description element ID. */
+  ariaDescribedBy?: string;
+  /** Optional ref to focus when the modal opens. Defaults to first focusable element. */
+  initialFocusRef?: RefObject<HTMLElement | null>;
+  /** Forwarded to the root wrapper (covers the full viewport). */
+  className?: string;
+  /** Forwarded to the backdrop element. */
+  backdropClassName?: string;
+  /** Forwarded to the inner panel. */
+  panelClassName?: string;
+}
+
+const FOCUSABLE_SELECTOR = [
+  'a[href]',
+  'area[href]',
+  'input:not([disabled]):not([type="hidden"])',
+  'select:not([disabled])',
+  'textarea:not([disabled])',
+  'button:not([disabled])',
+  'iframe',
+  'object',
+  'embed',
+  '[contenteditable="true"]',
+  '[tabindex]:not([tabindex^="-"])',
+].join(', ');
+
+function getFocusableElements(container: HTMLElement): HTMLElement[] {
+  return Array.from(
+    container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),
+  ).filter((el) => {
+    if ((el as any).disabled) return false;
+    if (el.hasAttribute('disabled')) return false;
+    if (el.getAttribute('aria-hidden') === 'true') return false;
+    if (el.tabIndex < 0) return false;
+    if (typeof window !== 'undefined' && typeof window.getComputedStyle === 'function') {
+      try {
+        const style = window.getComputedStyle(el);
+        if (style.display === 'none' || style.visibility === 'hidden') return false;
+      } catch {
+        // Safe fallback in test environments
+      }
+    }
+    return true;
+  });
+}
+
+/**
+ * Headless modal primitive — provides accessible behavior:
+ * - Traps keyboard focus within panel (`Tab` and `Shift+Tab` cycling)
+ * - Restores focus to original trigger element on close
+ * - Dismisses on `Escape` key or backdrop click
+ * - Emits ARIA dialog attributes (`role="dialog"`, `aria-modal="true"`)
+ *
+ * Ships zero visual styling. Consumers attach styles via `className` slots
+ * or by targeting emitted attributes:
+ *   [data-pyric-ui="modal"]      — root viewport wrapper
+ *   [data-pyric-modal-backdrop]  — clickable backdrop
+ *   [data-pyric-modal-panel]     — inner panel containing children
+ */
+export function Modal({
+  open,
+  onClose,
+  children,
+  ariaLabel,
+  ariaLabelledBy,
+  ariaDescribedBy,
+  initialFocusRef,
+  className,
+  backdropClassName,
+  panelClassName,
+}: ModalProps) {
+  const panelRef = useRef<HTMLDivElement | null>(null);
+  const previouslyFocused = useRef<HTMLElement | null>(null);
+  const onCloseRef = useRef(onClose);
+  onCloseRef.current = onClose;
+  const initialFocusRefProp = useRef(initialFocusRef);
+  initialFocusRefProp.current = initialFocusRef;
+
+  // Focus management: capture activeElement on open, set initial focus,
+  // and restore focus to trigger element on close / unmount.
+  useEffect(() => {
+    if (!open) return;
+
+    previouslyFocused.current = (document.activeElement as HTMLElement) ?? null;
+
+    const panel = panelRef.current;
+    if (panel) {
+      const preferred = initialFocusRefProp.current?.current;
+      if (preferred && typeof preferred.focus === 'function') {
+        preferred.focus();
+      } else {
+        const focusables = getFocusableElements(panel);
+        if (focusables.length > 0) {
+          focusables[0].focus();
+        } else {
+          panel.focus();
+        }
+      }
+    }
+
+    return () => {
+      const prev = previouslyFocused.current;
+      if (prev && typeof prev.focus === 'function' && prev.isConnected !== false) {
+        prev.focus();
+        queueMicrotask(() => {
+          if (document.activeElement !== prev && typeof prev.focus === 'function' && prev.isConnected !== false) {
+            prev.focus();
+          }
+        });
+      }
+    };
+  }, [open]);
+
+  // Keyboard navigation: Escape-to-close and Tab/Shift+Tab focus cycling
+  useEffect(() => {
+    if (!open) return;
+
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        e.stopPropagation();
+        onCloseRef.current();
+        return;
+      }
+
+      if (e.key === 'Tab') {
+        const panel = panelRef.current;
+        if (!panel) return;
+
+        const focusables = getFocusableElements(panel);
+        if (focusables.length === 0) {
+          e.preventDefault();
+          panel.focus();
+          return;
+        }
+
+        const first = focusables[0];
+        const last = focusables[focusables.length - 1];
+        const active = document.activeElement;
+        let currentIndex = focusables.indexOf(active as HTMLElement);
+
+        if (currentIndex === -1 && active && panel.contains(active)) {
+          const parentFocusable = (active as HTMLElement).closest?.(FOCUSABLE_SELECTOR);
+          if (parentFocusable) {
+            currentIndex = focusables.indexOf(parentFocusable as HTMLElement);
+          }
+        }
+
+        if (currentIndex === -1) {
+          e.preventDefault();
+          if (e.shiftKey) {
+            last.focus();
+          } else {
+            first.focus();
+          }
+          return;
+        }
+
+        if (e.shiftKey) {
+          // Shift + Tab (backward)
+          e.preventDefault();
+          if (currentIndex <= 0) {
+            last.focus();
+          } else {
+            focusables[currentIndex - 1].focus();
+          }
+        } else {
+          // Tab (forward)
+          e.preventDefault();
+          if (currentIndex >= focusables.length - 1) {
+            first.focus();
+          } else {
+            focusables[currentIndex + 1].focus();
+          }
+        }
+      }
+    };
+
+    window.addEventListener('keydown', handleKeyDown);
+    return () => window.removeEventListener('keydown', handleKeyDown);
+  }, [open]);
+
+  if (!open) return null;
+
+  return (
+    <div
+      role="dialog"
+      aria-modal="true"
+      aria-label={ariaLabel}
+      aria-labelledby={ariaLabelledBy}
+      aria-describedby={ariaDescribedBy}
+      data-pyric-ui="modal"
+      className={className}
+    >
+      <div
+        data-pyric-modal-backdrop
+        className={backdropClassName}
+        onClick={onClose}
+        aria-hidden="true"
+      />
+      <div
+        ref={panelRef}
+        tabIndex={-1}
+        data-pyric-modal-panel
+        className={panelClassName}
+      >
+        {children}
+      </div>
+    </div>
+  );
+}

package/src/primitives/index.ts

@@ -37,3 +37,4 @@ export {
   type UpdateHighlightKind,
   type UseUpdateHighlightsOptions,
 } from './hooks/useUpdateHighlights.js';
+export { Modal, type ModalProps } from './Modal.js';

package/src/storage/hooks/useStorageRulesGate.ts

@@ -18,9 +18,8 @@ export type StorageRulesGateStatus = 'idle' | 'loading' | 'ready' | 'error';
  * - `'sandbox'` — the ruleset deployed on the sandbox handle
  *   (`getStorageSandbox(ctx, { rules })`), read off the handle's
  *   `StorageService`.
- * - `'none'` — no rules reachable. Every verdict allows
- *   (open-by-default, the same semantics `pyric/storage`'s
- *   enforcement layer applies when no rules are configured).
+ * - `'none'` — no rules reachable. Once resolution completes, every verdict
+ *   denies, matching `pyric/storage`'s fail-closed enforcement.
  */
 export type StorageRulesSource = 'option' | 'sandbox' | 'none';
 
@@ -89,10 +88,8 @@ export interface UseStorageRulesGateResult {
   /**
    * Evaluate an arbitrary path under the current ruleset + identity.
    * Pure and synchronous once `status` is `'ready'`; before that
-   * (and whenever no rules are reachable) it returns the allow-all
-   * verdict — the gate FAILS OPEN, because affordances are advisory
-   * and the real enforcement (sandbox throw / server denial) stays
-   * authoritative.
+   * it returns the allow-all verdict. A ready rules-less handle returns the
+   * deny-all verdict, matching the enforcement layer's default.
    */
   verdictFor: (path: string) => StorageGateVerdict;
   /** Rules-resolution failure (e.g. a malformed `rules` string). */
@@ -111,6 +108,18 @@ const ALLOW_ALL: StorageGateVerdict = Object.freeze({
   }) as StorageGateVerdict['reasons'],
 });
 
+/** Shared fail-closed verdict for a ready handle with no deployed rules. */
+const DENY_ALL: StorageGateVerdict = Object.freeze({
+  read: false,
+  write: false,
+  delete: false,
+  upload: false,
+  reasons: Object.freeze({
+    read: ['No Storage rules configured; default deny.'],
+    write: ['No Storage rules configured; default deny.'],
+  }) as StorageGateVerdict['reasons'],
+});
+
 interface RulesState {
   status: StorageRulesGateStatus;
   rules: StorageRules | null;
@@ -212,7 +221,7 @@ export function useStorageRulesGate(
 
   const verdictFor = useCallback(
     (path: string): StorageGateVerdict => {
-      if (rules == null) return ALLOW_ALL;
+      if (rules == null) return status === 'ready' ? DENY_ALL : ALLOW_ALL;
       const objectPath = normalizeStoragePath(path);
       const bucket = target?.bucket ?? 'pyric-default';
       const rulesPath = objectPath === '' ? `b/${bucket}/o` : `b/${bucket}/o/${objectPath}`;
@@ -243,7 +252,7 @@ export function useStorageRulesGate(
         },
       };
     },
-    [rules, target?.bucket, identity, writeSize, writeContentType],
+    [rules, status, target?.bucket, identity, writeSize, writeContentType],
   );
 
   const pathsKey = typeof paths === 'string' ? paths : (paths ?? []).join('\n');