@jini-ai/admin 0.4.2 → 0.4.3

package/dist/widgets/react/hooks/use-widgets-library.hooks.d.ts

@@ -0,0 +1,37 @@
+import type { AdminWidget, AdminWidgetType, WidgetsTranslate as Translate } from '../../models.js';
+export interface WidgetsLibraryController {
+    /** `null` until the initial load settles — the caller renders a loading state. */
+    widgets: AdminWidget[] | null;
+    error: string | null;
+    /** Count of widget-instance records the server could not read (unparseable `fields_json`).
+     *  `0` and `undefined` both mean "nothing to say". */
+    skippedCount: number;
+    /** IDs of the malformed widget records counted in {@link skippedCount}. */
+    skippedIds: string[];
+    createType: AdminWidgetType;
+    setCreateType: (type: AdminWidgetType) => void;
+    /** The widget a "Trash" click is asking to confirm — `null` when the dialog is closed. Set by
+     *  `requestTrash`; no network call happens until {@link confirmTrash}. */
+    pendingTrash: AdminWidget | null;
+    /** True only while the CONFIRMED trash for {@link pendingTrash} is in flight — same
+     *  `pendingX !== null && xId === pendingX.id` shape `use-media.hooks.ts` uses. */
+    trashing: boolean;
+    requestTrash: (widget: AdminWidget) => void;
+    confirmTrash: () => Promise<void>;
+    cancelTrash: () => void;
+    /** Bound translator — `WidgetsLibrary.tsx`'s only source of UI copy; see this file's own header. */
+    t: Translate;
+    /** The raw resolved locale — exposed only because `widgetTypeLabel` (`../rules.ts`) genuinely
+     *  needs it, not `t`. */
+    locale: string;
+}
+import type { AdminWidgetsPort, WidgetsEventsPort } from '../../ports.js';
+export declare function useWidgetsLibrary({ api }: {
+    api: AdminWidgetsPort;
+}, { t, locale, events }?: {
+    t?: Translate | undefined;
+    locale?: string | undefined;
+    events?: WidgetsEventsPort | undefined;
+}): WidgetsLibraryController;
+export declare function useWiredWidgetsLibrary(): WidgetsLibraryController;
+//# sourceMappingURL=use-widgets-library.hooks.d.ts.map

package/dist/widgets/react/hooks/use-widgets-library.hooks.js

@@ -0,0 +1,23 @@
+import { useEffect, useRef } from 'react';
+import { useController } from '../../../core/react/use-controller.js';
+import { createWidgetsLibraryController } from '../../controllers/library.controller.js';
+import { widgetsEnglish } from '../../messages.en.js';
+import { WIDGETS_LIBRARY_RESOURCE } from '../../rules.js';
+import { useWidgetsPorts, useWidgetsOptions } from './WidgetsPorts.hooks.js';
+export function useWidgetsLibrary({ api }, { t = widgetsEnglish, locale = 'en', events } = {}) {
+    const latestT = useRef(t);
+    latestT.current = t;
+    const { controller, snapshot } = useController({ create: () => createWidgetsLibraryController({ api }, { t: key => latestT.current(key) }), dependencies: [api] }, { start: ({ controller }) => { void controller.load(); } });
+    useEffect(() => { if (!controller)
+        return; return events?.subscribe({ resource: WIDGETS_LIBRARY_RESOURCE, onRefresh: () => { void controller.load(); } }); }, [controller, events]);
+    const state = snapshot ?? { widgets: null, error: null, skippedCount: 0, skippedIds: [], createType: 'text', pendingTrash: null, trashingId: null };
+    return { ...state, trashing: state.pendingTrash !== null && state.trashingId === state.pendingTrash.id,
+        setCreateType: type => controller?.setCreateType({ type }), requestTrash: widget => controller?.requestTrash({ widget }),
+        confirmTrash: async () => { await controller?.confirmTrash(); }, cancelTrash: () => controller?.cancelTrash(), t, locale };
+}
+export function useWiredWidgetsLibrary() {
+    const { widgetsApi: api, widgetsEvents: events } = useWidgetsPorts();
+    const { t, locale } = useWidgetsOptions();
+    return useWidgetsLibrary({ api }, { t, locale, events });
+}
+//# sourceMappingURL=use-widgets-library.hooks.js.map

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

