@elytracms/studio 0.0.100 → 0.0.101

package/dist/components/load-failure.d.ts

@@ -0,0 +1,62 @@
+import { Component } from 'react';
+import type { ReactNode } from 'react';
+/** Is this error a lazily imported module that failed to download? (pure) */
+export declare function isModuleLoadFailure(error: unknown): boolean;
+/** Where the notice renders: the whole page (the root catch-all) or in place of one surface. */
+export type FailurePlacement = 'page' | 'panel';
+export interface FailureNoticeProps {
+    error: unknown;
+    placement: FailurePlacement;
+    /** Playground mode — Reload then states that it empties the playground. */
+    playground: boolean;
+    onBack: () => void;
+    onReload: () => void;
+}
+/**
+ * The notice itself — presentational, every effect injected, so its two shapes are pinned
+ * with `renderToStaticMarkup`. {@link StudioFailure} wires it to the router and the page.
+ */
+export declare function FailureNotice({ error, placement, playground, onBack, onReload }: FailureNoticeProps): import("react").JSX.Element;
+/**
+ * The wired notice. **Back** goes one step back in the router's own history — in-app, no
+ * reload — or, when this tab has no earlier studio entry (a deep link), to the studio home;
+ * leaving the studio would unload the playground, which is exactly what Back is for avoiding.
+ * **Reload** is the full page reload it says it is.
+ */
+export declare function StudioFailure({ error, placement }: {
+    error: unknown;
+    placement: FailurePlacement;
+}): import("react").JSX.Element;
+/**
+ * The root route's `errorComponent` — the catch-all for any error no surface boundary took.
+ * It renders inside the root `shellComponent` (the `<html>` document with the stylesheet),
+ * so it is themed; outside the provider stack, so it needs none of it.
+ */
+export declare function StudioRouteError({ error }: {
+    error: unknown;
+}): import("react").JSX.Element;
+export interface LazySurfaceBoundaryProps {
+    children: ReactNode;
+    /**
+     * Frame the notice the way the surface frames itself (the AI panel's aside, the translate
+     * dialog) so the failure shows exactly where the surface would have. Default: unframed.
+     */
+    frame?: (notice: ReactNode) => ReactNode;
+}
+interface LazySurfaceBoundaryState {
+    /** `[error]`, so a thrown `undefined` still counts as caught. */
+    caught: [unknown] | null;
+}
+/**
+ * The ONE boundary each lazily loaded surface sits in (EC-717): a failed panel shows the
+ * notice IN PLACE and the rest of the studio stays usable. Measured before it existed: one
+ * failed translate chunk blanked the whole studio. It never resets on its own — the lazy
+ * import's rejection is cached, so re-rendering would only throw again; the surface's own
+ * unmount (closing the panel or dialog, leaving the document) is the reset.
+ */
+export declare class LazySurfaceBoundary extends Component<LazySurfaceBoundaryProps, LazySurfaceBoundaryState> {
+    state: LazySurfaceBoundaryState;
+    static getDerivedStateFromError(error: unknown): LazySurfaceBoundaryState;
+    render(): ReactNode;
+}
+export {};

package/dist/components/load-failure.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from 'react';
+import { useRouter } from '@tanstack/react-router';
+import { CircleAlert, PackageX } from 'lucide-react';
+import { Button, Heading, Row, Stack, Text } from '@elytracms/studio/ui';
+import { cn } from '../lib/utils.js';
+import { useT } from '../lib/i18n/index.js';
+import { isPlaygroundMode } from '../lib/persistence/index.js';
+/**
+ * The studio's failure notice (EC-717) — what a render error shows instead of the whole
+ * studio disappearing. Two places use it: the root route's `errorComponent` (the catch-all,
+ * rendered inside the themed document shell) and {@link LazySurfaceBoundary}, which sits
+ * inside each of the five lazily loaded surfaces so a failed panel stays a local notice.
+ *
+ * **The failure it names first** is a module that did not download. Measured (EC-567 V6): a
+ * CLI command beside `pnpm dev` swapped the dev server's dep cache, every chunk URL the page
+ * already knew answered 504, and the next lazily imported surface threw "Failed to fetch
+ * dynamically imported module". A dependency added while the studio is open does the same.
+ *
+ * **Why there is no retry button.** A retry cannot re-import a failed module without a
+ * reload (measured in Chromium for the operator's decision): the browser never re-fetches a
+ * failed `import()` URL, a cache-busted parent still fails on its failed static dependency,
+ * and `React.lazy` caches the rejection. So the notice offers what does work:
+ * - **Back** — in-app navigation, no reload, so the playground's in-memory content survives
+ *   (its adapter is module-cached); the failed surface stays unavailable until a reload.
+ * - **Reload** — saying what it costs in the playground: everything in this tab.
+ * - **Restart the dev server** — when a reload does not help, because the dep cache itself was
+ *   destroyed and the chunks it named are gone until Vite re-optimizes.
+ *
+ * Any other error gets a plain message and Reload. Its message is always shown — a notice
+ * that hid what broke would be the silent failure the studio never ships.
+ */
+/**
+ * The browsers' messages for a dynamic import whose module (or one of its static
+ * dependencies) failed to download — Chromium, Firefox, Safari. The same three
+ * TanStack Router recognises (`isModuleNotFoundError`, used by its lazy route components).
+ */
+const MODULE_LOAD_FAILURE_PREFIXES = [
+    'Failed to fetch dynamically imported module',
+    'error loading dynamically imported module',
+    'Importing a module script failed',
+];
+/** Is this error a lazily imported module that failed to download? (pure) */
+export function isModuleLoadFailure(error) {
+    const message = errorMessage(error);
+    return message !== undefined && MODULE_LOAD_FAILURE_PREFIXES.some((prefix) => message.startsWith(prefix));
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'object' && error !== null && typeof error.message === 'string') {
+        return error.message;
+    }
+    return typeof error === 'string' ? error : undefined;
+}
+/**
+ * The notice itself — presentational, every effect injected, so its two shapes are pinned
+ * with `renderToStaticMarkup`. {@link StudioFailure} wires it to the router and the page.
+ */
+export function FailureNotice({ error, placement, playground, onBack, onReload }) {
+    const t = useT();
+    const moduleFailure = isModuleLoadFailure(error);
+    const Icon = moduleFailure ? PackageX : CircleAlert;
+    const detail = errorMessage(error);
+    return (_jsx("div", { "data-studio-failure": moduleFailure ? 'module' : 'error', role: "alert", className: cn('grid place-items-center', placement === 'page' ? 'min-h-dvh bg-background p-8' : 'min-h-0 w-full flex-1 p-4'), children: _jsxs(Stack, { gap: "3", className: cn('w-full rounded-xl border border-dashed border-destructive/30 bg-destructive/5', placement === 'page' ? 'max-w-lg px-8 py-8' : 'max-w-md px-5 py-5'), children: [_jsxs(Row, { gap: "2", align: "center", children: [_jsx(Icon, { "aria-hidden": true, className: "size-5 shrink-0 text-destructive" }), _jsx(Heading, { level: placement === 'page' ? 1 : 2, size: "h3", children: t(moduleFailure ? 'shell.failure.module.title' : 'shell.failure.error.title') })] }), _jsx(Text, { size: "sm", tone: "muted", children: t(moduleFailure ? 'shell.failure.module.body' : 'shell.failure.error.body') }), detail ? (_jsx(Text, { as: "div", size: "xs", tone: "muted", mono: true, className: "max-h-24 overflow-auto break-all rounded-md bg-muted/60 px-2 py-1.5", children: detail })) : null, _jsxs(Row, { gap: "2", wrap: true, children: [moduleFailure ? (_jsx(Button, { size: "sm", onClick: onBack, "data-testid": "studio-failure-back", children: t('shell.failure.back') })) : null, _jsx(Button, { size: "sm", variant: moduleFailure ? 'outline' : 'default', onClick: onReload, "data-testid": "studio-failure-reload", children: t('shell.failure.reload') })] }), playground ? (_jsx(Text, { size: "xs", tone: "muted", children: t('shell.failure.reloadCost') })) : null, moduleFailure ? (_jsx(Text, { size: "xs", tone: "muted", children: t('shell.failure.module.restartHint') })) : null] }) }));
+}
+/**
+ * The wired notice. **Back** goes one step back in the router's own history — in-app, no
+ * reload — or, when this tab has no earlier studio entry (a deep link), to the studio home;
+ * leaving the studio would unload the playground, which is exactly what Back is for avoiding.
+ * **Reload** is the full page reload it says it is.
+ */
+export function StudioFailure({ error, placement }) {
+    const router = useRouter();
+    return (_jsx(FailureNotice, { error: error, placement: placement, playground: isPlaygroundMode(), onBack: () => {
+            if (router.history.canGoBack())
+                router.history.back();
+            else
+                void router.navigate({ to: '/' });
+        }, onReload: () => window.location.reload() }));
+}
+/**
+ * The root route's `errorComponent` — the catch-all for any error no surface boundary took.
+ * It renders inside the root `shellComponent` (the `<html>` document with the stylesheet),
+ * so it is themed; outside the provider stack, so it needs none of it.
+ */
+export function StudioRouteError({ error }) {
+    return _jsx(StudioFailure, { error: error, placement: "page" });
+}
+/**
+ * The ONE boundary each lazily loaded surface sits in (EC-717): a failed panel shows the
+ * notice IN PLACE and the rest of the studio stays usable. Measured before it existed: one
+ * failed translate chunk blanked the whole studio. It never resets on its own — the lazy
+ * import's rejection is cached, so re-rendering would only throw again; the surface's own
+ * unmount (closing the panel or dialog, leaving the document) is the reset.
+ */
+export class LazySurfaceBoundary extends Component {
+    state = { caught: null };
+    static getDerivedStateFromError(error) {
+        return { caught: [error] };
+    }
+    render() {
+        const { caught } = this.state;
+        if (!caught)
+            return this.props.children;
+        const notice = _jsx(StudioFailure, { error: caught[0], placement: "panel" });
+        return this.props.frame ? this.props.frame(notice) : notice;
+    }
+}
+//# sourceMappingURL=load-failure.js.map

