@jini-ai/admin 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.1 — 2026-10-04
+
+- Media cards show the original file size and upload date (`formatUploadDate` exported from the media barrel); a null size is hidden.
+- Menu ports accept entry targets with an optional `lastKnownHref`.
+- Internal `@jini-ai/*` dependencies are caret ranges (`workspace:^`) instead of exact pins, so a host on a newer patch resolves a single copy without an override.
+
 ## 0.4.0 — 2026-10-02
 
 ### BREAKING

package/dist/core/ports/menus.d.ts

@@ -115,6 +115,9 @@ export type NavTargetKind = "entryRef" | "termRef" | "url" | "route" | (string &
 export interface AdminMenuEntryTarget {
     readonly kind: "entryRef";
     readonly entryId: string;
+    readonly entryType?: string;
+    /** Last URL known to the author; the host resolves entryId first and preserves availability checks. */
+    readonly lastKnownHref?: string;
 }
 /** A link to a taxonomy term (category/tag archive, or a host's closest equivalent grouping). */
 export interface AdminMenuTermTarget {

package/dist/media/index.d.ts

@@ -3,7 +3,7 @@ export { mediaApiToken, mediaProvidersToken } from './ports.js';
 export type { MediaApiPort, MediaProvidersPort, MediaEventsPort } from './ports.js';
 export type { MediaAsset, MediaQuery, UploadInput, MediaMetadataPatch, MediaRequestOptions, MediaProvider, MediaProviderOption, MediaProviderConfiguration, MediaProviderConfigurationMap, MediaTabId, MediaContentTabId, MediaOrderBy, } from './models.js';
 export { mediaMessagesEn } from './messages.en.js';
-export { filterMediaByTab, resolveActiveTab, queryMedia, diffMediaMetadata, acceptsMedia, safeMediaUrl, canReplaceMedia, canRestoreMedia, isRetryableMediaError, parseOptionalPixelSize, formatByteSize, countMediaTabs, mediaEmbedSnippet, mediaRowHandles, } from './rules.js';
+export { filterMediaByTab, resolveActiveTab, queryMedia, diffMediaMetadata, acceptsMedia, safeMediaUrl, canReplaceMedia, canRestoreMedia, isRetryableMediaError, parseOptionalPixelSize, formatByteSize, formatUploadDate, countMediaTabs, mediaEmbedSnippet, mediaRowHandles, } from './rules.js';
 export { createLibraryController } from './controllers/library.controller.js';
 export type { LibraryState } from './controllers/library.controller.js';
 export { createEditMediaController } from './controllers/edit-media.controller.js';

package/dist/media/index.js

@@ -1,7 +1,7 @@
 export { mediaModule } from './media.module.js';
 export { mediaApiToken, mediaProvidersToken } from './ports.js';
 export { mediaMessagesEn } from './messages.en.js';
-export { filterMediaByTab, resolveActiveTab, queryMedia, diffMediaMetadata, acceptsMedia, safeMediaUrl, canReplaceMedia, canRestoreMedia, isRetryableMediaError, parseOptionalPixelSize, formatByteSize, countMediaTabs, mediaEmbedSnippet, mediaRowHandles, } from './rules.js';
+export { filterMediaByTab, resolveActiveTab, queryMedia, diffMediaMetadata, acceptsMedia, safeMediaUrl, canReplaceMedia, canRestoreMedia, isRetryableMediaError, parseOptionalPixelSize, formatByteSize, formatUploadDate, countMediaTabs, mediaEmbedSnippet, mediaRowHandles, } from './rules.js';
 export { createLibraryController } from './controllers/library.controller.js';
 export { createEditMediaController } from './controllers/edit-media.controller.js';
 export { createProvidersController } from './controllers/providers.controller.js';

package/dist/media/react/components/MediaCard.js

@@ -12,6 +12,6 @@ export function MediaPreview(props, _optional = {}) {
 }
 export function MediaCard(props, _optional = {}) {
     const vm = useMediaCard(props);
-    return _jsxs("article", { className: "jini-media-card", "data-jini-part": "media.card", "data-media-id": vm.item.id, tabIndex: -1, children: [_jsx("div", { className: "jini-media-card-preview", "data-jini-part": "media.preview.frame", children: _jsx(PreviewMarkup, { ...vm }) }), _jsxs("div", { className: "jini-media-card-body", children: [_jsx("h3", { className: "jini-media-card-title", title: vm.item.title, children: vm.item.title }), _jsxs("div", { className: "jini-media-card-meta", children: [_jsx(Badge, { className: vm.statusClassName, attrs: { 'data-jini-part': 'media.status' }, tone: vm.statusTone, children: vm.statusLabel }), vm.menuItems.length > 0 && _jsx(Menu, { label: vm.menuLabel, attrs: vm.menuAttrs, items: vm.menuItems, disabled: vm.busy })] }), vm.byteSize && _jsx("p", { className: "jini-media-card-size", hidden: true, children: vm.byteSize }), vm.onChoose && _jsx(Button, { attrs: { 'data-jini-part': 'media.choose', 'data-agent-element': `media-choose-${vm.item.id}` }, onPress: vm.onChoose, children: "Choose" })] })] });
+    return _jsxs("article", { className: "jini-media-card", "data-jini-part": "media.card", "data-media-id": vm.item.id, tabIndex: -1, children: [_jsx("div", { className: "jini-media-card-preview", "data-jini-part": "media.preview.frame", children: _jsx(PreviewMarkup, { ...vm }) }), _jsxs("div", { className: "jini-media-card-body", children: [_jsx("h3", { className: "jini-media-card-title", title: vm.item.title, children: vm.item.title }), _jsxs("div", { className: "jini-media-card-meta", children: [_jsx(Badge, { className: vm.statusClassName, attrs: { 'data-jini-part': 'media.status' }, tone: vm.statusTone, children: vm.statusLabel }), vm.menuItems.length > 0 && _jsx(Menu, { label: vm.menuLabel, attrs: vm.menuAttrs, items: vm.menuItems, disabled: vm.busy })] }), _jsxs("p", { className: "jini-media-card-size", children: [_jsx("span", { children: vm.byteSize }), vm.metadataSeparator, _jsx("time", { dateTime: vm.item.createdAt, children: vm.uploadDate })] }), vm.onChoose && _jsx(Button, { attrs: { 'data-jini-part': 'media.choose', 'data-agent-element': `media-choose-${vm.item.id}` }, onPress: vm.onChoose, children: "Choose" })] })] });
 }
 //# sourceMappingURL=MediaCard.js.map

package/dist/media/react/hooks/MediaCard.hooks.d.ts

@@ -3,6 +3,7 @@ import type { MediaApiPort } from '../../ports.js';
 export interface MediaCardProps {
     readonly item: MediaAsset;
     readonly handleBase?: string;
+    readonly locale?: string;
     readonly api: MediaApiPort;
     readonly busy?: boolean;
     readonly onEdit?: () => void;
@@ -15,6 +16,8 @@ export interface MediaCardProps {
 export declare function useMediaCard(props: MediaCardProps, _optional?: Record<string, never>): {
     busy: boolean;
     byteSize: string | null;
+    uploadDate: string | null;
+    metadataSeparator: string;
     preview: () => void | undefined;
     canPreview: boolean;
     imagePreview: boolean;
@@ -68,6 +71,7 @@ export declare function useMediaCard(props: MediaCardProps, _optional?: Record<s
     trashed: boolean;
     item: MediaAsset;
     handleBase?: string;
+    locale?: string;
     api: MediaApiPort;
     onEdit?: () => void;
     onPreview?: () => void;

package/dist/media/react/hooks/MediaCard.hooks.js

@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { safeMediaUrl, formatByteSize, mediaRowHandles } from '../../rules.js';
+import { safeMediaUrl, formatByteSize, formatUploadDate, mediaRowHandles } from '../../rules.js';
 export function useMediaCard(props, _optional = {}) {
     /** Historical preview rationale, retained with the ported fallback chain:
    * The hard problem this rewrite had to solve: **the media list response carried no content type**
@@ -25,10 +25,13 @@ export function useMediaCard(props, _optional = {}) {
     // immediately when the versioned URL changes, including in an already-open lightbox.
     const stage = probe.src === src ? probe.stage : 'image';
     const handleBase = props.handleBase ?? mediaRowHandles({ media: [props.item] })[0];
+    const byteSize = props.item.byteSize === undefined ? null : formatByteSize({ bytes: props.item.byteSize }, { locale: props.locale ?? 'en-US' });
+    const uploadDate = formatUploadDate({ createdAt: props.item.createdAt }, { locale: props.locale ?? 'en-US' });
     return {
         ...props,
         busy: props.busy === true,
-        byteSize: props.item.byteSize === undefined ? null : formatByteSize({ bytes: props.item.byteSize }),
+        byteSize, uploadDate,
+        metadataSeparator: byteSize && uploadDate ? ' · ' : '',
         preview: () => props.onPreview?.(),
         canPreview: !!props.onPreview && !!src && stage !== 'unsupported',
         imagePreview: !!props.onPreview && !!src && stage === 'image',

package/dist/media/react/hooks/MediaGrid.hooks.d.ts

@@ -12,6 +12,7 @@ export declare function useMediaGrid(props: MediaGridProps, _optional?: Record<s
         handleBase: string;
         busy?: boolean;
         item: import("../../models.js").MediaAsset;
+        locale?: string;
         onEdit?: () => void;
         onPreview?: () => void;
         onTrash?: () => void;

package/dist/media/rules.d.ts

@@ -77,4 +77,10 @@ export declare function mediaEmbedSnippet({ slug }: {
 export declare function mediaRowHandles({ media }: {
     media: readonly Pick<MediaAsset, 'id'>[];
 }, _optional?: Record<string, never>): readonly string[];
+/** A calendar date in UTC, so cards do not shift an upload to yesterday across host timezones. */
+export declare function formatUploadDate({ createdAt }: {
+    createdAt: string;
+}, { locale }?: {
+    locale?: string;
+}): string | null;
 //# sourceMappingURL=rules.d.ts.map

package/dist/media/rules.js

@@ -124,4 +124,11 @@ export function mediaRowHandles({ media }, _optional = {}) {
         return handle;
     });
 }
+/** A calendar date in UTC, so cards do not shift an upload to yesterday across host timezones. */
+export function formatUploadDate({ createdAt }, { locale = 'en-US' } = {}) {
+    const date = new Date(createdAt);
+    if (!Number.isFinite(date.getTime()))
+        return null;
+    return new Intl.DateTimeFormat(locale, { month: 'short', day: 'numeric', year: 'numeric', timeZone: 'UTC' }).format(date);
+}
 //# sourceMappingURL=rules.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/admin",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Composable admin surface for Jini-hosted products: framework-free contracts, panel registry, and route model in `/core`; React shell and panels in `/react`. Import only the layers you need.",
   "license": "Apache-2.0",
   "repository": {
@@ -282,10 +282,10 @@
     "react-dom": "^19.2.0"
   },
   "dependencies": {
-    "@jini-ai/ui": "0.4.0",
-    "@jini-ai/agentic": "0.4.0",
-    "@jini-ai/agent-plugins": "0.4.0",
-    "@jini-ai/ui-kit": "0.1.0"
+    "@jini-ai/agentic": "^0.4.1",
+    "@jini-ai/ui": "^0.4.2",
+    "@jini-ai/ui-kit": "^0.1.0",
+    "@jini-ai/agent-plugins": "^0.4.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/dist/react/kit/Kit.hooks.d.ts

@@ -1,13 +0,0 @@
-import type { ReactAdminKit } from './types.js';
-export declare const KitContext: import("react").Context<ReactAdminKit>;
-export declare function useKitComponent<K extends keyof ReactAdminKit>({ name }: {
-    name: K;
-}, _optional?: Record<string, never>): ReactAdminKit[K];
-export declare function useKitProvider({ kit }: {
-    kit?: Partial<ReactAdminKit>;
-}, _optional?: Record<string, never>): {
-    Button: import("react").ComponentType<import("./types.js").ButtonProps>;
-    Dialog: import("react").ComponentType<import("./types.js").DialogProps>;
-    TextField: import("react").ComponentType<import("./types.js").TextFieldProps>;
-};
-//# sourceMappingURL=Kit.hooks.d.ts.map

package/dist/react/kit/Kit.hooks.js

@@ -1,10 +0,0 @@
-import { createContext, useContext, useMemo } from 'react';
-import { nativeKit } from './native.js';
-export const KitContext = createContext(nativeKit);
-export function useKitComponent({ name }, _optional = {}) {
-    return useContext(KitContext)[name];
-}
-export function useKitProvider({ kit = {} }, _optional = {}) {
-    return useMemo(() => ({ ...nativeKit, ...kit }), [kit]);
-}
-//# sourceMappingURL=Kit.hooks.js.map

package/dist/react/kit/Native.hooks.d.ts

@@ -1,38 +0,0 @@
-import type { ChangeEvent, MouseEvent, SyntheticEvent } from 'react';
-import type { ButtonProps, DialogProps, TextFieldProps } from './types.js';
-export declare function useNativeButton(props: ButtonProps, _optional?: Record<string, never>): {
-    disabled: boolean;
-    onClick: () => void;
-    attrs: import("./types.js").KitAttrs;
-    children: import("react").ReactNode;
-    onPress?: () => void;
-    pending?: boolean;
-    variant?: "primary" | "secondary" | "danger";
-    type?: "button" | "submit";
-    ref?: import("react").Ref<HTMLButtonElement>;
-};
-export declare function useNativeTextField(props: TextFieldProps, _optional?: Record<string, never>): {
-    id: string;
-    onChange: (event: ChangeEvent<HTMLInputElement>) => void;
-    attrs: import("./types.js").KitAttrs;
-    label: string;
-    value: string;
-    onValueChange: (value: string) => void;
-    disabled?: boolean;
-    type?: "text" | "password" | "search";
-    ref?: import("react").Ref<HTMLInputElement>;
-};
-export declare function useNativeDialog(props: DialogProps, _optional?: Record<string, never>): {
-    dialogRef: import("react").RefObject<HTMLDialogElement | null>;
-    titleId: string;
-    onCancel: (event: SyntheticEvent<HTMLDialogElement>) => void;
-    onClick: (event: MouseEvent<HTMLDialogElement>) => void;
-    attrs: import("./types.js").KitAttrs;
-    title: string;
-    open: boolean;
-    children: import("react").ReactNode;
-    onClose: () => void;
-    pending?: boolean;
-    ref?: import("react").Ref<HTMLDialogElement>;
-};
-//# sourceMappingURL=Native.hooks.d.ts.map

package/dist/react/kit/Native.hooks.js

@@ -1,65 +0,0 @@
-import { useEffect, useRef, useId, useImperativeHandle } from 'react';
-export function useNativeButton(props, _optional = {}) {
-    return {
-        ...props,
-        disabled: props.disabled === true || props.pending === true,
-        onClick: () => {
-            if (!props.disabled && !props.pending)
-                props.onPress?.();
-        },
-    };
-}
-export function useNativeTextField(props, _optional = {}) {
-    const generated = useId();
-    const id = props.attrs.id ?? generated;
-    return {
-        ...props,
-        id,
-        onChange: (event) => props.onValueChange(event.currentTarget.value),
-    };
-}
-export function useNativeDialog(props, _optional = {}) {
-    const dialogRef = useRef(null), trigger = useRef(null), titleId = useId();
-    useImperativeHandle(props.ref, () => dialogRef.current, []);
-    useEffect(() => {
-        const dialog = dialogRef.current;
-        if (!dialog || !props.open)
-            return;
-        trigger.current = document.activeElement;
-        // <dialog> may not support showModal() in tests/older browsers. Guard already-open
-        // calls, which throw InvalidStateError in real browsers, and fall back to open.
-        if (typeof dialog.showModal === 'function') {
-            if (!dialog.open)
-                dialog.showModal();
-        }
-        else
-            dialog.setAttribute('open', '');
-        // Focus Cancel/Close, the always-available action, rather than a destructive control.
-        const focus = dialog.querySelector('[data-jini-autofocus]') ?? dialog;
-        focus.focus();
-        return () => {
-            if (typeof dialog.close === 'function') {
-                if (dialog.open)
-                    dialog.close();
-            }
-            else
-                dialog.removeAttribute('open');
-            if (trigger.current instanceof HTMLElement)
-                trigger.current.focus();
-        };
-        // Deliberately keyed on open, not content: navigation while already open must
-        // not reopen the dialog or capture a different trigger for focus restoration.
-    }, [props.open]);
-    function onCancel(event) {
-        // Always prevented so the effect stays the single source of truth for open/closed.
-        event.preventDefault();
-        if (!props.pending)
-            props.onClose();
-    }
-    function onClick(event) {
-        if (!props.pending && event.target === event.currentTarget)
-            props.onClose();
-    }
-    return { ...props, dialogRef, titleId, onCancel, onClick };
-}
-//# sourceMappingURL=Native.hooks.js.map

package/dist/react/kit/index.d.ts

@@ -1,12 +0,0 @@
-import type { ReactNode } from 'react';
-import type { ReactAdminKit, ButtonProps, TextFieldProps, DialogProps } from './types.js';
-export type { ReactAdminKit, ButtonProps, TextFieldProps, DialogProps, KitAttrs } from './types.js';
-export { KIT_CONTRACT_VERSION } from './types.js';
-export declare function KitProvider(props: {
-    kit?: Partial<ReactAdminKit>;
-    children: ReactNode;
-}, _optional?: Record<string, never>): import("react").JSX.Element;
-export declare const Button: import("react").ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
-export declare const TextField: import("react").ForwardRefExoticComponent<Omit<TextFieldProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
-export declare const Dialog: import("react").ForwardRefExoticComponent<Omit<DialogProps, "ref"> & import("react").RefAttributes<HTMLDialogElement>>;
-//# sourceMappingURL=index.d.ts.map

package/dist/react/kit/index.js

@@ -1,21 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { forwardRef } from 'react';
-import { KitContext, useKitComponent, useKitProvider } from './Kit.hooks.js';
-export { KIT_CONTRACT_VERSION } from './types.js';
-export function KitProvider(props, _optional = {}) {
-    const kit = useKitProvider(props);
-    return _jsx(KitContext.Provider, { value: kit, children: props.children });
-}
-export const Button = forwardRef(function Button(props, ref) {
-    const Component = useKitComponent({ name: 'Button' });
-    return _jsx(Component, { ...props, ref: ref });
-});
-export const TextField = forwardRef(function TextField(props, ref) {
-    const Component = useKitComponent({ name: 'TextField' });
-    return _jsx(Component, { ...props, ref: ref });
-});
-export const Dialog = forwardRef(function Dialog(props, ref) {
-    const Component = useKitComponent({ name: 'Dialog' });
-    return _jsx(Component, { ...props, ref: ref });
-});
-//# sourceMappingURL=index.js.map

package/dist/react/kit/native.d.ts

@@ -1,3 +0,0 @@
-import type { ReactAdminKit } from './types.js';
-export declare const nativeKit: ReactAdminKit;
-//# sourceMappingURL=native.d.ts.map

package/dist/react/kit/native.js

@@ -1,21 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { forwardRef } from 'react';
-import { useNativeButton, useNativeDialog, useNativeTextField } from './Native.hooks.js';
-const NativeButton = forwardRef(function NativeButton(props, ref) {
-    const vm = useNativeButton({ ...props, ref });
-    return (_jsx("button", { ...vm.attrs, ref: vm.ref, type: vm.type ?? 'button', disabled: vm.disabled, "aria-busy": vm.pending, "data-jini-variant": vm.variant, onClick: vm.onClick, children: vm.children }));
-});
-const NativeTextField = forwardRef(function NativeTextField(props, ref) {
-    const vm = useNativeTextField({ ...props, ref });
-    return (_jsxs("label", { htmlFor: vm.id, children: [vm.label, _jsx("input", { ...vm.attrs, id: vm.id, ref: vm.ref, type: vm.type ?? 'text', value: vm.value, disabled: vm.disabled, onChange: vm.onChange })] }));
-});
-const NativeDialog = forwardRef(function NativeDialog(props, ref) {
-    const vm = useNativeDialog({ ...props, ref });
-    return (_jsxs("dialog", { ...vm.attrs, ref: vm.dialogRef, tabIndex: -1, "aria-labelledby": vm.titleId, "aria-busy": vm.pending, onCancel: vm.onCancel, onClick: vm.onClick, children: [_jsx("h2", { id: vm.titleId, children: vm.title }), vm.children] }));
-});
-export const nativeKit = Object.freeze({
-    Button: NativeButton,
-    Dialog: NativeDialog,
-    TextField: NativeTextField,
-});
-//# sourceMappingURL=native.js.map

package/dist/react/kit/types.d.ts

@@ -1,40 +0,0 @@
-import type { ComponentType, ReactNode, Ref } from 'react';
-export type KitAttrs = {
-    readonly 'data-jini-part': string;
-    readonly id?: string;
-} & Readonly<Partial<Record<`data-${string}` | `aria-${string}`, string | number | boolean>>>;
-export interface ButtonProps {
-    readonly attrs: KitAttrs;
-    readonly children: ReactNode;
-    readonly onPress?: () => void;
-    readonly disabled?: boolean;
-    readonly pending?: boolean;
-    readonly variant?: 'primary' | 'secondary' | 'danger';
-    readonly type?: 'button' | 'submit';
-    readonly ref?: Ref<HTMLButtonElement>;
-}
-export interface TextFieldProps {
-    readonly attrs: KitAttrs;
-    readonly label: string;
-    readonly value: string;
-    readonly onValueChange: (value: string) => void;
-    readonly disabled?: boolean;
-    readonly type?: 'text' | 'password' | 'search';
-    readonly ref?: Ref<HTMLInputElement>;
-}
-export interface DialogProps {
-    readonly attrs: KitAttrs;
-    readonly title: string;
-    readonly open: boolean;
-    readonly children: ReactNode;
-    readonly onClose: () => void;
-    readonly pending?: boolean;
-    readonly ref?: Ref<HTMLDialogElement>;
-}
-export interface ReactAdminKit {
-    readonly Button: ComponentType<ButtonProps>;
-    readonly Dialog: ComponentType<DialogProps>;
-    readonly TextField: ComponentType<TextFieldProps>;
-}
-export declare const KIT_CONTRACT_VERSION = "1.0.0";
-//# sourceMappingURL=types.d.ts.map

package/dist/react/kit/types.js

@@ -1,2 +0,0 @@
-export const KIT_CONTRACT_VERSION = '1.0.0';
-//# sourceMappingURL=types.js.map

package/dist/react/overlay.d.ts

@@ -1,36 +0,0 @@
-import type { ReactNode } from 'react';
-export interface OverlayEntry {
-    readonly id: number;
-    readonly render: () => ReactNode;
-}
-export interface OverlayPort {
-    open<T>(required: {
-        render: (required: {
-            resolve: (value: T | null) => void;
-            cancel: () => void;
-        }) => ReactNode;
-    }, optional?: {
-        signal?: AbortSignal;
-    }): Promise<T | null>;
-}
-/** One active overlay per host. A second request rejects instead of stealing the first
- * caller's promise; abort/dispose settle null and release every event listener. */
-export declare function createOverlayController(_required?: Record<string, never>, _optional?: Record<string, never>): {
-    getSnapshot: () => Readonly<{
-        entries: readonly OverlayEntry[];
-    }>;
-    subscribe: ({ listener }: {
-        listener: () => void;
-    }) => () => void;
-    open<T>({ render }: {
-        render: (required: {
-            resolve: (value: T | null) => void;
-            cancel: () => void;
-        }) => ReactNode;
-    }, { signal }?: {
-        signal?: AbortSignal;
-    }): Promise<T | null>;
-    cancel(_required?: Record<string, never>, _optional?: Record<string, never>): void;
-    dispose(_required?: Record<string, never>, _optional?: Record<string, never>): void;
-};
-//# sourceMappingURL=overlay.d.ts.map

package/dist/react/overlay.js

@@ -1,35 +0,0 @@
-import { createControllerStore } from '../core/module/controller-store.js';
-/** One active overlay per host. A second request rejects instead of stealing the first
- * caller's promise; abort/dispose settle null and release every event listener. */
-export function createOverlayController(_required = {}, _optional = {}) {
-    const store = createControllerStore({ initial: { entries: [] } });
-    let sequence = 0, cancelActive = null;
-    return {
-        getSnapshot: store.getSnapshot, subscribe: store.subscribe,
-        open({ render }, { signal } = {}) {
-            if (store.signal.aborted || signal?.aborted)
-                return Promise.resolve(null);
-            if (cancelActive)
-                return Promise.reject(new Error('An overlay is already open'));
-            return new Promise(resolve => {
-                let settled = false;
-                const finish = (value) => {
-                    if (settled)
-                        return;
-                    settled = true;
-                    signal?.removeEventListener('abort', cancel);
-                    cancelActive = null;
-                    store.set({ patch: { entries: [] } });
-                    resolve(value);
-                };
-                const cancel = () => finish(null);
-                cancelActive = cancel;
-                signal?.addEventListener('abort', cancel, { once: true });
-                store.set({ patch: { entries: [{ id: ++sequence, render: () => render({ resolve: finish, cancel }) }] } });
-            });
-        },
-        cancel(_required = {}, _optional = {}) { cancelActive?.(); },
-        dispose(_required = {}, _optional = {}) { cancelActive?.(); store.dispose(); },
-    };
-}
-//# sourceMappingURL=overlay.js.map