@@ -0,0 +1,391 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { AdminInstance } from '../../core/module/types.js';
+import type { ModulePageProps } from '../../core/react/bind-react.js';
+import type { WidgetsReactOptions } from './hooks/WidgetsPorts.hooks.js';
+export type { WidgetsReactOptions, WidgetsSlots } from './hooks/WidgetsPorts.hooks.js';
+export { useWidgetsPorts, useWidgetsOptions } from './hooks/WidgetsPorts.hooks.js';
+export type { WidgetsLibraryProps } from './pages/WidgetsLibrary.js';
+export type { WidgetInstanceEditorProps } from './pages/WidgetInstanceEditor.js';
+export type { WidgetRegionsProps } from './pages/WidgetRegions.js';
+export type { WidgetRegionEditorProps } from './pages/WidgetRegionEditor.js';
+/** Optional page params are the Part B host bridge; core ModulePageProps remains untouched. */
+export type WidgetsModulePageProps = ModulePageProps & {
+    params?: {
+        widgetId?: string | null;
+        widgetType?: string | null;
+        regionKey?: string;
+    } | undefined;
+    widgetId?: string | null | undefined;
+    widgetType?: string | null | undefined;
+    regionKey?: string | undefined;
+};
+/** Lazy pages share injected options while bindReact owns the API scope. */
+export declare function widgets({ slots, widgetTypes, defaultConfig }: Pick<WidgetsReactOptions, 'slots' | 'widgetTypes' | 'defaultConfig'>, optional?: Omit<WidgetsReactOptions, 'slots' | 'widgetTypes' | 'defaultConfig'>): {
+    id: "widgets";
+    requires: {
+        readonly widgetsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminWidgetsPort, "admin.widgets.api">;
+    };
+    optional: {
+        readonly widgetsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsEventsPort, "admin.widgets.events">;
+        readonly widgetsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsNavigationPort, "admin.widgets.navigation">;
+    };
+    messages: {
+        readonly Back: "Back";
+        readonly "Widget type to create": "Widget type to create";
+        readonly Content: "Content";
+        readonly Text: "Text";
+        readonly "Social Links": "Social Links";
+        readonly "Collection list": "Collection list";
+        readonly Menu: "Menu";
+        readonly "Contact Form": "Contact Form";
+        readonly Widgets: "Widgets";
+        readonly "Widget Regions": "Widget Regions";
+        readonly "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.": "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.";
+        readonly "Binding\u2026": "Binding…";
+        readonly "Bind region": "Bind region";
+        readonly "No regions bound yet.": "No regions bound yet.";
+        readonly "Region key": "Region key";
+        readonly Placements: "Placements";
+        readonly Manage: "Manage";
+        readonly "Create reusable content blocks and place them into your theme's widget regions.": "Create reusable content blocks and place them into your theme's widget regions.";
+        readonly "Regions \u2192": "Regions →";
+        readonly "Add New": "Add New";
+        readonly "1 widget record in this workspace could not be read.": "1 widget record in this workspace could not be read.";
+        readonly "{n} widget records in this workspace could not be read.": "{n} widget records in this workspace could not be read.";
+        readonly "Show ids": "Show ids";
+        readonly "No widgets yet.": "No widgets yet.";
+        readonly "Create one above to get started.": "Create one above to get started.";
+        readonly Title: "Title";
+        readonly Type: "Type";
+        readonly Slug: "Slug";
+        readonly Status: "Status";
+        readonly Actions: "Actions";
+        readonly Trash: "Trash";
+        readonly "Move to trash?": "Move to trash?";
+        readonly "Move to trash": "Move to trash";
+        readonly "Move \"{title}\" to trash?": "Move \"{title}\" to trash?";
+        readonly Regions: "Regions";
+        readonly "Saving\u2026": "Saving…";
+        readonly Save: "Save";
+        readonly "Region:": "Region:";
+        readonly "Manage which widgets appear in this region and their order.": "Manage which widgets appear in this region and their order.";
+        readonly "No widgets placed in this region yet.": "No widgets placed in this region yet.";
+        readonly Enabled: "Enabled";
+        readonly "\u26A0 Broken reference": "⚠ Broken reference";
+        readonly "+ Add widget": "+ Add widget";
+        readonly "New widget": "New widget";
+        readonly "Edit widget": "Edit widget";
+        readonly "Configure this widget's title and settings.": "Configure this widget's title and settings.";
+        readonly "Widget title": "Widget title";
+        readonly "Type:": "Type:";
+        readonly "Region area": "Region area";
+        readonly "Inline embed": "Inline embed";
+        readonly "Used in 1 place:": "Used in 1 place:";
+        readonly "Used in {count} places:": "Used in {count} places:";
+        readonly "failed to load widget": "failed to load widget";
+        readonly "save failed": "save failed";
+        readonly "This widget changed since you loaded it, refresh and try again.": "This widget changed since you loaded it, refresh and try again.";
+        readonly "This region changed since you loaded it, refresh and try again.": "This region changed since you loaded it, refresh and try again.";
+        readonly "failed to load region": "failed to load region";
+        readonly "failed to load widgets": "failed to load widgets";
+        readonly "delete failed": "delete failed";
+        readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+        readonly "failed to load regions": "failed to load regions";
+        readonly "bind failed": "bind failed";
+        readonly "Loading widget\u2026": "Loading widget…";
+        readonly "No widget type specified.": "No widget type specified.";
+        readonly "Unknown widget type \"": "Unknown widget type \"";
+        readonly "Loading region\u2026": "Loading region…";
+        readonly "Move up": "Move up";
+        readonly "Move down": "Move down";
+        readonly Remove: "Remove";
+        readonly "Loading regions\u2026": "Loading regions…";
+        readonly "Loading widgets\u2026": "Loading widgets…";
+        readonly "Saved \u00B7 version {version}": "Saved · version {version}";
+    };
+    pages: {
+        readonly library: {
+            readonly path: "/widgets";
+            readonly label: "Widgets";
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "Content";
+            };
+            readonly tabs: {};
+        };
+        readonly editor: {
+            readonly path: "/widgets/:widgetId";
+            readonly label: "Edit widget";
+            readonly agentReachable: true;
+            readonly tabs: {};
+        };
+        readonly regions: {
+            readonly path: "/widgets/regions";
+            readonly label: "Widget Regions";
+            readonly agentReachable: true;
+            readonly tabs: {};
+        };
+        readonly region: {
+            readonly path: "/widgets/regions/:regionKey";
+            readonly label: "Region:";
+            readonly agentReachable: true;
+            readonly tabs: {};
+        };
+    };
+} & {
+    react: {
+        Provider: ({ admin, children, options }: {
+            admin: AdminInstance;
+            children: ReactNode;
+            options?: WidgetsReactOptions;
+        }, _optional?: Record<string, never>) => import("react").FunctionComponentElement<{
+            admin: AdminInstance;
+            children: ReactNode;
+        }>;
+        module: {
+            readonly id: "widgets";
+            readonly requires: {
+                readonly widgetsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminWidgetsPort, "admin.widgets.api">;
+            };
+            readonly optional: {
+                readonly widgetsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsEventsPort, "admin.widgets.events">;
+                readonly widgetsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsNavigationPort, "admin.widgets.navigation">;
+            };
+            readonly messages: {
+                readonly Back: "Back";
+                readonly "Widget type to create": "Widget type to create";
+                readonly Content: "Content";
+                readonly Text: "Text";
+                readonly "Social Links": "Social Links";
+                readonly "Collection list": "Collection list";
+                readonly Menu: "Menu";
+                readonly "Contact Form": "Contact Form";
+                readonly Widgets: "Widgets";
+                readonly "Widget Regions": "Widget Regions";
+                readonly "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.": "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.";
+                readonly "Binding\u2026": "Binding…";
+                readonly "Bind region": "Bind region";
+                readonly "No regions bound yet.": "No regions bound yet.";
+                readonly "Region key": "Region key";
+                readonly Placements: "Placements";
+                readonly Manage: "Manage";
+                readonly "Create reusable content blocks and place them into your theme's widget regions.": "Create reusable content blocks and place them into your theme's widget regions.";
+                readonly "Regions \u2192": "Regions →";
+                readonly "Add New": "Add New";
+                readonly "1 widget record in this workspace could not be read.": "1 widget record in this workspace could not be read.";
+                readonly "{n} widget records in this workspace could not be read.": "{n} widget records in this workspace could not be read.";
+                readonly "Show ids": "Show ids";
+                readonly "No widgets yet.": "No widgets yet.";
+                readonly "Create one above to get started.": "Create one above to get started.";
+                readonly Title: "Title";
+                readonly Type: "Type";
+                readonly Slug: "Slug";
+                readonly Status: "Status";
+                readonly Actions: "Actions";
+                readonly Trash: "Trash";
+                readonly "Move to trash?": "Move to trash?";
+                readonly "Move to trash": "Move to trash";
+                readonly "Move \"{title}\" to trash?": "Move \"{title}\" to trash?";
+                readonly Regions: "Regions";
+                readonly "Saving\u2026": "Saving…";
+                readonly Save: "Save";
+                readonly "Region:": "Region:";
+                readonly "Manage which widgets appear in this region and their order.": "Manage which widgets appear in this region and their order.";
+                readonly "No widgets placed in this region yet.": "No widgets placed in this region yet.";
+                readonly Enabled: "Enabled";
+                readonly "\u26A0 Broken reference": "⚠ Broken reference";
+                readonly "+ Add widget": "+ Add widget";
+                readonly "New widget": "New widget";
+                readonly "Edit widget": "Edit widget";
+                readonly "Configure this widget's title and settings.": "Configure this widget's title and settings.";
+                readonly "Widget title": "Widget title";
+                readonly "Type:": "Type:";
+                readonly "Region area": "Region area";
+                readonly "Inline embed": "Inline embed";
+                readonly "Used in 1 place:": "Used in 1 place:";
+                readonly "Used in {count} places:": "Used in {count} places:";
+                readonly "failed to load widget": "failed to load widget";
+                readonly "save failed": "save failed";
+                readonly "This widget changed since you loaded it, refresh and try again.": "This widget changed since you loaded it, refresh and try again.";
+                readonly "This region changed since you loaded it, refresh and try again.": "This region changed since you loaded it, refresh and try again.";
+                readonly "failed to load region": "failed to load region";
+                readonly "failed to load widgets": "failed to load widgets";
+                readonly "delete failed": "delete failed";
+                readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+                readonly "failed to load regions": "failed to load regions";
+                readonly "bind failed": "bind failed";
+                readonly "Loading widget\u2026": "Loading widget…";
+                readonly "No widget type specified.": "No widget type specified.";
+                readonly "Unknown widget type \"": "Unknown widget type \"";
+                readonly "Loading region\u2026": "Loading region…";
+                readonly "Move up": "Move up";
+                readonly "Move down": "Move down";
+                readonly Remove: "Remove";
+                readonly "Loading regions\u2026": "Loading regions…";
+                readonly "Loading widgets\u2026": "Loading widgets…";
+                readonly "Saved \u00B7 version {version}": "Saved · version {version}";
+            };
+            readonly pages: {
+                readonly library: {
+                    readonly path: "/widgets";
+                    readonly label: "Widgets";
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "Content";
+                    };
+                    readonly tabs: {};
+                };
+                readonly editor: {
+                    readonly path: "/widgets/:widgetId";
+                    readonly label: "Edit widget";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+                readonly regions: {
+                    readonly path: "/widgets/regions";
+                    readonly label: "Widget Regions";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+                readonly region: {
+                    readonly path: "/widgets/regions/:regionKey";
+                    readonly label: "Region:";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+            };
+        };
+        pages: {
+            readonly library: {
+                Page: import("react").LazyExoticComponent<ComponentType<ModulePageProps>>;
+                tabs: {};
+            };
+            readonly editor: {
+                Page: import("react").LazyExoticComponent<ComponentType<ModulePageProps>>;
+                tabs: {};
+            };
+            readonly regions: {
+                Page: import("react").LazyExoticComponent<ComponentType<ModulePageProps>>;
+                tabs: {};
+            };
+            readonly region: {
+                Page: import("react").LazyExoticComponent<ComponentType<ModulePageProps>>;
+                tabs: {};
+            };
+        };
+        usePorts: (_required?: Record<string, never>, _optional?: Record<string, never>) => import("../../core/module/types.js").ScopedPorts<{
+            readonly id: "widgets";
+            readonly requires: {
+                readonly widgetsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminWidgetsPort, "admin.widgets.api">;
+            };
+            readonly optional: {
+                readonly widgetsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsEventsPort, "admin.widgets.events">;
+                readonly widgetsNavigation: import("../../core/module/token.js").AdminPortToken<import("../ports.js").WidgetsNavigationPort, "admin.widgets.navigation">;
+            };
+            readonly messages: {
+                readonly Back: "Back";
+                readonly "Widget type to create": "Widget type to create";
+                readonly Content: "Content";
+                readonly Text: "Text";
+                readonly "Social Links": "Social Links";
+                readonly "Collection list": "Collection list";
+                readonly Menu: "Menu";
+                readonly "Contact Form": "Contact Form";
+                readonly Widgets: "Widgets";
+                readonly "Widget Regions": "Widget Regions";
+                readonly "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.": "A region is a theme-declared placement area (e.g. \"header\", \"footer\", \"sidebar\"). Bind a region by its key to start placing widgets in it.";
+                readonly "Binding\u2026": "Binding…";
+                readonly "Bind region": "Bind region";
+                readonly "No regions bound yet.": "No regions bound yet.";
+                readonly "Region key": "Region key";
+                readonly Placements: "Placements";
+                readonly Manage: "Manage";
+                readonly "Create reusable content blocks and place them into your theme's widget regions.": "Create reusable content blocks and place them into your theme's widget regions.";
+                readonly "Regions \u2192": "Regions →";
+                readonly "Add New": "Add New";
+                readonly "1 widget record in this workspace could not be read.": "1 widget record in this workspace could not be read.";
+                readonly "{n} widget records in this workspace could not be read.": "{n} widget records in this workspace could not be read.";
+                readonly "Show ids": "Show ids";
+                readonly "No widgets yet.": "No widgets yet.";
+                readonly "Create one above to get started.": "Create one above to get started.";
+                readonly Title: "Title";
+                readonly Type: "Type";
+                readonly Slug: "Slug";
+                readonly Status: "Status";
+                readonly Actions: "Actions";
+                readonly Trash: "Trash";
+                readonly "Move to trash?": "Move to trash?";
+                readonly "Move to trash": "Move to trash";
+                readonly "Move \"{title}\" to trash?": "Move \"{title}\" to trash?";
+                readonly Regions: "Regions";
+                readonly "Saving\u2026": "Saving…";
+                readonly Save: "Save";
+                readonly "Region:": "Region:";
+                readonly "Manage which widgets appear in this region and their order.": "Manage which widgets appear in this region and their order.";
+                readonly "No widgets placed in this region yet.": "No widgets placed in this region yet.";
+                readonly Enabled: "Enabled";
+                readonly "\u26A0 Broken reference": "⚠ Broken reference";
+                readonly "+ Add widget": "+ Add widget";
+                readonly "New widget": "New widget";
+                readonly "Edit widget": "Edit widget";
+                readonly "Configure this widget's title and settings.": "Configure this widget's title and settings.";
+                readonly "Widget title": "Widget title";
+                readonly "Type:": "Type:";
+                readonly "Region area": "Region area";
+                readonly "Inline embed": "Inline embed";
+                readonly "Used in 1 place:": "Used in 1 place:";
+                readonly "Used in {count} places:": "Used in {count} places:";
+                readonly "failed to load widget": "failed to load widget";
+                readonly "save failed": "save failed";
+                readonly "This widget changed since you loaded it, refresh and try again.": "This widget changed since you loaded it, refresh and try again.";
+                readonly "This region changed since you loaded it, refresh and try again.": "This region changed since you loaded it, refresh and try again.";
+                readonly "failed to load region": "failed to load region";
+                readonly "failed to load widgets": "failed to load widgets";
+                readonly "delete failed": "delete failed";
+                readonly "This item changed since you loaded it. Reload and try again.": "This item changed since you loaded it. Reload and try again.";
+                readonly "failed to load regions": "failed to load regions";
+                readonly "bind failed": "bind failed";
+                readonly "Loading widget\u2026": "Loading widget…";
+                readonly "No widget type specified.": "No widget type specified.";
+                readonly "Unknown widget type \"": "Unknown widget type \"";
+                readonly "Loading region\u2026": "Loading region…";
+                readonly "Move up": "Move up";
+                readonly "Move down": "Move down";
+                readonly Remove: "Remove";
+                readonly "Loading regions\u2026": "Loading regions…";
+                readonly "Loading widgets\u2026": "Loading widgets…";
+                readonly "Saved \u00B7 version {version}": "Saved · version {version}";
+            };
+            readonly pages: {
+                readonly library: {
+                    readonly path: "/widgets";
+                    readonly label: "Widgets";
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "Content";
+                    };
+                    readonly tabs: {};
+                };
+                readonly editor: {
+                    readonly path: "/widgets/:widgetId";
+                    readonly label: "Edit widget";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+                readonly regions: {
+                    readonly path: "/widgets/regions";
+                    readonly label: "Widget Regions";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+                readonly region: {
+                    readonly path: "/widgets/regions/:regionKey";
+                    readonly label: "Region:";
+                    readonly agentReachable: true;
+                    readonly tabs: {};
+                };
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/widgets/react/index.js

@@ -0,0 +1,31 @@
+import { createElement } from 'react';
+import { bindReact } from '../../core/react/bind-react.js';
+import { widgetsModule } from '../widgets.module.js';
+import { WidgetsPortsContext, WidgetsOptionsContext } from './hooks/WidgetsPorts.hooks.js';
+export { useWidgetsPorts, useWidgetsOptions } from './hooks/WidgetsPorts.hooks.js';
+/** Lazy pages share injected options while bindReact owns the API scope. */
+export function widgets({ slots, widgetTypes, defaultConfig }, optional = {}) {
+    // Scope membership uses object identity, so bind and return this same per-admin module.
+    const module = { ...widgetsModule };
+    const defaults = { slots, widgetTypes, defaultConfig, ...optional };
+    function page(load, params) {
+        return async () => {
+            const loaded = await load();
+            return { default: (props) => createElement(loaded.default, params(props)) };
+        };
+    }
+    const react = bindReact({ module, views: {
+            library: { page: page(() => import('./pages/WidgetsLibrary.js'), () => ({})), tabs: {} },
+            editor: { page: page(() => import('./pages/WidgetInstanceEditor.js'), props => ({ widgetId: props.params?.widgetId ?? props.widgetId ?? null, widgetType: props.params?.widgetType ?? props.widgetType ?? null })), tabs: {} },
+            regions: { page: page(() => import('./pages/WidgetRegions.js'), () => ({})), tabs: {} },
+            region: { page: page(() => import('./pages/WidgetRegionEditor.js'), props => ({ regionKey: props.params?.regionKey ?? props.regionKey ?? '' })), tabs: {} },
+        } }, { context: WidgetsPortsContext });
+    /** Refresh host options without replacing lazy views or discarding controller drafts.
+     * Factory defaults support existing hosts; the port scope remains owned by bindReact.
+     */
+    function Provider({ admin, children, options = defaults }, _optional = {}) {
+        return createElement(react.Provider, { admin, children: createElement(WidgetsOptionsContext.Provider, { value: options }, children) });
+    }
+    return Object.assign(module, { react: { ...react, Provider } });
+}
+//# sourceMappingURL=index.js.map

package/dist/widgets/react/pages/WidgetInstanceEditor.d.ts

@@ -0,0 +1,23 @@
+import { useWiredWidgetInstanceEditor } from "../hooks/use-widget-instance-editor.hooks.js";
+/**
+ * @file `WidgetInstanceEditorScreen` (`ui.spec.md` §2.2/§3.3/§4.3) — create/edit one widget
+ * instance, `/admin/widgets/new?type=X` and `/admin/widgets/{id}` — markup only. Mirrors
+ * `MenuEditor.tsx`'s editor-shell shape; config editing delegates to the shared
+ * `WidgetConfigFields` (§3.4).
+ *
+ * State, the fetch, and save live in `../hooks/use-widget-instance-editor.hooks.ts`; the field-error
+ * extraction, the known-type check, and the type label live in `../../rules.ts`.
+ */
+export { widgetInstanceGuard } from '../../rules.js';
+export interface WidgetInstanceEditorProps {
+    widgetId: string | null;
+    widgetType: string | null;
+    /**
+     * Dependency injection seam for tests — the same convention `Posts.tsx`'s `usePostsHook` uses.
+     * Defaulted to the real hook, so production callers pass nothing and behave exactly as before.
+     */
+    useWidgetInstanceEditorHook?: typeof useWiredWidgetInstanceEditor | undefined;
+}
+export declare function WidgetInstanceEditor(props: WidgetInstanceEditorProps): import("react").JSX.Element | null;
+export default WidgetInstanceEditor;
+//# sourceMappingURL=WidgetInstanceEditor.d.ts.map

package/dist/widgets/react/pages/WidgetInstanceEditor.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useWidgetInstanceEditorView } from '../hooks/page-views.hooks.js';
+import { useWidgetsOptions } from '../hooks/WidgetsPorts.hooks.js';
+import { agentHandle } from "@jini-ai/agentic";
+import { widgetTypeLabel } from "../../rules.js";
+import { useWiredWidgetInstanceEditor } from "../hooks/use-widget-instance-editor.hooks.js";
+/**
+ * @file `WidgetInstanceEditorScreen` (`ui.spec.md` §2.2/§3.3/§4.3) — create/edit one widget
+ * instance, `/admin/widgets/new?type=X` and `/admin/widgets/{id}` — markup only. Mirrors
+ * `MenuEditor.tsx`'s editor-shell shape; config editing delegates to the shared
+ * `WidgetConfigFields` (§3.4).
+ *
+ * State, the fetch, and save live in `../hooks/use-widget-instance-editor.hooks.ts`; the field-error
+ * extraction, the known-type check, and the type label live in `../../rules.ts`.
+ */
+export { widgetInstanceGuard } from '../../rules.js';
+import { WhereUsedBanner, WidgetInstanceGuardNotice } from '../components/WidgetInstanceNotices.js';
+export function WidgetInstanceEditor(props) {
+    const { slots: { ConfigFields: WidgetConfigFields }, widgetTypes } = useWidgetsOptions();
+    const { widgetId, widgetType: queryWidgetType, useWidgetInstanceEditorHook = useWiredWidgetInstanceEditor } = props;
+    const { isNew, widget, whereUsed, title, setTitle, config, setConfig, message, error, fieldErrors, loading, saving, widgetType, save, confirmLeave, t, locale, guard, onBackClick, } = useWidgetInstanceEditorView({ widgetId, widgetType: queryWidgetType, useWidgetInstanceEditorHook, widgetTypes });
+    if (guard)
+        return _jsx(WidgetInstanceGuardNotice, { guard: guard, t: t });
+    // Unreachable in practice — `widgetInstanceGuard`'s "no-type" case already covers a null
+    // `widgetType` above — but TS can't see through that opaque function call, so this narrows the
+    // type for the JSX below rather than asserting it with `!`.
+    if (!widgetType)
+        return null;
+    // The host slot binds shared-component translations; screen copy uses the module t.
+    const sharedT = t;
+    return (_jsxs("div", { className: "page", children: [_jsxs("div", { className: "page-header page-header-split", ...agentHandle({ handle: "widget-instance-header" }, {
+                    role: "region",
+                    label: "Widget editor header — the back link, the widget's title, and the Save button",
+                }), children: [_jsx("div", { className: "page-header-lead", children: _jsxs("a", { className: "btn-secondary", href: "/admin/widgets", onClick: onBackClick, "aria-label": `${t("Back")}: ${t("Widgets")}`, ...agentHandle({ handle: "widget-instance-back" }, { role: "link", label: "Back to Widgets" }), children: ["\u2190 ", t("Back")] }) }), _jsxs("div", { className: "page-header-text", children: [_jsx("p", { className: "page-kicker", children: t("Content") }), _jsx("h1", { className: "page-title", children: t(isNew ? "New widget" : "Edit widget") }), _jsx("p", { className: "page-description", children: t("Configure this widget's title and settings.") })] }), _jsxs("div", { className: "page-header-actions page-actions", children: [message ? _jsx("span", { className: "save-ok", children: message }) : null, error ? (_jsx("span", { className: "save-error", role: "alert", children: error })) : null, _jsx("button", { onClick: save, disabled: saving, ...agentHandle({ handle: "widget-instance-save" }, { role: "button", label: "Save this widget" }), children: saving ? t("Saving…") : t("Save") })] })] }), widget ? _jsx(WhereUsedBanner, { whereUsed: whereUsed, t: t }) : null, _jsxs("label", { className: "a11y-label-wrap", children: [_jsx("span", { className: "visually-hidden", children: t("Widget title") }), _jsx("input", { className: "editor-title", value: title, onChange: (e) => setTitle(e.target.value), placeholder: t("Widget title"), ...agentHandle({ handle: "widget-instance-title" }, { role: "field", label: "This widget's title" }) })] }), _jsxs("p", { className: "muted-cell", children: [t("Type:"), " ", widgetTypeLabel({ widgetType, types: widgetTypes }, { t })] }), _jsxs("div", { className: "widget-config-form", children: [_jsx(WidgetConfigFields, { widgetType: widgetType, config: config, onChange: setConfig, agentHandle: "widget-instance-config", t: sharedT }), fieldErrors.map((fe, i) => (_jsxs("p", { className: "save-error", role: "alert", children: [fe.field, ": ", fe.reason] }, i)))] })] }));
+}
+export default WidgetInstanceEditor;
+//# sourceMappingURL=WidgetInstanceEditor.js.map

package/dist/widgets/react/pages/WidgetRegionEditor.d.ts

@@ -0,0 +1,22 @@
+import { useWiredWidgetRegionEditor } from "../hooks/use-widget-region-editor.hooks.js";
+/**
+ * @file `RegionPlacementEditorScreen` + `RegionPlacementList` (`ui.spec.md` §2.5/§2.6/§3.7/§3.8/
+ * §4.6/§4.7) — `/admin/widgets/regions/{regionKey}` — markup only. Flat ordered list, ↑/↓ move
+ * controls, mirrors `MenuEditor.tsx`'s `ItemRow`/`moveAtPath` reorder UX exactly, without the
+ * nesting a menu tree has (a region's placement list has no parent/child structure, REQ-15).
+ *
+ * State, the fetch, and save live in `../hooks/use-widget-region-editor.hooks.ts`; the reorder swap
+ * and the draft-placement builder live in `../../rules.ts`.
+ */
+export interface WidgetRegionEditorProps {
+    regionKey: string;
+    /**
+     * Dependency injection seam for tests — the same convention `Posts.tsx`'s `usePostsHook` uses.
+     * Defaulted to the real hook, so production callers pass nothing and behave exactly as before.
+     */
+    useWidgetRegionEditorHook?: typeof useWiredWidgetRegionEditor | undefined;
+}
+export { WidgetRegionEditorHeaderActions } from '../components/WidgetRegionEditorHeaderActions.js';
+export declare function WidgetRegionEditor(props: WidgetRegionEditorProps): import("react").JSX.Element | null;
+export default WidgetRegionEditor;
+//# sourceMappingURL=WidgetRegionEditor.d.ts.map

package/dist/widgets/react/pages/WidgetRegionEditor.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useWidgetRegionEditorView } from '../hooks/page-views.hooks.js';
+import { useWidgetsOptions } from '../hooks/WidgetsPorts.hooks.js';
+import { agentHandle } from "@jini-ai/agentic";
+import { useWiredWidgetRegionEditor } from "../hooks/use-widget-region-editor.hooks.js";
+import { widgetTypeLabel } from "../../rules.js";
+export { WidgetRegionEditorHeaderActions } from '../components/WidgetRegionEditorHeaderActions.js';
+import { WidgetRegionEditorHeaderActions } from '../components/WidgetRegionEditorHeaderActions.js';
+export function WidgetRegionEditor(props) {
+    const { slots: { AddControl: WidgetAddControl }, widgetTypes } = useWidgetsOptions();
+    const { regionKey, useWidgetRegionEditorHook = useWiredWidgetRegionEditor } = props;
+    const { area, placements, message, error, loading, saving, removeAt, moveAt, toggleEnabled, addPlacement, save, t, locale, placementHandles } = useWidgetRegionEditorView({ regionKey, useWidgetRegionEditorHook });
+    if (error && !area)
+        return _jsx("div", { className: "notice error", children: error });
+    if (loading)
+        return _jsx("div", { className: "notice", children: t("Loading region…") });
+    if (!area)
+        return null;
+    return (_jsxs("div", { className: "page", children: [_jsxs("div", { className: "page-header page-header-split", ...agentHandle({ handle: "widget-region-editor-header" }, {
+                    role: "region",
+                    label: "Widget region editor header — the back link, the region's title, and the Save button",
+                }), children: [_jsx("div", { className: "page-header-lead", children: _jsxs("a", { className: "btn-secondary", href: "/admin/widgets/regions", "aria-label": `${t("Back")}: ${t("Regions")}`, ...agentHandle({ handle: "widget-region-editor-back" }, { role: "link", label: "Back to Widget Regions" }), children: ["\u2190 ", t("Back")] }) }), _jsxs("div", { className: "page-header-text", children: [_jsx("p", { className: "page-kicker", children: t("Content") }), _jsxs("h1", { className: "page-title", children: [t("Region:"), " ", regionKey] }), _jsx("p", { className: "page-description", children: t("Manage which widgets appear in this region and their order.") })] }), _jsx(WidgetRegionEditorHeaderActions, { message: message, error: error, saving: saving, onSave: save, t: t })] }), _jsxs("div", { className: "widget-region-placements", children: [placements.length === 0 ? (_jsx("div", { className: "card", children: _jsx("div", { className: "empty-state", children: _jsx("p", { children: t("No widgets placed in this region yet.") }) }) })) : (placements.map((placement, i) => (_jsx("div", { className: "menu-item-row", children: _jsxs("div", { className: "menu-item-fields", children: [placement.broken ? (_jsx("span", { className: "widget-embed-node--broken", children: t("⚠ Broken reference") })) : (_jsxs("span", { children: [_jsx("strong", { children: placement.widgetTitle }), placement.widgetType ? (_jsxs(_Fragment, { children: [" ", _jsxs("span", { className: "muted-cell", children: ["(", widgetTypeLabel({ widgetType: placement.widgetType, types: widgetTypes }, { t }), ")"] })] })) : null] })), _jsxs("label", { children: [_jsx("input", { type: "checkbox", checked: placement.enabled, onChange: () => toggleEnabled(placement.placementId), ...agentHandle({ handle: `${placementHandles[i]}-enabled` }, { role: "field", label: `Whether "${placement.widgetTitle}" is enabled` }) }), t("Enabled")] }), _jsx("button", { className: "tb-btn", onClick: () => moveAt(i, -1), title: t("Move up"), "aria-label": t("Move up"), ...agentHandle({ handle: `${placementHandles[i]}-move-up` }, { role: "button", label: `Move "${placement.widgetTitle}" up` }), children: "\u2191" }), _jsx("button", { className: "tb-btn", onClick: () => moveAt(i, 1), title: t("Move down"), "aria-label": t("Move down"), ...agentHandle({ handle: `${placementHandles[i]}-move-down` }, { role: "button", label: `Move "${placement.widgetTitle}" down` }), children: "\u2193" }), _jsx("button", { className: "tb-btn", onClick: () => removeAt(placement.placementId), title: t("Remove"), "aria-label": t("Remove"), ...agentHandle({ handle: `${placementHandles[i]}-remove` }, { role: "button", label: `Remove "${placement.widgetTitle}" from this region` }), children: "\u2715" })] }) }, placement.placementId)))), _jsx(WidgetAddControl, { triggerLabel: t("+ Add widget"), onResolved: (widgetInstanceId) => addPlacement(widgetInstanceId), agentHandle: "widget-region-add" })] })] }));
+}
+export default WidgetRegionEditor;
+//# sourceMappingURL=WidgetRegionEditor.js.map

package/dist/widgets/react/pages/WidgetRegions.d.ts

@@ -0,0 +1,21 @@
+import { useWiredWidgetRegions } from "../hooks/use-widget-regions.hooks.js";
+/**
+ * @file `WidgetRegionsScreen` (`ui.spec.md` §2.4/§3.6/§4.5/§9) — `/admin/widgets/regions` — markup
+ * only. Lists currently-bound regions; the bind-new-region control is a free-text `regionKey`
+ * input, mirroring `Menus.tsx`'s location-assign control exactly (no "theme declares regions" list
+ * API exists to source a dropdown from — `ThemeManifest.regions` is read server-side at render
+ * time, not exposed as an admin-listable registry; see `ui.spec.md` §9's disclosed dependency-gap
+ * note).
+ *
+ * State, the fetch, and bind live in `../hooks/use-widget-regions.hooks.ts`.
+ */
+export interface WidgetRegionsProps {
+    /**
+     * Dependency injection seam for tests — the same convention `Posts.tsx`'s `usePostsHook` uses.
+     * Defaulted to the real hook, so production callers pass nothing and behave exactly as before.
+     */
+    useWidgetRegionsHook?: typeof useWiredWidgetRegions | undefined;
+}
+export declare function WidgetRegions({ useWidgetRegionsHook }?: WidgetRegionsProps): import("react").JSX.Element;
+export default WidgetRegions;
+//# sourceMappingURL=WidgetRegions.d.ts.map