package/dist/components/load-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-failure.js","sourceRoot":"","sources":["../../src/components/load-failure.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Component } from 'react'\nimport type { ReactNode } from 'react'\nimport { useRouter } from '@tanstack/react-router'\nimport { CircleAlert, PackageX } from 'lucide-react'\nimport { Button, Heading, Row, Stack, Text } from '@elytracms/studio/ui'\nimport { cn } from '../lib/utils'\nimport { useT } from '../lib/i18n'\nimport { isPlaygroundMode } from '../lib/persistence'\n\n/**\n * The studio's failure notice (EC-717) — what a render error shows instead of the whole\n * studio disappearing. Two places use it: the root route's `errorComponent` (the catch-all,\n * rendered inside the themed document shell) and {@link LazySurfaceBoundary}, which sits\n * inside each of the five lazily loaded surfaces so a failed panel stays a local notice.\n *\n * **The failure it names first** is a module that did not download. Measured (EC-567 V6): a\n * CLI command beside `pnpm dev` swapped the dev server's dep cache, every chunk URL the page\n * already knew answered 504, and the next lazily imported surface threw \"Failed to fetch\n * dynamically imported module\". A dependency added while the studio is open does the same.\n *\n * **Why there is no retry button.** A retry cannot re-import a failed module without a\n * reload (measured in Chromium for the operator's decision): the browser never re-fetches a\n * failed `import()` URL, a cache-busted parent still fails on its failed static dependency,\n * and `React.lazy` caches the rejection. So the notice offers what does work:\n * - **Back** — in-app navigation, no reload, so the playground's in-memory content survives\n *   (its adapter is module-cached); the failed surface stays unavailable until a reload.\n * - **Reload** — saying what it costs in the playground: everything in this tab.\n * - **Restart the dev server** — when a reload does not help, because the dep cache itself was\n *   destroyed and the chunks it named are gone until Vite re-optimizes.\n *\n * Any other error gets a plain message and Reload. Its message is always shown — a notice\n * that hid what broke would be the silent failure the studio never ships.\n */\n\n/**\n * The browsers' messages for a dynamic import whose module (or one of its static\n * dependencies) failed to download — Chromium, Firefox, Safari. The same three\n * TanStack Router recognises (`isModuleNotFoundError`, used by its lazy route components).\n */\nconst MODULE_LOAD_FAILURE_PREFIXES = [\n  'Failed to fetch dynamically imported module',\n  'error loading dynamically imported module',\n  'Importing a module script failed',\n] as const\n\n/** Is this error a lazily imported module that failed to download? (pure) */\nexport function isModuleLoadFailure(error: unknown): boolean {\n  const message = errorMessage(error)\n  return message !== undefined && MODULE_LOAD_FAILURE_PREFIXES.some((prefix) => message.startsWith(prefix))\n}\n\nfunction errorMessage(error: unknown): string | undefined {\n  if (error instanceof Error) return error.message\n  if (typeof error === 'object' && error !== null && typeof (error as { message?: unknown }).message === 'string') {\n    return (error as { message: string }).message\n  }\n  return typeof error === 'string' ? error : undefined\n}\n\n/** Where the notice renders: the whole page (the root catch-all) or in place of one surface. */\nexport type FailurePlacement = 'page' | 'panel'\n\nexport interface FailureNoticeProps {\n  error: unknown\n  placement: FailurePlacement\n  /** Playground mode — Reload then states that it empties the playground. */\n  playground: boolean\n  onBack: () => void\n  onReload: () => void\n}\n\n/**\n * The notice itself — presentational, every effect injected, so its two shapes are pinned\n * with `renderToStaticMarkup`. {@link StudioFailure} wires it to the router and the page.\n */\nexport function FailureNotice({ error, placement, playground, onBack, onReload }: FailureNoticeProps) {\n  const t = useT()\n  const moduleFailure = isModuleLoadFailure(error)\n  const Icon = moduleFailure ? PackageX : CircleAlert\n  const detail = errorMessage(error)\n  return (\n    <div\n      data-studio-failure={moduleFailure ? 'module' : 'error'}\n      role=\"alert\"\n      className={cn(\n        'grid place-items-center',\n        placement === 'page' ? 'min-h-dvh bg-background p-8' : 'min-h-0 w-full flex-1 p-4',\n      )}\n    >\n      <Stack\n        gap=\"3\"\n        className={cn(\n          'w-full rounded-xl border border-dashed border-destructive/30 bg-destructive/5',\n          placement === 'page' ? 'max-w-lg px-8 py-8' : 'max-w-md px-5 py-5',\n        )}\n      >\n        <Row gap=\"2\" align=\"center\">\n          <Icon aria-hidden className=\"size-5 shrink-0 text-destructive\" />\n          <Heading level={placement === 'page' ? 1 : 2} size=\"h3\">\n            {t(moduleFailure ? 'shell.failure.module.title' : 'shell.failure.error.title')}\n          </Heading>\n        </Row>\n        <Text size=\"sm\" tone=\"muted\">\n          {t(moduleFailure ? 'shell.failure.module.body' : 'shell.failure.error.body')}\n        </Text>\n        {detail ? (\n          <Text as=\"div\" size=\"xs\" tone=\"muted\" mono className=\"max-h-24 overflow-auto break-all rounded-md bg-muted/60 px-2 py-1.5\">\n            {detail}\n          </Text>\n        ) : null}\n        <Row gap=\"2\" wrap>\n          {moduleFailure ? (\n            <Button size=\"sm\" onClick={onBack} data-testid=\"studio-failure-back\">\n              {t('shell.failure.back')}\n            </Button>\n          ) : null}\n          <Button size=\"sm\" variant={moduleFailure ? 'outline' : 'default'} onClick={onReload} data-testid=\"studio-failure-reload\">\n            {t('shell.failure.reload')}\n          </Button>\n        </Row>\n        {playground ? (\n          <Text size=\"xs\" tone=\"muted\">\n            {t('shell.failure.reloadCost')}\n          </Text>\n        ) : null}\n        {moduleFailure ? (\n          <Text size=\"xs\" tone=\"muted\">\n            {t('shell.failure.module.restartHint')}\n          </Text>\n        ) : null}\n      </Stack>\n    </div>\n  )\n}\n\n/**\n * The wired notice. **Back** goes one step back in the router's own history — in-app, no\n * reload — or, when this tab has no earlier studio entry (a deep link), to the studio home;\n * leaving the studio would unload the playground, which is exactly what Back is for avoiding.\n * **Reload** is the full page reload it says it is.\n */\nexport function StudioFailure({ error, placement }: { error: unknown; placement: FailurePlacement }) {\n  const router = useRouter()\n  return (\n    <FailureNotice\n      error={error}\n      placement={placement}\n      playground={isPlaygroundMode()}\n      onBack={() => {\n        if (router.history.canGoBack()) router.history.back()\n        else void router.navigate({ to: '/' })\n      }}\n      onReload={() => window.location.reload()}\n    />\n  )\n}\n\n/**\n * The root route's `errorComponent` — the catch-all for any error no surface boundary took.\n * It renders inside the root `shellComponent` (the `<html>` document with the stylesheet),\n * so it is themed; outside the provider stack, so it needs none of it.\n */\nexport function StudioRouteError({ error }: { error: unknown }) {\n  return <StudioFailure error={error} placement=\"page\" />\n}\n\nexport interface LazySurfaceBoundaryProps {\n  children: ReactNode\n  /**\n   * Frame the notice the way the surface frames itself (the AI panel's aside, the translate\n   * dialog) so the failure shows exactly where the surface would have. Default: unframed.\n   */\n  frame?: (notice: ReactNode) => ReactNode\n}\n\ninterface LazySurfaceBoundaryState {\n  /** `[error]`, so a thrown `undefined` still counts as caught. */\n  caught: [unknown] | null\n}\n\n/**\n * The ONE boundary each lazily loaded surface sits in (EC-717): a failed panel shows the\n * notice IN PLACE and the rest of the studio stays usable. Measured before it existed: one\n * failed translate chunk blanked the whole studio. It never resets on its own — the lazy\n * import's rejection is cached, so re-rendering would only throw again; the surface's own\n * unmount (closing the panel or dialog, leaving the document) is the reset.\n */\nexport class LazySurfaceBoundary extends Component<LazySurfaceBoundaryProps, LazySurfaceBoundaryState> {\n  override state: LazySurfaceBoundaryState = { caught: null }\n\n  static getDerivedStateFromError(error: unknown): LazySurfaceBoundaryState {\n    return { caught: [error] }\n  }\n\n  override render(): ReactNode {\n    const { caught } = this.state\n    if (!caught) return this.props.children\n    const notice = <StudioFailure error={caught[0]} placement=\"panel\" />\n    return this.props.frame ? this.props.frame(notice) : notice\n  }\n}\n"]}

package/dist/components/notifications/shell-findings.js

@@ -108,9 +108,9 @@ function useProjectConfigIssues() {
     return useMemo(() => projectConfigIssues(resolveDeploymentCollections()), []);
 }
 /**
- * EC-467 — the project's reusable-elements config issues: a declaration that cannot
- * resolve, or an ambiguous inference the studio refuses to guess through. Static per studio
- * boot (registry + config collections + studio config). The pure core is `resolveReuse`.
+ * EC-467 / EC-728 — the project's reusable-elements config issues: a declaration that cannot
+ * resolve (an undeclared project has none — the embed is declared, never inferred). Static per
+ * studio boot (registry + config collections + studio config). The pure core is `resolveReuse`.
  */
 function useReuseIssues() {
     return useMemo(() => resolveReuse(getStudioRegistry().registry.list(), resolveDeploymentCollections(), resolveDeploymentReuse())

package/dist/components/notifications/shell-findings.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-findings.js","sourceRoot":"","sources":["../../../src/components/notifications/shell-findings.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useSyncExternalStore } from 'react'\nimport type { Project } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\nimport { redirectRecordKind, roleGrantsCapability } from '@elytracms/core/persistence'\nimport { getStudioRegistry } from '../../lib/registry'\nimport {\n  projectConfigIssues,\n  resolveDeploymentCollections,\n  resolveDeploymentReuse,\n  resolveDeploymentRoutes,\n} from '../../lib/workspace'\nimport { routeValidationIssues } from '../../lib/routes/route-issues'\nimport { contentSessionOrphans, serverContentSessionOrphans, subscribeContentSession } from '../../lib/data'\nimport { projectRolePolicyFor } from '../../lib/operations/project-runtime-config'\nimport { customizationItems, orphanedCollectionItems, routeIssueItems } from '../nav-issues'\nimport type { NavIssueItem } from '../nav-issues'\nimport { useContributedNavIssues, useNavIssues } from '../nav-issues-registry'\nimport { resolveReuse } from '../builder/reuse'\nimport { useRecordList } from '../records/record-rail'\nimport { useFieldRenderers } from '../cms/field-renderer'\nimport { useProjectRole } from '../auth-context'\nimport { isNavViewVisible, useStudioNav } from '../app-views/sidebar'\nimport type { AppViewModule } from '../app-views/module'\nimport { useDeliveryHealthFindings } from '../delivery-health-banner'\nimport type { DeliveryHealthFinding } from '../delivery-health-banner'\nimport { canSeeFinding, orderFindings } from './notice-model'\nimport type { EngineFindingSource, Finding, FindingAudience } from './notice-model'\n\n/**\n * EC-690 — every persistent finding of the studio shell, for the ONE issues tray.\n *\n * The ENGINE's own sources are computed here, in render — config (EC-479), customization\n * (EC-236/467/478), the URL map (EC-469/590/628), orphaned collections (EC-606) and\n * instant-publish health (EC-268) — so they are there on the first paint (no effect has to\n * run before the badge can count them) and no contributor can overwrite them: they are not\n * in the registry's namespace at all. Contributions (`useNavIssues`, a view's `useIssues`)\n * come from the registry. Then the viewer's audience filter (owner ruling (b)) and the ONE\n * order ({@link orderFindings}).\n *\n * The findings hooks moved here from `SectionNav`, which renders none of them any more (the\n * rail foot is only its collapse toggle — owner ruling (a)).\n */\nexport function useShellFindings(project: Project): Finding[] {\n  const nav = useStudioNav(project)\n  const { issues: rendererIssues } = useFieldRenderers()\n  const configIssues = useProjectConfigIssues()\n  const reuseIssues = useReuseIssues()\n  const routeIssues = useRouteIssues(project.id)\n  const orphanIssues = useOrphanedCollectionIssues()\n  const deliveryIssues = useDeliveryHealthFindings(project.id)\n  const contributed = useContributedNavIssues()\n  const audience = useFindingAudience(project)\n\n  return useMemo(() => {\n    const engine: Finding[] = [\n      // Config issues lead: \"this project declares no collections\" explains every other\n      // emptiness on the screen, so it is the first thing to read.\n      ...asFindings('config', customizationItems(configIssues)),\n      ...asFindings('customization', customizationItems([...nav.issues, ...rendererIssues, ...reuseIssues])),\n      ...asFindings('routes', routeIssues),\n      ...asFindings('orphans', orphanIssues),\n      ...asFindings('delivery', deliveryIssues),\n    ]\n    return orderFindings([...engine, ...contributed]).filter((finding) => canSeeFinding(finding, audience))\n  }, [configIssues, nav.issues, rendererIssues, reuseIssues, routeIssues, orphanIssues, deliveryIssues, contributed, audience])\n}\n\nfunction asFindings(source: EngineFindingSource, items: readonly (NavIssueItem | DeliveryHealthFinding)[]): Finding[] {\n  return items.map((item) => ({ id: `${source}:${item.key}`, source, ...item }))\n}\n\n/**\n * Who is reading (owner ruling (b)): an admin (`project.administer`) sees config and\n * deployment findings; a located finding shows to whoever can open its location. While the\n * role is still loading nobody is an admin and no view is visible, so a gated finding\n * appears once the role is known, never to the wrong reader first.\n */\nexport function useFindingAudience(project: Project): FindingAudience {\n  const nav = useStudioNav(project)\n  const role = useProjectRole(project.id)\n  return useMemo(() => {\n    const policy = projectRolePolicyFor(project.id)\n    const ctx = { project, role }\n    return {\n      isAdmin: role !== null && roleGrantsCapability(role, 'project.administer', policy),\n      canReadContent: role !== null && roleGrantsCapability(role, 'content.read', policy),\n      views: nav.registry.views.map((view) => ({\n        id: view.id,\n        ...(view.recordKind !== undefined ? { recordKind: view.recordKind } : {}),\n        visible: role !== null && isNavViewVisible(view, ctx),\n      })),\n    }\n  }, [nav, role, project])\n}\n\n/**\n * EC-616 → EC-690: runs every view's always-on findings hook (`useIssues`) — whether or not\n * the view is open — and publishes what it returns. One component per view (each hook keeps\n * its own hook order), each its OWN publisher with the source `view:<id>`: before EC-690 every\n * probe published under the one source `view:`, so two such views overwrote each other and\n * one unmount retracted both (critic point 1).\n */\nexport function ViewIssuesProbes({ project }: { project: Project }) {\n  const nav = useStudioNav(project)\n  const issueViews = useMemo(() => nav.registry.views.filter((view) => view.useIssues), [nav])\n  return (\n    <>\n      {issueViews.map((view) => (\n        <ViewIssuesProbe key={view.id} view={view} project={project} />\n      ))}\n    </>\n  )\n}\n\nfunction ViewIssuesProbe({ view, project }: { view: AppViewModule; project: Project }) {\n  const issues = view.useIssues!({ project, projectId: project.id })\n  useNavIssues(viewIssuesSource(view.id), issues)\n  return null\n}\n\n/** The source a view's always-on findings publish under. */\nexport function viewIssuesSource(viewId: string): string {\n  return `view:${viewId}`\n}\n\n/**\n * EC-479 — what the project has not declared but the studio cannot work without. Read from\n * the config holder alone (static per studio boot), so it needs no CMS provider and is\n * memoised once. The pure decision core is `projectConfigIssues`.\n */\nfunction useProjectConfigIssues(): CustomizationIssue[] {\n  return useMemo(() => projectConfigIssues(resolveDeploymentCollections()), [])\n}\n\n/**\n * EC-467 — the project's reusable-elements config issues: a declaration that cannot\n * resolve, or an ambiguous inference the studio refuses to guess through. Static per studio\n * boot (registry + config collections + studio config). The pure core is `resolveReuse`.\n */\nfunction useReuseIssues(): CustomizationIssue[] {\n  return useMemo(\n    () =>\n      resolveReuse(getStudioRegistry().registry.list(), resolveDeploymentCollections(), resolveDeploymentReuse())\n        .issues,\n    [],\n  )\n}\n\n/**\n * EC-469 — the project's URL-map issues: two routes that match the same URLs, a redirect\n * chain that loops, a duplicate or unreadable redirect. Routes are CODE (config, static per\n * boot); redirects are editorial DATA (the rail, live) — the read shares the rail's own query\n * key, so a finding disappears the moment it is fixed; while that query is loading or failed\n * only the code-side conflicts are reported (the rail surfaces its own load error).\n */\nfunction useRouteIssues(projectId: string): NavIssueItem[] {\n  const redirects = useRecordList(redirectRecordKind, projectId).data\n  return useMemo(\n    () =>\n      routeIssueItems(\n        routeValidationIssues(\n          { routes: resolveDeploymentRoutes(), collections: resolveDeploymentCollections() },\n          redirects ?? [],\n        ),\n      ),\n    [redirects],\n  )\n}\n\n/**\n * EC-606 — stored documents whose collection the project does not declare. Read from the\n * content session (subscribable, configured from the same hydration in both modes); the\n * server snapshot is empty — there is no session during SSR. The pure mapping is\n * {@link orphanedCollectionItems}.\n */\nfunction useOrphanedCollectionIssues(): NavIssueItem[] {\n  const orphans = useSyncExternalStore(subscribeContentSession, contentSessionOrphans, serverContentSessionOrphans)\n  return useMemo(() => orphanedCollectionItems(orphans), [orphans])\n}\n"]}
+{"version":3,"file":"shell-findings.js","sourceRoot":"","sources":["../../../src/components/notifications/shell-findings.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useSyncExternalStore } from 'react'\nimport type { Project } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\nimport { redirectRecordKind, roleGrantsCapability } from '@elytracms/core/persistence'\nimport { getStudioRegistry } from '../../lib/registry'\nimport {\n  projectConfigIssues,\n  resolveDeploymentCollections,\n  resolveDeploymentReuse,\n  resolveDeploymentRoutes,\n} from '../../lib/workspace'\nimport { routeValidationIssues } from '../../lib/routes/route-issues'\nimport { contentSessionOrphans, serverContentSessionOrphans, subscribeContentSession } from '../../lib/data'\nimport { projectRolePolicyFor } from '../../lib/operations/project-runtime-config'\nimport { customizationItems, orphanedCollectionItems, routeIssueItems } from '../nav-issues'\nimport type { NavIssueItem } from '../nav-issues'\nimport { useContributedNavIssues, useNavIssues } from '../nav-issues-registry'\nimport { resolveReuse } from '../builder/reuse'\nimport { useRecordList } from '../records/record-rail'\nimport { useFieldRenderers } from '../cms/field-renderer'\nimport { useProjectRole } from '../auth-context'\nimport { isNavViewVisible, useStudioNav } from '../app-views/sidebar'\nimport type { AppViewModule } from '../app-views/module'\nimport { useDeliveryHealthFindings } from '../delivery-health-banner'\nimport type { DeliveryHealthFinding } from '../delivery-health-banner'\nimport { canSeeFinding, orderFindings } from './notice-model'\nimport type { EngineFindingSource, Finding, FindingAudience } from './notice-model'\n\n/**\n * EC-690 — every persistent finding of the studio shell, for the ONE issues tray.\n *\n * The ENGINE's own sources are computed here, in render — config (EC-479), customization\n * (EC-236/467/478), the URL map (EC-469/590/628), orphaned collections (EC-606) and\n * instant-publish health (EC-268) — so they are there on the first paint (no effect has to\n * run before the badge can count them) and no contributor can overwrite them: they are not\n * in the registry's namespace at all. Contributions (`useNavIssues`, a view's `useIssues`)\n * come from the registry. Then the viewer's audience filter (owner ruling (b)) and the ONE\n * order ({@link orderFindings}).\n *\n * The findings hooks moved here from `SectionNav`, which renders none of them any more (the\n * rail foot is only its collapse toggle — owner ruling (a)).\n */\nexport function useShellFindings(project: Project): Finding[] {\n  const nav = useStudioNav(project)\n  const { issues: rendererIssues } = useFieldRenderers()\n  const configIssues = useProjectConfigIssues()\n  const reuseIssues = useReuseIssues()\n  const routeIssues = useRouteIssues(project.id)\n  const orphanIssues = useOrphanedCollectionIssues()\n  const deliveryIssues = useDeliveryHealthFindings(project.id)\n  const contributed = useContributedNavIssues()\n  const audience = useFindingAudience(project)\n\n  return useMemo(() => {\n    const engine: Finding[] = [\n      // Config issues lead: \"this project declares no collections\" explains every other\n      // emptiness on the screen, so it is the first thing to read.\n      ...asFindings('config', customizationItems(configIssues)),\n      ...asFindings('customization', customizationItems([...nav.issues, ...rendererIssues, ...reuseIssues])),\n      ...asFindings('routes', routeIssues),\n      ...asFindings('orphans', orphanIssues),\n      ...asFindings('delivery', deliveryIssues),\n    ]\n    return orderFindings([...engine, ...contributed]).filter((finding) => canSeeFinding(finding, audience))\n  }, [configIssues, nav.issues, rendererIssues, reuseIssues, routeIssues, orphanIssues, deliveryIssues, contributed, audience])\n}\n\nfunction asFindings(source: EngineFindingSource, items: readonly (NavIssueItem | DeliveryHealthFinding)[]): Finding[] {\n  return items.map((item) => ({ id: `${source}:${item.key}`, source, ...item }))\n}\n\n/**\n * Who is reading (owner ruling (b)): an admin (`project.administer`) sees config and\n * deployment findings; a located finding shows to whoever can open its location. While the\n * role is still loading nobody is an admin and no view is visible, so a gated finding\n * appears once the role is known, never to the wrong reader first.\n */\nexport function useFindingAudience(project: Project): FindingAudience {\n  const nav = useStudioNav(project)\n  const role = useProjectRole(project.id)\n  return useMemo(() => {\n    const policy = projectRolePolicyFor(project.id)\n    const ctx = { project, role }\n    return {\n      isAdmin: role !== null && roleGrantsCapability(role, 'project.administer', policy),\n      canReadContent: role !== null && roleGrantsCapability(role, 'content.read', policy),\n      views: nav.registry.views.map((view) => ({\n        id: view.id,\n        ...(view.recordKind !== undefined ? { recordKind: view.recordKind } : {}),\n        visible: role !== null && isNavViewVisible(view, ctx),\n      })),\n    }\n  }, [nav, role, project])\n}\n\n/**\n * EC-616 → EC-690: runs every view's always-on findings hook (`useIssues`) — whether or not\n * the view is open — and publishes what it returns. One component per view (each hook keeps\n * its own hook order), each its OWN publisher with the source `view:<id>`: before EC-690 every\n * probe published under the one source `view:`, so two such views overwrote each other and\n * one unmount retracted both (critic point 1).\n */\nexport function ViewIssuesProbes({ project }: { project: Project }) {\n  const nav = useStudioNav(project)\n  const issueViews = useMemo(() => nav.registry.views.filter((view) => view.useIssues), [nav])\n  return (\n    <>\n      {issueViews.map((view) => (\n        <ViewIssuesProbe key={view.id} view={view} project={project} />\n      ))}\n    </>\n  )\n}\n\nfunction ViewIssuesProbe({ view, project }: { view: AppViewModule; project: Project }) {\n  const issues = view.useIssues!({ project, projectId: project.id })\n  useNavIssues(viewIssuesSource(view.id), issues)\n  return null\n}\n\n/** The source a view's always-on findings publish under. */\nexport function viewIssuesSource(viewId: string): string {\n  return `view:${viewId}`\n}\n\n/**\n * EC-479 — what the project has not declared but the studio cannot work without. Read from\n * the config holder alone (static per studio boot), so it needs no CMS provider and is\n * memoised once. The pure decision core is `projectConfigIssues`.\n */\nfunction useProjectConfigIssues(): CustomizationIssue[] {\n  return useMemo(() => projectConfigIssues(resolveDeploymentCollections()), [])\n}\n\n/**\n * EC-467 / EC-728 — the project's reusable-elements config issues: a declaration that cannot\n * resolve (an undeclared project has none — the embed is declared, never inferred). Static per\n * studio boot (registry + config collections + studio config). The pure core is `resolveReuse`.\n */\nfunction useReuseIssues(): CustomizationIssue[] {\n  return useMemo(\n    () =>\n      resolveReuse(getStudioRegistry().registry.list(), resolveDeploymentCollections(), resolveDeploymentReuse())\n        .issues,\n    [],\n  )\n}\n\n/**\n * EC-469 — the project's URL-map issues: two routes that match the same URLs, a redirect\n * chain that loops, a duplicate or unreadable redirect. Routes are CODE (config, static per\n * boot); redirects are editorial DATA (the rail, live) — the read shares the rail's own query\n * key, so a finding disappears the moment it is fixed; while that query is loading or failed\n * only the code-side conflicts are reported (the rail surfaces its own load error).\n */\nfunction useRouteIssues(projectId: string): NavIssueItem[] {\n  const redirects = useRecordList(redirectRecordKind, projectId).data\n  return useMemo(\n    () =>\n      routeIssueItems(\n        routeValidationIssues(\n          { routes: resolveDeploymentRoutes(), collections: resolveDeploymentCollections() },\n          redirects ?? [],\n        ),\n      ),\n    [redirects],\n  )\n}\n\n/**\n * EC-606 — stored documents whose collection the project does not declare. Read from the\n * content session (subscribable, configured from the same hydration in both modes); the\n * server snapshot is empty — there is no session during SSR. The pure mapping is\n * {@link orphanedCollectionItems}.\n */\nfunction useOrphanedCollectionIssues(): NavIssueItem[] {\n  const orphans = useSyncExternalStore(subscribeContentSession, contentSessionOrphans, serverContentSessionOrphans)\n  return useMemo(() => orphanedCollectionItems(orphans), [orphans])\n}\n"]}

package/dist/customization.d.ts

@@ -49,9 +49,9 @@ export type { StudioConfig, StudioCanvasTheme, StudioPreviewsConfig, CustomField
  */
 export type { GeneratedPreviewLookup } from './components/builder/blocks-model.js';
 /**
- * Reusable elements (EC-467): the OPTIONAL one-line declaration of which component
- * is the project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.
- * Absence means INFER (the zero-config default), not off. Reusable elements are
+ * Reusable elements (EC-467): the one-line declaration of which component is the
+ * project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.
+ * Absence means OFF (EC-728: declared, never inferred). Reusable elements are
  * singular per project: one embed component, one reusable collection.
  */
 export type { StudioReuseConfig } from './components/builder/reuse.js';

package/dist/customization.js.map

@@ -1 +1 @@
-{"version":3,"file":"customization.js","sourceRoot":"","sources":["../src/customization.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAuBnE;;;;;;GAMG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAK1E,OAAO,EAAE,GAAG,EAAE,MAAM,wCAAwC,CAAA;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,oFAAoF;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA","sourcesContent":["/**\n * `@elytracms/studio/customization` — the public customization API for a consuming\n * repo's `studio.config.tsx` (EC-236/237/238/239).\n *\n * Everything a repo customizes about the builder UI is **live studio code passed by\n * reference** through `defineStudio({...})` — the section rail (`nav.*`), custom\n * field renderers, and (in time) branding. This config is studio-only: it is handed\n * to `createStudio(config, studioConfig)` at the mount and never enters the shared\n * `elytra.config.ts` / the `frontend/` delivery bundle. The customization principle\n * in one import surface: direct values, no registries, no string ids — the lone\n * string seam is `fieldRenderers`' control key, which the delivery-shared schema\n * references via `form.control`.\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n *\n * // router.tsx (the mount)\n * import { createStudio } from '@elytracms/studio/customization'\n * import config from '../../elytra.config'\n * import studioConfig from './studio.config'\n * createStudio(config, studioConfig)\n * ```\n */\nexport { defineStudio } from './components/app-views/studio-config'\nexport type {\n  StudioConfig,\n  StudioCanvasTheme,\n  StudioPreviewsConfig,\n  CustomFieldRenderer,\n  CustomFieldRendererProps,\n} from './components/app-views/studio-config'\n/**\n * The generated-preview seam (EC-439, filled by EC-440's `elytra previews`):\n * `defineStudio({ previews: { generated } })` supplies a pure\n * `componentId + fixtureName → URL` lookup for build-time fixture preview\n * images. Curated `manifest.previewImage` wins over it; without either, tiles\n * render an icon+name placeholder.\n */\nexport type { GeneratedPreviewLookup } from './components/builder/blocks-model'\n/**\n * Reusable elements (EC-467): the OPTIONAL one-line declaration of which component\n * is the project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.\n * Absence means INFER (the zero-config default), not off. Reusable elements are\n * singular per project: one embed component, one reusable collection.\n */\nexport type { StudioReuseConfig } from './components/builder/reuse'\n/**\n * The EC-440 previews-manifest adapter: `elytra previews` writes\n * `studio/elytra-previews.json` + images under `public/elytra-previews/`; the\n * consumer wires the seam in two lines —\n * `import previewsManifest from './elytra-previews.json'` and\n * `previews: { generated: generatedPreviewsFromManifest(previewsManifest) }`.\n */\nexport { generatedPreviewsFromManifest } from './previews/manifest-format'\nexport type {\n  GeneratedPreviewsManifest,\n  GeneratedPreviewsManifestEntry,\n} from './previews/manifest-format'\nexport { nav } from './components/app-views/default-modules'\nexport type {\n  CmsViewConfig,\n  BuiltinViewConfig,\n  CustomViewConfig,\n} from './components/app-views/default-modules'\nexport type { AppViewContext, AppViewModule, SidebarNode } from './components/app-views/module'\nexport { createStudio } from './lib/workspace'\n/** A ready-made example renderer; a consuming repo may use it or author its own. */\nexport { colorFieldRenderer } from './components/cms/field-renderer'\n/**\n * Studio-UI localization (EC-241): author a translation catalog for `defineStudio({\n * i18n })`. `msg` is only needed to build an in-repo *source* catalog with translator\n * hints; a plain `MessageCatalog` (flat key → string) is all a consumer supplies.\n * Prefer `TranslationCatalog` (EC-398) when authoring: it is typed against the EN key\n * set, so unknown/stale keys fail typecheck — engine-shipped locales\n * (`@elytracms/studio/locales/de`) and spread-overrides of them use it.\n */\nexport { msg } from './lib/i18n'\nexport type {\n  MessageCatalog,\n  MessageKey,\n  SourceMessage,\n  StudioI18nConfig,\n  TranslationCatalog,\n} from './lib/i18n'\n"]}
+{"version":3,"file":"customization.js","sourceRoot":"","sources":["../src/customization.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAuBnE;;;;;;GAMG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAK1E,OAAO,EAAE,GAAG,EAAE,MAAM,wCAAwC,CAAA;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,oFAAoF;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA","sourcesContent":["/**\n * `@elytracms/studio/customization` — the public customization API for a consuming\n * repo's `studio.config.tsx` (EC-236/237/238/239).\n *\n * Everything a repo customizes about the builder UI is **live studio code passed by\n * reference** through `defineStudio({...})` — the section rail (`nav.*`), custom\n * field renderers, and (in time) branding. This config is studio-only: it is handed\n * to `createStudio(config, studioConfig)` at the mount and never enters the shared\n * `elytra.config.ts` / the `frontend/` delivery bundle. The customization principle\n * in one import surface: direct values, no registries, no string ids — the lone\n * string seam is `fieldRenderers`' control key, which the delivery-shared schema\n * references via `form.control`.\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n *\n * // router.tsx (the mount)\n * import { createStudio } from '@elytracms/studio/customization'\n * import config from '../../elytra.config'\n * import studioConfig from './studio.config'\n * createStudio(config, studioConfig)\n * ```\n */\nexport { defineStudio } from './components/app-views/studio-config'\nexport type {\n  StudioConfig,\n  StudioCanvasTheme,\n  StudioPreviewsConfig,\n  CustomFieldRenderer,\n  CustomFieldRendererProps,\n} from './components/app-views/studio-config'\n/**\n * The generated-preview seam (EC-439, filled by EC-440's `elytra previews`):\n * `defineStudio({ previews: { generated } })` supplies a pure\n * `componentId + fixtureName → URL` lookup for build-time fixture preview\n * images. Curated `manifest.previewImage` wins over it; without either, tiles\n * render an icon+name placeholder.\n */\nexport type { GeneratedPreviewLookup } from './components/builder/blocks-model'\n/**\n * Reusable elements (EC-467): the one-line declaration of which component is the\n * project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.\n * Absence means OFF (EC-728: declared, never inferred). Reusable elements are\n * singular per project: one embed component, one reusable collection.\n */\nexport type { StudioReuseConfig } from './components/builder/reuse'\n/**\n * The EC-440 previews-manifest adapter: `elytra previews` writes\n * `studio/elytra-previews.json` + images under `public/elytra-previews/`; the\n * consumer wires the seam in two lines —\n * `import previewsManifest from './elytra-previews.json'` and\n * `previews: { generated: generatedPreviewsFromManifest(previewsManifest) }`.\n */\nexport { generatedPreviewsFromManifest } from './previews/manifest-format'\nexport type {\n  GeneratedPreviewsManifest,\n  GeneratedPreviewsManifestEntry,\n} from './previews/manifest-format'\nexport { nav } from './components/app-views/default-modules'\nexport type {\n  CmsViewConfig,\n  BuiltinViewConfig,\n  CustomViewConfig,\n} from './components/app-views/default-modules'\nexport type { AppViewContext, AppViewModule, SidebarNode } from './components/app-views/module'\nexport { createStudio } from './lib/workspace'\n/** A ready-made example renderer; a consuming repo may use it or author its own. */\nexport { colorFieldRenderer } from './components/cms/field-renderer'\n/**\n * Studio-UI localization (EC-241): author a translation catalog for `defineStudio({\n * i18n })`. `msg` is only needed to build an in-repo *source* catalog with translator\n * hints; a plain `MessageCatalog` (flat key → string) is all a consumer supplies.\n * Prefer `TranslationCatalog` (EC-398) when authoring: it is typed against the EN key\n * set, so unknown/stale keys fail typecheck — engine-shipped locales\n * (`@elytracms/studio/locales/de`) and spread-overrides of them use it.\n */\nexport { msg } from './lib/i18n'\nexport type {\n  MessageCatalog,\n  MessageKey,\n  SourceMessage,\n  StudioI18nConfig,\n  TranslationCatalog,\n} from './lib/i18n'\n"]}

package/dist/lib/ai/apply-content.js

@@ -22,7 +22,17 @@
  *    stays enforced by the injected `validateRichTextEmbeds`;
  *  - a composition's STRUCTURE is never written (ratified 4c): a `blocks` field is not
  *    in the target shape at all (the catalog says why);
- *  - `ai.exclude` fields are untouchable (removed from the shape and never written).
+ *  - writer-locked positions are untouchable (EC-716, owner ruling "Yes, honour
+ *    readOnly"): `ai.exclude` and `form.readOnly`, at every depth — removed from the shape,
+ *    and a value the model writes there anyway is DROPPED (the position keeps its initial
+ *    value) and reported as a warning, like an id outside the leash;
+ *  - a create starts from the INITIAL values a manual create gets (EC-716): core's
+ *    `seedDefaults` — values and localized — so a field's default, a read-only one
+ *    included, is on the AI's draft as it is on the editor's;
+ *  - the slug role is DERIVED from the title with core's `autoDeriveSlug` (EC-715), as the
+ *    slug control and translate derive it — never authored by the model;
+ *  - what the draft leaves EMPTY is said (EC-715): every writable position without a value
+ *    and every dropped id is on the result (`unfilled`), for the proposal and the model.
  *
  * Every value crosses from its writer form to its stored form through the ONE
  * converter (`writer-form.ts`, EC-593) — the fold edit, translate and the read form
@@ -31,10 +41,10 @@
  * The engine depends only on the injected `AiProvider`, so the FakeProvider runs the
  * whole loop without a key. No data access, no service credentials here.
  */
-import { cmsIssue, isFieldLocalized, resolveLabel, validateDocument, writeField, } from '@elytracms/core/cms-core';
+import { autoDeriveSlug, cmsIssue, isFieldLocalized, isWriterLocked, resolveLabel, seedDefaults, seedObjectItem, validateDocument, valuesInLocale, writeField, } from '@elytracms/core/cms-core';
 import { assembleKnowledgeBlock } from './knowledge.js';
 import { aiProvenance } from './provenance.js';
-import { buildTargetShape } from './shape.js';
+import { buildTargetShape, derivedSlugField } from './shape.js';
 import { fromWriterFieldValue, heldReferencesOf } from './writer-form.js';
 /** Default repair attempts after the first generation. */
 export const DEFAULT_MAX_REPAIR_ATTEMPTS = 2;
@@ -56,15 +66,12 @@ function isPlainRecord(value) {
 function asRecord(value) {
     return isPlainRecord(value) ? value : {};
 }
-/** Compose the user-facing prompt: instruction + knowledge + existing values + prior issues. */
+/** Compose the user-facing prompt: instruction + knowledge + prior issues. */
 function buildPrompt(input, knowledge, priorIssues) {
     const parts = [`Instruction:\n${input.instruction}`];
     const knowledgeBlock = knowledge ? assembleKnowledgeBlock(knowledge) : '';
     if (knowledgeBlock)
         parts.push(knowledgeBlock);
-    if (input.existing && Object.keys(input.existing).length > 0) {
-        parts.push(`Existing values (reference — follow the instruction, fill gaps):\n${JSON.stringify(input.existing)}`);
-    }
     if (priorIssues.length > 0) {
         parts.push([
             'The previous attempt was invalid. Fix these problems and return a corrected object:',
@@ -73,6 +80,35 @@ function buildPrompt(input, knowledge, priorIssues) {
     }
     return parts.join('\n\n');
 }
+/**
+ * The values a NEW document starts with (EC-716) — THE seeding rule a manual create reads
+ * (`seedDefaults`, written in the project's default locale). Without a locale config there
+ * is no bucket a localized default could live in, so only the shared fields seed (the same
+ * per-field rule, `seedObjectItem`); a localized write then fails loudly below anyway.
+ */
+function initialValues(collection, localeConfig) {
+    if (localeConfig)
+        return seedDefaults(collection, localeConfig);
+    return { values: seedObjectItem(collection.fields.filter((field) => !isFieldLocalized(collection, field.name))) };
+}
+/** Whether a stored value is no value at all: absent, `null`, `''`, or an empty list. */
+function isEmptyValue(value) {
+    return value === undefined || value === null || value === '' || (Array.isArray(value) && value.length === 0);
+}
+/**
+ * The writable top-level positions a draft left without a value (EC-715), in field order —
+ * a writer-locked field is no writer's to fill and a composition is the canvas's, so neither
+ * counts — followed by every id the leash dropped (at any depth).
+ */
+function unfilledPositions(collection, shape, valueOf, dropped) {
+    const offered = (shape.schema.properties ?? {});
+    const empty = collection.fields.flatMap((field) => {
+        if (isWriterLocked(field) || field.type === 'blocks' || !isEmptyValue(valueOf(field.name)))
+            return [];
+        return [{ field: field.name, at: [], reason: offered[field.name] === undefined ? 'no-candidates' : 'empty' }];
+    });
+    return [...empty, ...dropped];
+}
 /**
  * Run the schema-driven authoring loop end to end. Returns a valid, leash-compliant
  * patch with provenance, or — after exhausting the repair budget — the blocking
@@ -86,7 +122,6 @@ export async function applyContentWithShape(input) {
         ...(input.leash ? { leash: input.leash } : {}),
         ...(locale !== undefined ? { locale } : {}),
     });
-    const excluded = new Set(shape.excluded);
     // EC-497: THE bag, whole — the generated draft is judged by the rules the editor
     // will judge it by, and no key can go missing by being forgotten at this call
     // site. EC-580 removed the ONE deviation this used to state: a synthetic
@@ -96,12 +131,25 @@ export async function applyContentWithShape(input) {
     // RULES D15). The project's config is the only default locale: a required
     // localized field needs its default-locale value, here exactly as at publish.
     const validateOptions = input.validateOptions ?? {};
+    // EC-580: every value is written through core's `writeField`, in the create's
+    // locale — or, when none is named, the project's DEFAULT locale (the only
+    // default there is). A localized field used to land on the shared `values` bag
+    // without a locale (the EC-390 plain shape, MODE F5b.bkt).
+    const writeLocale = locale ?? validateOptions.localeConfig?.default;
+    // EC-716: the draft starts from the initial values a manual create gets.
+    const initial = initialValues(collection, validateOptions.localeConfig);
+    /** The value a field's write replaces: its initial value in the bucket being written. */
+    const initialOf = (name) => isFieldLocalized(collection, name)
+        ? writeLocale === undefined
+            ? undefined
+            : initial.localized?.[writeLocale]?.[name]
+        : initial.values[name];
     // EC-593: the ONE converter's context — the validator's own prop lookup, the
-    // conversation's leash, and the ids the existing values already reference.
+    // conversation's leash, and the ids the initial values already reference.
     const ctx = {
         ...(validateOptions.lookupManifest ? { lookupManifest: validateOptions.lookupManifest } : {}),
         ...(input.leash ? { leash: input.leash } : {}),
-        held: heldReferencesOf({ collection: collection.id, id: documentId, values: input.existing ?? {} }),
+        held: heldReferencesOf({ collection: collection.id, id: documentId, ...initial }),
     };
     const totalAttempts = (input.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS) + 1;
     let priorIssues = [];
@@ -118,47 +166,52 @@ export async function applyContentWithShape(input) {
                 collection.id,
         });
         const object = asRecord(result.object);
-        // EC-580: every value is written through core's `writeField`, in the create's
-        // locale — or, when none is named, the project's DEFAULT locale (the only
-        // default there is). A localized field used to land on the shared `values` bag
-        // without a locale (the EC-390 plain shape, MODE F5b.bkt).
-        const writeLocale = locale ?? validateOptions.localeConfig?.default;
         let doc = {
             collection: collection.id,
             id: documentId,
-            values: { ...(input.existing ?? {}) },
+            values: { ...initial.values },
+            ...(initial.localized !== undefined ? { localized: { ...initial.localized } } : {}),
         };
         // EC-379: md→envelope conversion problems join the repair loop as explicit
         // issues (the model gets them back verbatim) — never a silently-dropped body.
         const conversionIssues = [];
-        // EC-381/EC-593: an id outside the leash is DROPPED (empty beats wrong) — and the
-        // drop is said, as a warning on the proposal the editor reviews.
-        const leashWarnings = [];
+        // EC-381/EC-593: an id outside the leash is DROPPED (empty beats wrong); EC-716: so is
+        // a write to a locked position (it keeps its initial value). Each drop is said, as a
+        // warning on the proposal the editor reviews.
+        const dropWarnings = [];
+        // EC-715: the leash drops again, as positions — the proposal lists them as unfilled.
+        const droppedIds = [];
         for (const field of collection.fields) {
-            if (excluded.has(field.name))
+            // EC-715: the slug role is the engine's to derive (below), never the model's.
+            if (shape.derived.includes(field.name))
                 continue;
             const raw = object[field.name];
             if (raw === undefined || raw === null)
                 continue;
             const fieldPath = ['documents', `${collection.id}:${documentId}`, 'values', field.name];
-            // EC-593: writer form → stored form at every depth, the leash and the carry
-            // (EC-570 #3: from the existing value, through the one rule) at every position.
-            const converted = fromWriterFieldValue(field, raw, input.existing?.[field.name], ctx, writeLocale);
+            const current = initialOf(field.name);
+            // EC-593: writer form → stored form at every depth, the leash, the carry (EC-570 #3:
+            // from the initial value, through the one rule) and — EC-716 — the writer lock, at
+            // every position, the field's own included.
+            const converted = fromWriterFieldValue(field, raw, current, ctx, writeLocale);
             for (const problem of converted.problems) {
+                const dropped = problem.leash === true || problem.locked === true;
                 const issue = cmsIssue({
                     code: problem.code,
                     message: problem.message,
                     path: [...fieldPath, ...problem.at],
                     collectionId: collection.id,
                     documentId,
-                    ...(problem.leash ? { severity: 'warning' } : {}),
+                    ...(dropped ? { severity: 'warning' } : {}),
                 });
-                if (problem.leash)
-                    leashWarnings.push(issue);
+                if (dropped)
+                    dropWarnings.push(issue);
                 else
                     conversionIssues.push(issue);
+                if (problem.leash)
+                    droppedIds.push({ field: field.name, at: problem.at, reason: 'dropped' });
             }
-            if (converted.value === undefined)
+            if (converted.value === undefined || converted.value === current)
                 continue;
             if (isFieldLocalized(collection, field.name) && writeLocale === undefined) {
                 // A wiring gap, made loud: no locale named AND no project locale config to
@@ -174,6 +227,23 @@ export async function applyContentWithShape(input) {
             }
             doc = writeField(collection, doc, field.name, writeLocale, converted.value);
         }
+        /** A field's value in the bucket this create writes. */
+        const valueOf = (name) => isFieldLocalized(collection, name)
+            ? writeLocale === undefined
+                ? undefined
+                : doc.localized?.[writeLocale]?.[name]
+            : doc.values[name];
+        // EC-715: the slug from its source in the written locale's displayed view — THE
+        // derivation (`autoDeriveSlug`) — unless the initial values already hold one.
+        const slugField = derivedSlugField(collection);
+        if (slugField && isEmptyValue(valueOf(slugField.name)) && !(isFieldLocalized(collection, slugField.name) && writeLocale === undefined)) {
+            const view = writeLocale !== undefined && validateOptions.localeConfig
+                ? valuesInLocale(collection, doc, writeLocale, validateOptions.localeConfig)
+                : { ...doc.values, ...(writeLocale !== undefined ? doc.localized?.[writeLocale] : {}) };
+            const slug = autoDeriveSlug(slugField.slug, collection, view);
+            if (slug !== '')
+                doc = writeField(collection, doc, slugField.name, writeLocale, slug);
+        }
         const issues = validateDocument(registry, doc, validateOptions);
         const errors = [...conversionIssues, ...issues.filter((i) => i.severity === 'error')];
         if (errors.length === 0) {
@@ -188,7 +258,8 @@ export async function applyContentWithShape(input) {
                 patch,
                 provenance,
                 attempts: attempt,
-                issues: [...leashWarnings, ...issues.filter((i) => i.severity !== 'error')],
+                issues: [...dropWarnings, ...issues.filter((i) => i.severity !== 'error')],
+                unfilled: unfilledPositions(collection, shape, valueOf, droppedIds),
             };
         }
         lastErrors = errors;