@elytracms/studio 0.0.42 → 0.0.44

package/dist/components/components/transfer-dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"transfer-dialog.js","sourceRoot":"","sources":["../../../src/components/components/transfer-dialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { FilePlus2 } from 'lucide-react'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router'\nimport {\n  Button,\n  Code,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Row,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { localizedLabel, translate } from '@elytracms/studio/lib/i18n'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { resolveDeploymentCollections } from '@elytracms/studio/lib/workspace'\nimport { getInstantiatedKit } from '@elytracms/studio/lib/starters/kit-session'\nimport { CmsSessionGate } from '../project-session'\nimport { CmsProvider, useCms } from '../cms/cms-store'\nimport { stageDocument } from '../cms/document-staging'\nimport { buildBlockDocument, collectionsWithBlocks } from './transfer'\nimport type { CollectionBlocksTarget } from './transfer'\nimport { embedNodeFrom } from './component-preview'\n\n/**\n * EC-320 — \"Use in document…\". Transfers the current component combination (the\n * live preview {@link ComponentNode}, edited props and all) into a NEW DRAFT\n * document whose blocks field holds it, then opens that document.\n *\n * The dialog mounts a CMS session (so it reuses the store's create/save machinery,\n * collision-free ids and persistence) only while open. On confirm it builds the\n * draft (pure {@link buildBlockDocument}), persists it via `saveDocument`, STAGES\n * it for the next CMS mount (the playground handoff, see document-staging), and\n * navigates to the document — focused on its blocks field so it opens on the canvas.\n */\nexport function TransferToDocumentDialog({\n  projectId,\n  manifest,\n  node,\n  open,\n  onOpenChange,\n}: {\n  projectId: string\n  manifest: ComponentManifest\n  node: ComponentNode\n  open: boolean\n  onOpenChange: (open: boolean) => void\n}) {\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent className=\"max-w-md\">\n        <DialogHeader>\n          <DialogTitle>\n            {translate('components.transfer.title', { name: manifest.title ?? manifest.id })}\n          </DialogTitle>\n          <DialogDescription>{translate('components.transfer.description')}</DialogDescription>\n        </DialogHeader>\n        {open ? (\n          <CmsSessionGate>\n            {(cms) => {\n              const kit = getInstantiatedKit(projectId)\n              const collections =\n                cms?.collections ??\n                kit?.collections ??\n                (isPlaygroundMode() ? resolveDeploymentCollections() : [])\n              return (\n                <CmsProvider\n                  projectId={projectId}\n                  initialCollections={collections}\n                  initialDocuments={cms?.documents ?? kit?.documents}\n                  initialPublishedKeys={cms?.publishedKeys}\n                >\n                  <TransferPicker\n                    projectId={projectId}\n                    node={node}\n                    collections={collections}\n                    onClose={() => onOpenChange(false)}\n                  />\n                </CmsProvider>\n              )\n            }}\n          </CmsSessionGate>\n        ) : null}\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nfunction TransferPicker({\n  projectId,\n  node,\n  collections,\n  onClose,\n}: {\n  projectId: string\n  node: ComponentNode\n  collections: readonly CollectionDef[]\n  onClose: () => void\n}) {\n  const cms = useCms()\n  const navigate = useNavigate()\n  const targets = useMemo(() => collectionsWithBlocks(collections), [collections])\n\n  function transfer(target: CollectionBlocksTarget) {\n    const existingIds = new Set(cms.documentsOf(target.collection.id).map((d) => d.id))\n    const doc = buildBlockDocument({\n      collection: target.collection,\n      blocksField: target.field,\n      node: embedNodeFrom(node, 'node-1'),\n      existingIds,\n      seq: { current: 0 },\n    })\n    // Persist through the store (upsert + reference index) and stage for the next\n    // CMS mount (playground handoff), then open the document on its canvas.\n    cms.saveDocument(doc)\n    stageDocument(projectId, doc)\n    onClose()\n    void navigate({\n      to: STUDIO_PROJECT_ROUTE,\n      params: { projectId, _splat: studioPath.cmsDocument(target.collection.id, doc.id) },\n      search: { field: `values/${target.field.name}` },\n    })\n  }\n\n  if (targets.length === 0) {\n    return (\n      <Text size=\"sm\" tone=\"muted\" data-testid=\"transfer-no-targets\">\n        {translate('components.transfer.noTargets')}\n      </Text>\n    )\n  }\n\n  return (\n    <>\n      <Stack gap=\"2\" className=\"max-h-[50vh] overflow-y-auto\">\n        {targets.map((target) => (\n          <button\n            key={target.collection.id}\n            type=\"button\"\n            data-testid=\"transfer-target\"\n            onClick={() => transfer(target)}\n            className=\"flex items-center gap-3 rounded-md border border-border p-3 text-left transition-colors hover:border-primary/40 hover:bg-muted\"\n          >\n            <span className=\"grid size-8 shrink-0 place-items-center rounded-md bg-muted text-muted-foreground\">\n              <FilePlus2 className=\"size-4\" />\n            </span>\n            <Stack gap=\"px\" className=\"min-w-0 flex-1\">\n              <Text size=\"sm\" weight=\"medium\" className=\"truncate\">\n                {localizedLabel(target.collection.form?.label, target.collection.id)}\n              </Text>\n              <Row gap=\"1\" align=\"center\">\n                <Text size=\"xs\" tone=\"muted\">\n                  {translate('components.transfer.intoField')}\n                </Text>\n                <Code tone=\"muted\">{target.field.name}</Code>\n              </Row>\n            </Stack>\n          </button>\n        ))}\n      </Stack>\n      <DialogFooter>\n        <Button type=\"button\" variant=\"ghost\" onClick={onClose}>\n          {translate('common.cancel')}\n        </Button>\n      </DialogFooter>\n    </>\n  )\n}\n"]}
+{"version":3,"file":"transfer-dialog.js","sourceRoot":"","sources":["../../../src/components/components/transfer-dialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useState } from 'react'\nimport { FilePlus2, FileText, Loader2, Search } from 'lucide-react'\nimport type { ReactNode } from 'react'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router'\nimport {\n  Button,\n  Code,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Input,\n  Row,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { cn } from '@elytracms/studio/lib/utils'\nimport { localizedLabel, translate } from '@elytracms/studio/lib/i18n'\nimport { getInstantiatedKit } from '@elytracms/studio/lib/starters/kit-session'\nimport { CmsSessionGate } from '../project-session'\nimport { CmsProvider, useCms } from '../cms/cms-store'\nimport { stageDocument } from '../cms/document-staging'\nimport { resolveCmsInitialCollections } from '../app-views/default-modules'\nimport {\n  appendToBlockDocument,\n  buildBlockDocument,\n  canAppendTo,\n  collectionsWithBlocks,\n  isComponentAllowed,\n} from './transfer'\nimport type { CollectionBlocksTarget } from './transfer'\n\n/** Existing documents offered per target, beyond which the rest are hidden (filter to find them). */\nconst MAX_EXISTING_TARGETS = 8\n\n/**\n * EC-320 (+ 0.0.44 follow-up) — \"Use in document…\". Transfers the current\n * component combination (the live preview {@link ComponentNode}, edited props\n * and all) into a document's blocks field, then opens that document. Each\n * eligible collection+field target offers a NEW draft AND its existing\n * documents to append into.\n *\n * The dialog mounts a CMS session (so it reuses the store's create/save machinery,\n * collision-free ids and persistence) only while open. On confirm it builds the\n * draft or the append (pure {@link buildBlockDocument} / {@link appendToBlockDocument}),\n * saves it and AWAITS the persisted write landing (belt and braces alongside the\n * STAGE for the next CMS mount, see `document-staging` — both matter: staging\n * covers the very next mount regardless of mode, the await guards any later\n * reload), then navigates to the document — focused on its blocks field so it\n * opens on the canvas.\n */\nexport function TransferToDocumentDialog({\n  projectId,\n  manifest,\n  node,\n  open,\n  onOpenChange,\n}: {\n  projectId: string\n  manifest: ComponentManifest\n  node: ComponentNode\n  open: boolean\n  onOpenChange: (open: boolean) => void\n}) {\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent className=\"max-w-md\">\n        <DialogHeader>\n          <DialogTitle>\n            {translate('components.transfer.title', { name: manifest.title ?? manifest.id })}\n          </DialogTitle>\n          <DialogDescription>{translate('components.transfer.description')}</DialogDescription>\n        </DialogHeader>\n        {open ? (\n          <CmsSessionGate>\n            {(cms) => {\n              const kit = getInstantiatedKit(projectId)\n              // Bug fix: this used to reimplement `resolveCmsInitialCollections`'s\n              // fallback chain inline with a final `[]` instead of `undefined` — `[]`\n              // is \"present\" to `CmsProvider`'s `initialCollections ??\n              // sampleFilterableCollections`, so it suppressed the fixture fallback a\n              // fresh Convex-mode project (`cms === null`, no kit) needs. Delegating to\n              // the shared, tested resolver (also used by the CMS/Assets tabs) keeps\n              // this dialog's targets in sync with what those tabs show.\n              const collections = resolveCmsInitialCollections(cms, kit)\n              return (\n                <CmsProvider\n                  projectId={projectId}\n                  initialCollections={collections}\n                  initialDocuments={cms?.documents ?? kit?.documents}\n                  initialPublishedKeys={cms?.publishedKeys}\n                >\n                  <TransferPicker projectId={projectId} node={node} onClose={() => onOpenChange(false)} />\n                </CmsProvider>\n              )\n            }}\n          </CmsSessionGate>\n        ) : null}\n      </DialogContent>\n    </Dialog>\n  )\n}\n\n/** A pending transfer's in-flight target key: `<collectionId>/new` or `<collectionId>/<docId>`. */\nfunction newTargetKey(target: CollectionBlocksTarget): string {\n  return `${target.collection.id}/new`\n}\nfunction existingTargetKey(target: CollectionBlocksTarget, doc: CmsDocument): string {\n  return `${target.collection.id}/${doc.id}`\n}\n\n/**\n * Exported for the fresh-Convex-project regression test (bug fix,\n * transfer-dialog.test.tsx) — `TransferToDocumentDialog` is otherwise its only\n * caller.\n */\nexport function TransferPicker({\n  projectId,\n  node,\n  onClose,\n}: {\n  projectId: string\n  node: ComponentNode\n  onClose: () => void\n}) {\n  const cms = useCms()\n  const navigate = useNavigate()\n  const [query, setQuery] = useState('')\n  // The in-flight target's key while its save is awaited (disables every row\n  // + shows a spinner on the clicked one) — `null` when idle.\n  const [pendingKey, setPendingKey] = useState<string | null>(null)\n\n  // Read the LIVE store schema (`cms.collections`) rather than re-deriving it\n  // from the same `resolveCmsInitialCollections` result passed to `CmsProvider`\n  // above — `cms.collections` is what the provider actually resolved to\n  // (its OWN `initialCollections ?? sampleFilterableCollections` fallback,\n  // EC-320), so the targets list can never drift from — or reintroduce the\n  // `[]`-suppresses-the-fixture-fallback bug against — what the CMS/Assets\n  // tabs show for this same session. Allow-gated (0.0.44 follow-up): a target\n  // whose field's `allow` vocabulary rejects this component is never offered,\n  // new-document or existing-document alike — the validator would flag it.\n  const targets = useMemo(\n    () => collectionsWithBlocks(cms.collections).filter((t) => isComponentAllowed(t.field, node.componentId)),\n    [cms.collections, node.componentId],\n  )\n\n  /** Persist (awaited) + stage + navigate — shared by both transfer paths. */\n  async function persistAndOpen(doc: CmsDocument, target: CollectionBlocksTarget) {\n    // Optimistic session apply + queues the persisted upsert (EC-141's normal\n    // fire-and-forget autosave path — unchanged for every OTHER caller).\n    cms.saveDocument(doc)\n    // Cross-mount handoff for the very next `CmsProvider` mount, in EVERY mode\n    // (see document-staging.ts) — covers the instant after this write, before\n    // any later hydration is guaranteed to observe it.\n    stageDocument(projectId, doc)\n    // Belt and braces: AWAIT the queued persistence command landing (the same\n    // `flushPersistence` publish/unpublish already await) so a reload of the\n    // destination editor — not just its very next mount — also finds the\n    // document. `saveDocument` itself stays fire-and-forget for every other\n    // caller; only this explicit await makes the transfer's save synchronous.\n    await cms.flushPersistence()\n    onClose()\n    void navigate({\n      to: STUDIO_PROJECT_ROUTE,\n      params: { projectId, _splat: studioPath.cmsDocument(target.collection.id, doc.id) },\n      search: { field: `values/${target.field.name}` },\n    })\n  }\n\n  async function transferNew(target: CollectionBlocksTarget) {\n    const key = newTargetKey(target)\n    setPendingKey(key)\n    try {\n      const existingIds = new Set(cms.documentsOf(target.collection.id).map((d) => d.id))\n      const doc = buildBlockDocument({\n        collection: target.collection,\n        blocksField: target.field,\n        node,\n        existingIds,\n        seq: { current: 0 },\n      })\n      await persistAndOpen(doc, target)\n    } finally {\n      setPendingKey(null)\n    }\n  }\n\n  async function transferInto(target: CollectionBlocksTarget, existing: CmsDocument) {\n    const key = existingTargetKey(target, existing)\n    setPendingKey(key)\n    try {\n      const doc = appendToBlockDocument({\n        collection: target.collection,\n        document: existing,\n        blocksField: target.field,\n        node,\n        locale: cms.activeLocale,\n      })\n      await persistAndOpen(doc, target)\n    } finally {\n      setPendingKey(null)\n    }\n  }\n\n  if (targets.length === 0) {\n    return (\n      <Text size=\"sm\" tone=\"muted\" data-testid=\"transfer-no-targets\">\n        {translate('components.transfer.noTargets')}\n      </Text>\n    )\n  }\n\n  const trimmedQuery = query.trim().toLowerCase()\n  const hasAnyExistingDocs = targets.some((t) => cms.documentsOf(t.collection.id).length > 0)\n\n  return (\n    <>\n      {hasAnyExistingDocs ? (\n        <div className=\"relative\">\n          <Search className=\"pointer-events-none absolute left-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground\" />\n          <Input\n            value={query}\n            onChange={(e) => setQuery(e.target.value)}\n            placeholder={translate('common.searchPlaceholder')}\n            className=\"pl-8\"\n          />\n        </div>\n      ) : null}\n      <Stack gap=\"4\" className=\"max-h-[50vh] overflow-y-auto\">\n        {targets.map((target) => {\n          const existing = cms\n            .documentsOf(target.collection.id)\n            .filter((doc) => canAppendTo({ collection: target.collection, document: doc, blocksField: target.field, locale: cms.activeLocale }))\n            .filter(\n              (doc) =>\n                trimmedQuery === '' ||\n                cms.titleOf({ collection: target.collection.id, id: doc.id }).toLowerCase().includes(trimmedQuery),\n            )\n            .slice(0, MAX_EXISTING_TARGETS)\n\n          return (\n            <Stack key={target.collection.id} gap=\"2\">\n              <Stack gap=\"px\">\n                <Text size=\"sm\" weight=\"medium\" className=\"truncate\">\n                  {localizedLabel(target.collection.form?.label, target.collection.id)}\n                </Text>\n                <Row gap=\"1\" align=\"center\">\n                  <Text size=\"xs\" tone=\"muted\">\n                    {translate('components.transfer.intoField')}\n                  </Text>\n                  <Code tone=\"muted\">{target.field.name}</Code>\n                </Row>\n              </Stack>\n              <Stack gap=\"1\">\n                <TransferTargetRow\n                  testId=\"transfer-target\"\n                  icon={<FilePlus2 className=\"size-4\" />}\n                  label={translate('components.transfer.newDocument', {\n                    collection: localizedLabel(target.collection.form?.labelSingular, target.collection.id),\n                  })}\n                  pending={pendingKey === newTargetKey(target)}\n                  disabled={pendingKey !== null}\n                  onClick={() => void transferNew(target)}\n                />\n                {existing.length > 0 ? (\n                  <Text size=\"xs\" tone=\"muted\" className=\"px-1 pt-1\">\n                    {translate('components.transfer.orExisting')}\n                  </Text>\n                ) : null}\n                {existing.map((doc) => (\n                  <TransferTargetRow\n                    key={doc.id}\n                    testId=\"transfer-target-existing\"\n                    icon={<FileText className=\"size-4\" />}\n                    label={cms.titleOf({ collection: target.collection.id, id: doc.id })}\n                    pending={pendingKey === existingTargetKey(target, doc)}\n                    disabled={pendingKey !== null}\n                    onClick={() => void transferInto(target, doc)}\n                  />\n                ))}\n              </Stack>\n            </Stack>\n          )\n        })}\n      </Stack>\n      <DialogFooter>\n        <Button type=\"button\" variant=\"ghost\" onClick={onClose} disabled={pendingKey !== null}>\n          {translate('common.cancel')}\n        </Button>\n      </DialogFooter>\n    </>\n  )\n}\n\n/** One selectable transfer target row — a new draft, or an existing document to append into. */\nfunction TransferTargetRow({\n  testId,\n  icon,\n  label,\n  pending,\n  disabled,\n  onClick,\n}: {\n  testId: string\n  icon: ReactNode\n  label: string\n  pending: boolean\n  disabled: boolean\n  onClick: () => void\n}) {\n  return (\n    <button\n      type=\"button\"\n      data-testid={testId}\n      disabled={disabled}\n      onClick={onClick}\n      className={cn(\n        'flex items-center gap-3 rounded-md border border-border p-3 text-left transition-colors hover:border-primary/40 hover:bg-muted',\n        disabled && 'cursor-not-allowed opacity-60',\n      )}\n    >\n      <span className=\"grid size-8 shrink-0 place-items-center rounded-md bg-muted text-muted-foreground\">\n        {pending ? <Loader2 className=\"size-4 animate-spin\" /> : icon}\n      </span>\n      <Text size=\"sm\" weight=\"medium\" className=\"min-w-0 flex-1 truncate\">\n        {label}\n      </Text>\n    </button>\n  )\n}\n"]}

package/dist/components/components/transfer.d.ts

@@ -1,28 +1,44 @@
-import type { CmsDocument, CollectionDef, FieldDef } from '@elytracms/core/cms-core';
+import type { BlocksFieldDef, CmsDocument, CollectionDef, Locale } from '@elytracms/core/cms-core';
 import type { ComponentNode } from '@elytracms/core/project-graph';
 /**
- * EC-320 — the "design guide → real content" bridge. A component combination the
- * user has arranged in the Components view (a manifest + edited prop values,
- * captured as a {@link ComponentNode}) is transferred into a NEW DRAFT document
- * whose blocks/composition field holds that node. Pure so the id-minting and
- * embedding are unit-testable; the React dialog owns the picker, persistence, and
+ * EC-320 (+ 0.0.44 follow-up) — the "design guide → real content" bridge. A
+ * component combination the user has arranged in the Components view (a
+ * manifest + edited prop values, captured as a {@link ComponentNode}) is
+ * transferred into a document's blocks/composition field — either a NEW DRAFT
+ * document created for it ({@link buildBlockDocument}) or an EXISTING
+ * document's field, appended alongside whatever it already holds
+ * ({@link appendToBlockDocument}). Pure so id-minting/embedding/appending are
+ * unit-testable; the React dialog owns the picker, persistence, and
  * navigation.
  */
 export interface CollectionBlocksTarget {
     collection: CollectionDef;
     /** The (first) blocks field the node lands in. */
-    field: FieldDef;
+    field: BlocksFieldDef;
 }
 /**
  * Collections that can receive a transferred combination — those declaring a
  * `blocks` (composition) field. The first blocks field wins (a collection with a
  * single canvas is the norm; a second is an unusual edge we don't disambiguate).
+ * Callers additionally gate each target through {@link isComponentAllowed} —
+ * this only reports which collections HAVE a blocks field, not which ones
+ * accept a given component.
  */
 export declare function collectionsWithBlocks(collections: readonly CollectionDef[]): CollectionBlocksTarget[];
+/**
+ * Is `componentId` permitted as a top-level block of `field`? Mirrors
+ * `validateCompositionValue`'s (`@elytracms/core/project-graph`) top-level
+ * `allow` rule EXACTLY: an absent or empty list permits any registered
+ * component; a non-empty list is the closed vocabulary. A target this
+ * predicate accepts can never fail that validator's `forbidden-component`
+ * check on save — the transfer dialog uses this to hide targets the
+ * component isn't allowed into (new AND existing document targets alike).
+ */
+export declare function isComponentAllowed(field: BlocksFieldDef, componentId: string): boolean;
 export interface BuildBlockDocumentInput {
     collection: CollectionDef;
     /** The blocks field the node lands in (from {@link collectionsWithBlocks}). */
-    blocksField: FieldDef;
+    blocksField: BlocksFieldDef;
     /** The component node — a manifest id + the edited static props (+ slots). */
     node: ComponentNode;
     /** Every doc id already in the target collection (collision guard, EC-316). */
@@ -41,3 +57,53 @@ export interface BuildBlockDocumentInput {
  * composition editor persists and `blockRootsOf` reads it back.
  */
 export declare function buildBlockDocument({ collection, blocksField, node, existingIds, seq, }: BuildBlockDocumentInput): CmsDocument;
+export interface CanAppendToInput {
+    collection: CollectionDef;
+    document: CmsDocument;
+    blocksField: BlocksFieldDef;
+    /** The locale being edited (EC-176 ambient active locale) for a localized field. */
+    locale: Locale;
+}
+/**
+ * Can `node` be appended to `document`'s blocks field without destroying
+ * existing content? Always true for a `multiple` field (an ordered list has
+ * room for one more); a single-root (`multiple: false`) field only while it
+ * is empty — occupied, there is no second root to hold it without
+ * overwriting the existing block, so the transfer dialog excludes that
+ * document from its offered targets rather than risk data loss.
+ */
+export declare function canAppendTo({ collection, document, blocksField, locale }: CanAppendToInput): boolean;
+export interface AppendToBlockDocumentInput {
+    collection: CollectionDef;
+    /** The document to append into (the transfer dialog's "insert into existing document"). */
+    document: CmsDocument;
+    blocksField: BlocksFieldDef;
+    /** The component node to append — not yet re-ided (fresh id minted here). */
+    node: ComponentNode;
+    /** The locale being edited (EC-176 ambient active locale) for a localized field. */
+    locale: Locale;
+}
+/**
+ * Append `node` into an EXISTING document's blocks field (EC-320 follow-up,
+ * 0.0.44 — "insert into existing document"), leaving everything else about
+ * the document untouched: other fields, other locale bundles, and the
+ * field's own existing content, which the embed always lands AFTER.
+ *
+ * Reads the current roots via `blockRootsOf` (`@elytracms/core/project-graph`
+ * — the same reader the composition editor, table cell, and reuse-context
+ * use), so this reads the field back exactly like every other consumer,
+ * undefined-safe for a never-set field. Locale-aware writes go through
+ * {@link applyCellValue} (the same locale-write helper inline cell edits use,
+ * `cell-edit.ts`) so a localized blocks field's OTHER locale bundles are
+ * never touched, only the edited locale's.
+ *
+ * Node-id collision guard: `node` is re-embedded under a fresh id minted past
+ * every existing root's ids ({@link embedFreshNode}), never a fixed `node-1`
+ * — a document whose blocks already hold that id would otherwise collide.
+ *
+ * Throws if `blocksField` is a single-root (`multiple: false`) field that
+ * already holds a root — a defensive invariant guard, not a user-facing
+ * validation path: the caller must pre-filter candidates with
+ * {@link canAppendTo} so this is never reached in that state.
+ */
+export declare function appendToBlockDocument({ collection, document, blocksField, node, locale, }: AppendToBlockDocumentInput): CmsDocument;

package/dist/components/components/transfer.js

@@ -1,9 +1,16 @@
-import { isBlocksField, seedDefaults } from '@elytracms/core/cms-core';
+import { isBlocksField, isFieldLocalized, seedDefaults } from '@elytracms/core/cms-core';
+import { blockRootsOf, maxNodeIdSeq } from '@elytracms/core/project-graph';
+import { makeNodeIdCounter } from '../builder/builder-store';
+import { applyCellValue } from '../cms/cell-edit';
 import { mintDocumentId } from '../cms/cms-store';
+import { embedNodeFrom } from './component-preview';
 /**
  * Collections that can receive a transferred combination — those declaring a
  * `blocks` (composition) field. The first blocks field wins (a collection with a
  * single canvas is the norm; a second is an unusual edge we don't disambiguate).
+ * Callers additionally gate each target through {@link isComponentAllowed} —
+ * this only reports which collections HAVE a blocks field, not which ones
+ * accept a given component.
  */
 export function collectionsWithBlocks(collections) {
     const targets = [];
@@ -14,6 +21,32 @@ export function collectionsWithBlocks(collections) {
     }
     return targets;
 }
+/**
+ * Is `componentId` permitted as a top-level block of `field`? Mirrors
+ * `validateCompositionValue`'s (`@elytracms/core/project-graph`) top-level
+ * `allow` rule EXACTLY: an absent or empty list permits any registered
+ * component; a non-empty list is the closed vocabulary. A target this
+ * predicate accepts can never fail that validator's `forbidden-component`
+ * check on save — the transfer dialog uses this to hide targets the
+ * component isn't allowed into (new AND existing document targets alike).
+ */
+export function isComponentAllowed(field, componentId) {
+    return !field.allow || field.allow.length === 0 || field.allow.includes(componentId);
+}
+/**
+ * Mint a fresh `node-<n>` id for `node`, guaranteed not to collide with any id
+ * already present anywhere in `existingRoots`. Reuses the SAME mint the
+ * canvas reducer and clipboard-paste path share (`maxNodeIdSeq` +
+ * `makeNodeIdCounter`, `builder-store.tsx`) rather than a fixed literal: a
+ * brand-new document (`existingRoots` empty) mints `node-1` — matching the
+ * transfer's prior behavior — but appending into a document whose blocks
+ * already hold `node-1..N` mints past that, never re-using an id already in
+ * the tree (the EC-320 follow-up collision hazard).
+ */
+function embedFreshNode(node, existingRoots) {
+    const maxSeq = existingRoots.reduce((max, root) => Math.max(max, maxNodeIdSeq(root)), 0);
+    return embedNodeFrom(node, makeNodeIdCounter(maxSeq).genId());
+}
 /**
  * Build the draft document that embeds `node` in the collection's blocks field.
  * Reuses the CMS create machinery: {@link mintDocumentId} for a collision-free id
@@ -25,7 +58,59 @@ export function collectionsWithBlocks(collections) {
 export function buildBlockDocument({ collection, blocksField, node, existingIds, seq, }) {
     const id = mintDocumentId(collection.id, seq, existingIds);
     const values = seedDefaults(collection);
-    values[blocksField.name] = isBlocksField(blocksField) && blocksField.multiple ? [node] : node;
+    const embedded = embedFreshNode(node, []);
+    values[blocksField.name] = blocksField.multiple ? [embedded] : embedded;
     return { collection: collection.id, id, values };
 }
+/** The blocks field's current value on `document`, respecting locale (EC-018). */
+function readBlocksValue(collection, document, blocksField, locale) {
+    return isFieldLocalized(collection, blocksField.name)
+        ? document.localized?.[locale]?.[blocksField.name]
+        : document.values[blocksField.name];
+}
+/**
+ * Can `node` be appended to `document`'s blocks field without destroying
+ * existing content? Always true for a `multiple` field (an ordered list has
+ * room for one more); a single-root (`multiple: false`) field only while it
+ * is empty — occupied, there is no second root to hold it without
+ * overwriting the existing block, so the transfer dialog excludes that
+ * document from its offered targets rather than risk data loss.
+ */
+export function canAppendTo({ collection, document, blocksField, locale }) {
+    if (blocksField.multiple)
+        return true;
+    return blockRootsOf(readBlocksValue(collection, document, blocksField, locale)).length === 0;
+}
+/**
+ * Append `node` into an EXISTING document's blocks field (EC-320 follow-up,
+ * 0.0.44 — "insert into existing document"), leaving everything else about
+ * the document untouched: other fields, other locale bundles, and the
+ * field's own existing content, which the embed always lands AFTER.
+ *
+ * Reads the current roots via `blockRootsOf` (`@elytracms/core/project-graph`
+ * — the same reader the composition editor, table cell, and reuse-context
+ * use), so this reads the field back exactly like every other consumer,
+ * undefined-safe for a never-set field. Locale-aware writes go through
+ * {@link applyCellValue} (the same locale-write helper inline cell edits use,
+ * `cell-edit.ts`) so a localized blocks field's OTHER locale bundles are
+ * never touched, only the edited locale's.
+ *
+ * Node-id collision guard: `node` is re-embedded under a fresh id minted past
+ * every existing root's ids ({@link embedFreshNode}), never a fixed `node-1`
+ * — a document whose blocks already hold that id would otherwise collide.
+ *
+ * Throws if `blocksField` is a single-root (`multiple: false`) field that
+ * already holds a root — a defensive invariant guard, not a user-facing
+ * validation path: the caller must pre-filter candidates with
+ * {@link canAppendTo} so this is never reached in that state.
+ */
+export function appendToBlockDocument({ collection, document, blocksField, node, locale, }) {
+    const existingRoots = blockRootsOf(readBlocksValue(collection, document, blocksField, locale));
+    if (!blocksField.multiple && existingRoots.length > 0) {
+        throw new Error(`Cannot append to single-root blocks field "${blocksField.name}": already holds a component (caller must gate with canAppendTo).`);
+    }
+    const embedded = embedFreshNode(node, existingRoots);
+    const nextValue = blocksField.multiple ? [...existingRoots, embedded] : embedded;
+    return applyCellValue(collection, document, blocksField.name, locale, nextValue);
+}
 //# sourceMappingURL=transfer.js.map

package/dist/components/components/transfer.js.map

@@ -1 +1 @@
-{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../../src/components/components/transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAiBjD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAqC;IAErC,MAAM,OAAO,GAA6B,EAAE,CAAA;IAC5C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACnD,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,GAAG,GACqB;IACxB,MAAM,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACvC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7F,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;AAClD,CAAC","sourcesContent":["import { isBlocksField, seedDefaults } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { mintDocumentId } from '../cms/cms-store'\n\n/**\n * EC-320 — the \"design guide → real content\" bridge. A component combination the\n * user has arranged in the Components view (a manifest + edited prop values,\n * captured as a {@link ComponentNode}) is transferred into a NEW DRAFT document\n * whose blocks/composition field holds that node. Pure so the id-minting and\n * embedding are unit-testable; the React dialog owns the picker, persistence, and\n * navigation.\n */\n\nexport interface CollectionBlocksTarget {\n  collection: CollectionDef\n  /** The (first) blocks field the node lands in. */\n  field: FieldDef\n}\n\n/**\n * Collections that can receive a transferred combination — those declaring a\n * `blocks` (composition) field. The first blocks field wins (a collection with a\n * single canvas is the norm; a second is an unusual edge we don't disambiguate).\n */\nexport function collectionsWithBlocks(\n  collections: readonly CollectionDef[],\n): CollectionBlocksTarget[] {\n  const targets: CollectionBlocksTarget[] = []\n  for (const collection of collections) {\n    const field = collection.fields.find(isBlocksField)\n    if (field) targets.push({ collection, field })\n  }\n  return targets\n}\n\nexport interface BuildBlockDocumentInput {\n  collection: CollectionDef\n  /** The blocks field the node lands in (from {@link collectionsWithBlocks}). */\n  blocksField: FieldDef\n  /** The component node — a manifest id + the edited static props (+ slots). */\n  node: ComponentNode\n  /** Every doc id already in the target collection (collision guard, EC-316). */\n  existingIds: ReadonlySet<string>\n  /** The session id counter (mutated by {@link mintDocumentId}). */\n  seq: { current: number }\n}\n\n/**\n * Build the draft document that embeds `node` in the collection's blocks field.\n * Reuses the CMS create machinery: {@link mintDocumentId} for a collision-free id\n * (EC-316) and {@link seedDefaults} so declared field defaults are present (as a\n * normal `+ New` would be). A `multiple` blocks field stores an array; a single\n * (`multiple: false`) blocks field stores the lone node — matching how the\n * composition editor persists and `blockRootsOf` reads it back.\n */\nexport function buildBlockDocument({\n  collection,\n  blocksField,\n  node,\n  existingIds,\n  seq,\n}: BuildBlockDocumentInput): CmsDocument {\n  const id = mintDocumentId(collection.id, seq, existingIds)\n  const values = seedDefaults(collection)\n  values[blocksField.name] = isBlocksField(blocksField) && blocksField.multiple ? [node] : node\n  return { collection: collection.id, id, values }\n}\n"]}
+{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../../src/components/components/transfer.ts"],"names":[],"mappings":"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","sourcesContent":["import { isBlocksField, isFieldLocalized, seedDefaults } from '@elytracms/core/cms-core'\nimport type { BlocksFieldDef, CmsDocument, CollectionDef, Locale } from '@elytracms/core/cms-core'\nimport { blockRootsOf, maxNodeIdSeq } from '@elytracms/core/project-graph'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { makeNodeIdCounter } from '../builder/builder-store'\nimport { applyCellValue } from '../cms/cell-edit'\nimport { mintDocumentId } from '../cms/cms-store'\nimport { embedNodeFrom } from './component-preview'\n\n/**\n * EC-320 (+ 0.0.44 follow-up) — the \"design guide → real content\" bridge. A\n * component combination the user has arranged in the Components view (a\n * manifest + edited prop values, captured as a {@link ComponentNode}) is\n * transferred into a document's blocks/composition field — either a NEW DRAFT\n * document created for it ({@link buildBlockDocument}) or an EXISTING\n * document's field, appended alongside whatever it already holds\n * ({@link appendToBlockDocument}). Pure so id-minting/embedding/appending are\n * unit-testable; the React dialog owns the picker, persistence, and\n * navigation.\n */\n\nexport interface CollectionBlocksTarget {\n  collection: CollectionDef\n  /** The (first) blocks field the node lands in. */\n  field: BlocksFieldDef\n}\n\n/**\n * Collections that can receive a transferred combination — those declaring a\n * `blocks` (composition) field. The first blocks field wins (a collection with a\n * single canvas is the norm; a second is an unusual edge we don't disambiguate).\n * Callers additionally gate each target through {@link isComponentAllowed} —\n * this only reports which collections HAVE a blocks field, not which ones\n * accept a given component.\n */\nexport function collectionsWithBlocks(\n  collections: readonly CollectionDef[],\n): CollectionBlocksTarget[] {\n  const targets: CollectionBlocksTarget[] = []\n  for (const collection of collections) {\n    const field = collection.fields.find(isBlocksField)\n    if (field) targets.push({ collection, field })\n  }\n  return targets\n}\n\n/**\n * Is `componentId` permitted as a top-level block of `field`? Mirrors\n * `validateCompositionValue`'s (`@elytracms/core/project-graph`) top-level\n * `allow` rule EXACTLY: an absent or empty list permits any registered\n * component; a non-empty list is the closed vocabulary. A target this\n * predicate accepts can never fail that validator's `forbidden-component`\n * check on save — the transfer dialog uses this to hide targets the\n * component isn't allowed into (new AND existing document targets alike).\n */\nexport function isComponentAllowed(field: BlocksFieldDef, componentId: string): boolean {\n  return !field.allow || field.allow.length === 0 || field.allow.includes(componentId)\n}\n\n/**\n * Mint a fresh `node-<n>` id for `node`, guaranteed not to collide with any id\n * already present anywhere in `existingRoots`. Reuses the SAME mint the\n * canvas reducer and clipboard-paste path share (`maxNodeIdSeq` +\n * `makeNodeIdCounter`, `builder-store.tsx`) rather than a fixed literal: a\n * brand-new document (`existingRoots` empty) mints `node-1` — matching the\n * transfer's prior behavior — but appending into a document whose blocks\n * already hold `node-1..N` mints past that, never re-using an id already in\n * the tree (the EC-320 follow-up collision hazard).\n */\nfunction embedFreshNode(node: ComponentNode, existingRoots: readonly ComponentNode[]): ComponentNode {\n  const maxSeq = existingRoots.reduce((max, root) => Math.max(max, maxNodeIdSeq(root)), 0)\n  return embedNodeFrom(node, makeNodeIdCounter(maxSeq).genId())\n}\n\nexport interface BuildBlockDocumentInput {\n  collection: CollectionDef\n  /** The blocks field the node lands in (from {@link collectionsWithBlocks}). */\n  blocksField: BlocksFieldDef\n  /** The component node — a manifest id + the edited static props (+ slots). */\n  node: ComponentNode\n  /** Every doc id already in the target collection (collision guard, EC-316). */\n  existingIds: ReadonlySet<string>\n  /** The session id counter (mutated by {@link mintDocumentId}). */\n  seq: { current: number }\n}\n\n/**\n * Build the draft document that embeds `node` in the collection's blocks field.\n * Reuses the CMS create machinery: {@link mintDocumentId} for a collision-free id\n * (EC-316) and {@link seedDefaults} so declared field defaults are present (as a\n * normal `+ New` would be). A `multiple` blocks field stores an array; a single\n * (`multiple: false`) blocks field stores the lone node — matching how the\n * composition editor persists and `blockRootsOf` reads it back.\n */\nexport function buildBlockDocument({\n  collection,\n  blocksField,\n  node,\n  existingIds,\n  seq,\n}: BuildBlockDocumentInput): CmsDocument {\n  const id = mintDocumentId(collection.id, seq, existingIds)\n  const values = seedDefaults(collection)\n  const embedded = embedFreshNode(node, [])\n  values[blocksField.name] = blocksField.multiple ? [embedded] : embedded\n  return { collection: collection.id, id, values }\n}\n\n/** The blocks field's current value on `document`, respecting locale (EC-018). */\nfunction readBlocksValue(\n  collection: CollectionDef,\n  document: CmsDocument,\n  blocksField: BlocksFieldDef,\n  locale: Locale,\n): unknown {\n  return isFieldLocalized(collection, blocksField.name)\n    ? document.localized?.[locale]?.[blocksField.name]\n    : document.values[blocksField.name]\n}\n\nexport interface CanAppendToInput {\n  collection: CollectionDef\n  document: CmsDocument\n  blocksField: BlocksFieldDef\n  /** The locale being edited (EC-176 ambient active locale) for a localized field. */\n  locale: Locale\n}\n\n/**\n * Can `node` be appended to `document`'s blocks field without destroying\n * existing content? Always true for a `multiple` field (an ordered list has\n * room for one more); a single-root (`multiple: false`) field only while it\n * is empty — occupied, there is no second root to hold it without\n * overwriting the existing block, so the transfer dialog excludes that\n * document from its offered targets rather than risk data loss.\n */\nexport function canAppendTo({ collection, document, blocksField, locale }: CanAppendToInput): boolean {\n  if (blocksField.multiple) return true\n  return blockRootsOf(readBlocksValue(collection, document, blocksField, locale)).length === 0\n}\n\nexport interface AppendToBlockDocumentInput {\n  collection: CollectionDef\n  /** The document to append into (the transfer dialog's \"insert into existing document\"). */\n  document: CmsDocument\n  blocksField: BlocksFieldDef\n  /** The component node to append — not yet re-ided (fresh id minted here). */\n  node: ComponentNode\n  /** The locale being edited (EC-176 ambient active locale) for a localized field. */\n  locale: Locale\n}\n\n/**\n * Append `node` into an EXISTING document's blocks field (EC-320 follow-up,\n * 0.0.44 — \"insert into existing document\"), leaving everything else about\n * the document untouched: other fields, other locale bundles, and the\n * field's own existing content, which the embed always lands AFTER.\n *\n * Reads the current roots via `blockRootsOf` (`@elytracms/core/project-graph`\n * — the same reader the composition editor, table cell, and reuse-context\n * use), so this reads the field back exactly like every other consumer,\n * undefined-safe for a never-set field. Locale-aware writes go through\n * {@link applyCellValue} (the same locale-write helper inline cell edits use,\n * `cell-edit.ts`) so a localized blocks field's OTHER locale bundles are\n * never touched, only the edited locale's.\n *\n * Node-id collision guard: `node` is re-embedded under a fresh id minted past\n * every existing root's ids ({@link embedFreshNode}), never a fixed `node-1`\n * — a document whose blocks already hold that id would otherwise collide.\n *\n * Throws if `blocksField` is a single-root (`multiple: false`) field that\n * already holds a root — a defensive invariant guard, not a user-facing\n * validation path: the caller must pre-filter candidates with\n * {@link canAppendTo} so this is never reached in that state.\n */\nexport function appendToBlockDocument({\n  collection,\n  document,\n  blocksField,\n  node,\n  locale,\n}: AppendToBlockDocumentInput): CmsDocument {\n  const existingRoots = blockRootsOf(readBlocksValue(collection, document, blocksField, locale))\n  if (!blocksField.multiple && existingRoots.length > 0) {\n    throw new Error(\n      `Cannot append to single-root blocks field \"${blocksField.name}\": already holds a component (caller must gate with canAppendTo).`,\n    )\n  }\n  const embedded = embedFreshNode(node, existingRoots)\n  const nextValue = blocksField.multiple ? [...existingRoots, embedded] : embedded\n  return applyCellValue(collection, document, blocksField.name, locale, nextValue)\n}\n"]}

package/dist/components/delivery-health-banner.d.ts

@@ -1,11 +1,17 @@
 /**
  * EC-268: a boot-up health check for instant publish (EC-146). When the studio is
- * connected to a Convex deployment, it reads `delivery:deliveryConfig` once and, if
- * any of the delivery env vars are unset, shows a dismissible warning. Without this
- * the pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`
+ * connected to a Convex deployment, it reads the delivery config through the
+ * operations seam (EC-329 — `operations.delivery.config`, cached by
+ * `useOperationQuery` like every other studio read, AD-17) and, if any of the
+ * delivery env vars are unset, shows a dismissible warning. Without this the
+ * pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`
  * returns before scheduling (no `CANVAS_PROJECT_SCOPE`) and the live site never
  * updates. In playground mode (no backend) instant publish does not apply and the
- * banner never renders. Failure to read config is swallowed — it must never block
- * the studio.
+ * banner never renders (the query is disabled, so it never has data). A failed
+ * read degrades silently — it must never block the studio — by treating the
+ * query's error branch the same as "nothing missing", matching the former raw
+ * client call's swallowed `.catch()`.
  */
-export declare function DeliveryHealthBanner(): import("react").JSX.Element | null;
+export declare function DeliveryHealthBanner({ projectId }: {
+    projectId: string;
+}): import("react").JSX.Element | null;

package/dist/components/delivery-health-banner.js

@@ -1,44 +1,42 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
+import { useState } from 'react';
 import { Rocket, X } from 'lucide-react';
 import { Button, Row, Spacer, Text } from '@elytracms/studio/ui';
 import { translate } from '@elytracms/studio/lib/i18n';
 import { resolveBackendConfig } from '../lib/persistence/backend-mode';
-import { getConvexClient, queryRef } from '../lib/persistence/convex-client';
-import { resolveDeploymentUrl } from '../lib/workspace';
 import { missingInstantPublishVars } from '../lib/delivery/instant-publish';
+import { useOperationQuery } from '@elytracms/studio/lib/query';
 /**
  * EC-268: a boot-up health check for instant publish (EC-146). When the studio is
- * connected to a Convex deployment, it reads `delivery:deliveryConfig` once and, if
- * any of the delivery env vars are unset, shows a dismissible warning. Without this
- * the pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`
+ * connected to a Convex deployment, it reads the delivery config through the
+ * operations seam (EC-329 — `operations.delivery.config`, cached by
+ * `useOperationQuery` like every other studio read, AD-17) and, if any of the
+ * delivery env vars are unset, shows a dismissible warning. Without this the
+ * pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`
  * returns before scheduling (no `CANVAS_PROJECT_SCOPE`) and the live site never
  * updates. In playground mode (no backend) instant publish does not apply and the
- * banner never renders. Failure to read config is swallowed — it must never block
- * the studio.
+ * banner never renders (the query is disabled, so it never has data). A failed
+ * read degrades silently — it must never block the studio — by treating the
+ * query's error branch the same as "nothing missing", matching the former raw
+ * client call's swallowed `.catch()`.
  */
-export function DeliveryHealthBanner() {
-    const [missing, setMissing] = useState(null);
+export function DeliveryHealthBanner({ projectId }) {
     const [dismissed, setDismissed] = useState(false);
-    useEffect(() => {
-        const config = resolveBackendConfig();
-        if (config.kind !== 'convex')
-            return;
-        let cancelled = false;
-        getConvexClient(resolveDeploymentUrl(config.url))
-            .query(queryRef('delivery:deliveryConfig'), {})
-            .then((status) => {
-            if (!cancelled)
-                setMissing(missingInstantPublishVars(status));
-        })
-            .catch(() => {
-            /* config unknown (older deployment, transport) — stay silent. */
-        });
-        return () => {
-            cancelled = true;
-        };
-    }, []);
-    if (dismissed || !missing || missing.length === 0)
+    const enabled = resolveBackendConfig().kind === 'convex';
+    const query = useOperationQuery({
+        queryKey: ['delivery', 'config', projectId],
+        loader: async (operations) => {
+            const result = await operations.delivery.config({ projectId });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            return result.value;
+        },
+        enabled,
+    });
+    // Loading/error/playground (disabled) all read as "nothing missing" — the
+    // banner only ever surfaces a CONFIRMED gap, never a transient/unreachable one.
+    const missing = query.data ? missingInstantPublishVars(query.data) : [];
+    if (dismissed || missing.length === 0)
         return null;
     return (_jsxs(Row, { gap: "2", className: "shrink-0 border-b border-warning/30 bg-warning/10 px-4 py-1.5 text-warning sm:px-6", "data-testid": "delivery-health-banner", children: [_jsx(Rocket, { className: "size-3.5 shrink-0", "aria-hidden": true }), _jsxs(Text, { size: "xs", className: "text-warning", children: ["Instant publish isn\u2019t fully configured \u2014 ", missing.join(', '), " not set on this Convex deployment. Publishes succeed, but the live site won\u2019t update until you set them (see CONNECT.md) and re-push functions."] }), _jsx(Spacer, {}), _jsx(Button, { variant: "ghost", size: "icon-sm", onClick: () => setDismissed(true), "aria-label": translate('shell.deliveryHealth.dismiss'), title: translate('shell.deliveryHealth.dismiss'), children: _jsx(X, { "aria-hidden": true }) })] }));
 }

package/dist/components/delivery-health-banner.js.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-health-banner.js","sourceRoot":"","sources":["../../src/components/delivery-health-banner.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAG3E;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC,CAAA;IAC7D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAA;QACrC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAM;QACpC,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,eAAe,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;aAC9C,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,EAAE,CAAC;aAC9C,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,SAAS;gBAAE,UAAU,CAAC,yBAAyB,CAAC,MAA8B,CAAC,CAAC,CAAA;QACvF,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,iEAAiE;QACnE,CAAC,CAAC,CAAA;QACJ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,IAAI,SAAS,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE9D,OAAO,CACL,MAAC,GAAG,IACF,GAAG,EAAC,GAAG,EACP,SAAS,EAAC,oFAAoF,iBAClF,wBAAwB,aAEpC,KAAC,MAAM,IAAC,SAAS,EAAC,mBAAmB,wBAAe,EACpD,MAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,cAAc,oEACI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,6JAGvD,EACP,KAAC,MAAM,KAAG,EACV,KAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,IAAI,EAAC,SAAS,EACd,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,gBACrB,SAAS,CAAC,8BAA8B,CAAC,EACrD,KAAK,EAAE,SAAS,CAAC,8BAA8B,CAAC,YAEhD,KAAC,CAAC,0BAAe,GACV,IACL,CACP,CAAA;AACH,CAAC","sourcesContent":["import { useEffect, useState } from 'react'\nimport { Rocket, X } from 'lucide-react'\nimport { Button, Row, Spacer, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { resolveBackendConfig } from '../lib/persistence/backend-mode'\nimport { getConvexClient, queryRef } from '../lib/persistence/convex-client'\nimport { resolveDeploymentUrl } from '../lib/workspace'\nimport { missingInstantPublishVars } from '../lib/delivery/instant-publish'\nimport type { DeliveryConfigStatus } from '../lib/delivery/instant-publish'\n\n/**\n * EC-268: a boot-up health check for instant publish (EC-146). When the studio is\n * connected to a Convex deployment, it reads `delivery:deliveryConfig` once and, if\n * any of the delivery env vars are unset, shows a dismissible warning. Without this\n * the pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`\n * returns before scheduling (no `CANVAS_PROJECT_SCOPE`) and the live site never\n * updates. In playground mode (no backend) instant publish does not apply and the\n * banner never renders. Failure to read config is swallowed — it must never block\n * the studio.\n */\nexport function DeliveryHealthBanner() {\n  const [missing, setMissing] = useState<string[] | null>(null)\n  const [dismissed, setDismissed] = useState(false)\n\n  useEffect(() => {\n    const config = resolveBackendConfig()\n    if (config.kind !== 'convex') return\n    let cancelled = false\n    getConvexClient(resolveDeploymentUrl(config.url))\n      .query(queryRef('delivery:deliveryConfig'), {})\n      .then((status) => {\n        if (!cancelled) setMissing(missingInstantPublishVars(status as DeliveryConfigStatus))\n      })\n      .catch(() => {\n        /* config unknown (older deployment, transport) — stay silent. */\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [])\n\n  if (dismissed || !missing || missing.length === 0) return null\n\n  return (\n    <Row\n      gap=\"2\"\n      className=\"shrink-0 border-b border-warning/30 bg-warning/10 px-4 py-1.5 text-warning sm:px-6\"\n      data-testid=\"delivery-health-banner\"\n    >\n      <Rocket className=\"size-3.5 shrink-0\" aria-hidden />\n      <Text size=\"xs\" className=\"text-warning\">\n        Instant publish isn’t fully configured — {missing.join(', ')} not set on this Convex\n        deployment. Publishes succeed, but the live site won’t update until you set them (see\n        CONNECT.md) and re-push functions.\n      </Text>\n      <Spacer />\n      <Button\n        variant=\"ghost\"\n        size=\"icon-sm\"\n        onClick={() => setDismissed(true)}\n        aria-label={translate('shell.deliveryHealth.dismiss')}\n        title={translate('shell.deliveryHealth.dismiss')}\n      >\n        <X aria-hidden />\n      </Button>\n    </Row>\n  )\n}\n"]}
+{"version":3,"file":"delivery-health-banner.js","sourceRoot":"","sources":["../../src/components/delivery-health-banner.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAG/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,SAAS,EAAyB;IACvE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAA;IAExD,MAAM,KAAK,GAAG,iBAAiB,CAAuB;QACpD,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;QAC3C,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;YAC9D,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACrD,OAAO,MAAM,CAAC,KAAK,CAAA;QACrB,CAAC;QACD,OAAO;KACR,CAAC,CAAA;IACF,0EAA0E;IAC1E,gFAAgF;IAChF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvE,IAAI,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAElD,OAAO,CACL,MAAC,GAAG,IACF,GAAG,EAAC,GAAG,EACP,SAAS,EAAC,oFAAoF,iBAClF,wBAAwB,aAEpC,KAAC,MAAM,IAAC,SAAS,EAAC,mBAAmB,wBAAe,EACpD,MAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,cAAc,oEACI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,6JAGvD,EACP,KAAC,MAAM,KAAG,EACV,KAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,IAAI,EAAC,SAAS,EACd,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,gBACrB,SAAS,CAAC,8BAA8B,CAAC,EACrD,KAAK,EAAE,SAAS,CAAC,8BAA8B,CAAC,YAEhD,KAAC,CAAC,0BAAe,GACV,IACL,CACP,CAAA;AACH,CAAC","sourcesContent":["import { useState } from 'react'\nimport { Rocket, X } from 'lucide-react'\nimport { Button, Row, Spacer, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { resolveBackendConfig } from '../lib/persistence/backend-mode'\nimport { missingInstantPublishVars } from '../lib/delivery/instant-publish'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport type { DeliveryConfigStatus } from '@elytracms/core/persistence'\n\n/**\n * EC-268: a boot-up health check for instant publish (EC-146). When the studio is\n * connected to a Convex deployment, it reads the delivery config through the\n * operations seam (EC-329 — `operations.delivery.config`, cached by\n * `useOperationQuery` like every other studio read, AD-17) and, if any of the\n * delivery env vars are unset, shows a dismissible warning. Without this the\n * pipeline fails SILENTLY — a publish reports success but `scheduleRevalidate`\n * returns before scheduling (no `CANVAS_PROJECT_SCOPE`) and the live site never\n * updates. In playground mode (no backend) instant publish does not apply and the\n * banner never renders (the query is disabled, so it never has data). A failed\n * read degrades silently — it must never block the studio — by treating the\n * query's error branch the same as \"nothing missing\", matching the former raw\n * client call's swallowed `.catch()`.\n */\nexport function DeliveryHealthBanner({ projectId }: { projectId: string }) {\n  const [dismissed, setDismissed] = useState(false)\n  const enabled = resolveBackendConfig().kind === 'convex'\n\n  const query = useOperationQuery<DeliveryConfigStatus>({\n    queryKey: ['delivery', 'config', projectId],\n    loader: async (operations) => {\n      const result = await operations.delivery.config({ projectId })\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    },\n    enabled,\n  })\n  // Loading/error/playground (disabled) all read as \"nothing missing\" — the\n  // banner only ever surfaces a CONFIRMED gap, never a transient/unreachable one.\n  const missing = query.data ? missingInstantPublishVars(query.data) : []\n\n  if (dismissed || missing.length === 0) return null\n\n  return (\n    <Row\n      gap=\"2\"\n      className=\"shrink-0 border-b border-warning/30 bg-warning/10 px-4 py-1.5 text-warning sm:px-6\"\n      data-testid=\"delivery-health-banner\"\n    >\n      <Rocket className=\"size-3.5 shrink-0\" aria-hidden />\n      <Text size=\"xs\" className=\"text-warning\">\n        Instant publish isn’t fully configured — {missing.join(', ')} not set on this Convex\n        deployment. Publishes succeed, but the live site won’t update until you set them (see\n        CONNECT.md) and re-push functions.\n      </Text>\n      <Spacer />\n      <Button\n        variant=\"ghost\"\n        size=\"icon-sm\"\n        onClick={() => setDismissed(true)}\n        aria-label={translate('shell.deliveryHealth.dismiss')}\n        title={translate('shell.deliveryHealth.dismiss')}\n      >\n        <X aria-hidden />\n      </Button>\n    </Row>\n  )\n}\n"]}

package/dist/components/dev-login-badge.d.ts

@@ -1,5 +1,3 @@
-/** Tooltip/accessible description — the studio signed in automatically. */
-export declare const DEV_LOGIN_BADGE_HINT = "Dev auto-login: the studio signed in automatically from VITE_ELYTRA_DEV_LOGIN (dev builds only). Unset it to test the real sign-in flow.";
 /**
  * Marker for the dev-only unattended auth (see `resolveDevAutoLogin`). When the
  * studio auto-signs-in from `VITE_ELYTRA_DEV_LOGIN` in a dev build, this badge

package/dist/components/dev-login-badge.js

@@ -3,8 +3,6 @@ import { KeyRound } from 'lucide-react';
 import { Badge } from '@elytracms/studio/ui';
 import { isDevAutoLoginActive } from '@elytracms/studio/lib/persistence';
 import { translate } from '@elytracms/studio/lib/i18n';
-/** Tooltip/accessible description — the studio signed in automatically. */
-export const DEV_LOGIN_BADGE_HINT = 'Dev auto-login: the studio signed in automatically from VITE_ELYTRA_DEV_LOGIN (dev builds only). Unset it to test the real sign-in flow.';
 /**
  * Marker for the dev-only unattended auth (see `resolveDevAutoLogin`). When the
  * studio auto-signs-in from `VITE_ELYTRA_DEV_LOGIN` in a dev build, this badge
@@ -14,6 +12,6 @@ export const DEV_LOGIN_BADGE_HINT = 'Dev auto-login: the studio signed in automa
 export function DevLoginBadge() {
     if (!isDevAutoLoginActive())
         return null;
-    return (_jsxs(Badge, { variant: "warning", title: DEV_LOGIN_BADGE_HINT, "data-testid": "dev-login-badge", children: [_jsx(KeyRound, { "aria-hidden": true }), translate('shell.devLogin.badge')] }));
+    return (_jsxs(Badge, { variant: "warning", title: translate('shell.devLogin.hint'), "data-testid": "dev-login-badge", children: [_jsx(KeyRound, { "aria-hidden": true }), translate('shell.devLogin.badge')] }));
 }
 //# sourceMappingURL=dev-login-badge.js.map

package/dist/components/dev-login-badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-login-badge.js","sourceRoot":"","sources":["../../src/components/dev-login-badge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,0IAA0I,CAAA;AAE5I;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,IAAI,CAAA;IACxC,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAE,oBAAoB,iBAAc,iBAAiB,aACjF,KAAC,QAAQ,0BAAe,EACvB,SAAS,CAAC,sBAAsB,CAAC,IAC5B,CACT,CAAA;AACH,CAAC","sourcesContent":["import { KeyRound } from 'lucide-react'\nimport { Badge } from '@elytracms/studio/ui'\nimport { isDevAutoLoginActive } from '@elytracms/studio/lib/persistence'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/** Tooltip/accessible description — the studio signed in automatically. */\nexport const DEV_LOGIN_BADGE_HINT =\n  'Dev auto-login: the studio signed in automatically from VITE_ELYTRA_DEV_LOGIN (dev builds only). Unset it to test the real sign-in flow.'\n\n/**\n * Marker for the dev-only unattended auth (see `resolveDevAutoLogin`). When the\n * studio auto-signs-in from `VITE_ELYTRA_DEV_LOGIN` in a dev build, this badge\n * is visible in the shell header so an auto-authenticated session is never\n * silent; in production builds and without the flag it renders nothing.\n */\nexport function DevLoginBadge() {\n  if (!isDevAutoLoginActive()) return null\n  return (\n    <Badge variant=\"warning\" title={DEV_LOGIN_BADGE_HINT} data-testid=\"dev-login-badge\">\n      <KeyRound aria-hidden />\n      {translate('shell.devLogin.badge')}\n    </Badge>\n  )\n}\n"]}
+{"version":3,"file":"dev-login-badge.js","sourceRoot":"","sources":["../../src/components/dev-login-badge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,IAAI,CAAA;IACxC,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAE,SAAS,CAAC,qBAAqB,CAAC,iBAAc,iBAAiB,aAC7F,KAAC,QAAQ,0BAAe,EACvB,SAAS,CAAC,sBAAsB,CAAC,IAC5B,CACT,CAAA;AACH,CAAC","sourcesContent":["import { KeyRound } from 'lucide-react'\nimport { Badge } from '@elytracms/studio/ui'\nimport { isDevAutoLoginActive } from '@elytracms/studio/lib/persistence'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Marker for the dev-only unattended auth (see `resolveDevAutoLogin`). When the\n * studio auto-signs-in from `VITE_ELYTRA_DEV_LOGIN` in a dev build, this badge\n * is visible in the shell header so an auto-authenticated session is never\n * silent; in production builds and without the flag it renders nothing.\n */\nexport function DevLoginBadge() {\n  if (!isDevAutoLoginActive()) return null\n  return (\n    <Badge variant=\"warning\" title={translate('shell.devLogin.hint')} data-testid=\"dev-login-badge\">\n      <KeyRound aria-hidden />\n      {translate('shell.devLogin.badge')}\n    </Badge>\n  )\n}\n"]}

package/dist/components/playground-badge.d.ts

@@ -1,5 +1,3 @@
-/** Tooltip/accessible description — playground data is local and ephemeral. */
-export declare const PLAYGROUND_BADGE_HINT = "Playground mode: data lives in memory on this device and resets on reload. Nothing is saved to a backend.";
 /**
  * EC-153: the explicit playground-mode marker. When the studio runs on the
  * seeded in-memory adapter (`VITE_ELYTRA_MODE=playground`) this badge is

package/dist/components/playground-badge.js

@@ -3,8 +3,6 @@ import { FlaskConical } from 'lucide-react';
 import { Badge } from '@elytracms/studio/ui';
 import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
 import { translate } from '@elytracms/studio/lib/i18n';
-/** Tooltip/accessible description — playground data is local and ephemeral. */
-export const PLAYGROUND_BADGE_HINT = 'Playground mode: data lives in memory on this device and resets on reload. Nothing is saved to a backend.';
 /**
  * EC-153: the explicit playground-mode marker. When the studio runs on the
  * seeded in-memory adapter (`VITE_ELYTRA_MODE=playground`) this badge is

package/dist/components/playground-badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground-badge.js","sourceRoot":"","sources":["../../src/components/playground-badge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAChC,2GAA2G,CAAA;AAE7G;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAE,SAAS,CAAC,uBAAuB,CAAC,iBAAc,kBAAkB,aAChG,KAAC,YAAY,0BAAe,EAC3B,SAAS,CAAC,wBAAwB,CAAC,IAC9B,CACT,CAAA;AACH,CAAC","sourcesContent":["import { FlaskConical } from 'lucide-react'\nimport { Badge } from '@elytracms/studio/ui'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/** Tooltip/accessible description — playground data is local and ephemeral. */\nexport const PLAYGROUND_BADGE_HINT =\n  'Playground mode: data lives in memory on this device and resets on reload. Nothing is saved to a backend.'\n\n/**\n * EC-153: the explicit playground-mode marker. When the studio runs on the\n * seeded in-memory adapter (`VITE_ELYTRA_MODE=playground`) this badge is\n * always visible in the shell header; in Convex mode it renders nothing.\n * Deterministic: mode is resolved from build-time env, identical on SSR and\n * client.\n */\nexport function PlaygroundBadge() {\n  if (!isPlaygroundMode()) return null\n  return (\n    <Badge variant=\"warning\" title={translate('shell.playground.hint')} data-testid=\"playground-badge\">\n      <FlaskConical aria-hidden />\n      {translate('shell.playground.badge')}\n    </Badge>\n  )\n}\n"]}
+{"version":3,"file":"playground-badge.js","sourceRoot":"","sources":["../../src/components/playground-badge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAE,SAAS,CAAC,uBAAuB,CAAC,iBAAc,kBAAkB,aAChG,KAAC,YAAY,0BAAe,EAC3B,SAAS,CAAC,wBAAwB,CAAC,IAC9B,CACT,CAAA;AACH,CAAC","sourcesContent":["import { FlaskConical } from 'lucide-react'\nimport { Badge } from '@elytracms/studio/ui'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * EC-153: the explicit playground-mode marker. When the studio runs on the\n * seeded in-memory adapter (`VITE_ELYTRA_MODE=playground`) this badge is\n * always visible in the shell header; in Convex mode it renders nothing.\n * Deterministic: mode is resolved from build-time env, identical on SSR and\n * client.\n */\nexport function PlaygroundBadge() {\n  if (!isPlaygroundMode()) return null\n  return (\n    <Badge variant=\"warning\" title={translate('shell.playground.hint')} data-testid=\"playground-badge\">\n      <FlaskConical aria-hidden />\n      {translate('shell.playground.badge')}\n    </Badge>\n  )\n}\n"]}

package/dist/components/project-list.js

@@ -8,7 +8,7 @@ import { PlaygroundBadge } from './playground-badge';
 import { SignInNeededBadge } from './sign-in-needed-badge';
 import { SectionStateView } from './section-state';
 import { useStudio } from './studio-context';
-import { useSwitcherEntries } from './workspace-projects';
+import { useRecentProjects, useSwitcherEntries } from './workspace-projects';
 /**
  * Studio launcher / project list (brief §4.3, §8.1; reframed by EC-154). The
  * Studio's front door: lists the workspace's projects and routes into a
@@ -23,11 +23,7 @@ export function ProjectLauncher({ forcedState }) {
     const { entries, workspace } = useSwitcherEntries();
     const hasConfig = workspace.kind === 'config';
     const visible = entries;
-    const recents = studio.context.recentProjectIds
-        .map((id) => studio.getProject(id))
-        .filter((p) => Boolean(p))
-        .filter((p) => entries.some((e) => e.kind === 'project' && e.project.id === p.id))
-        .slice(0, 4);
+    const recents = useRecentProjects(entries);
     const forced = forcedState && forcedState !== 'working' ? forcedState : null;
     return (_jsxs("div", { className: "mx-auto w-full max-w-6xl px-6 py-8", children: [_jsxs(Row, { gap: "3", className: "mb-6", children: [_jsxs(Stack, { gap: "1", children: [_jsxs(Row, { gap: "2", children: [_jsx(Heading, { size: "display", children: translate('shell.projects') }), _jsx(PlaygroundBadge, {}), hasConfig ? (_jsxs(Badge, { variant: "outline", children: [_jsx(TerminalSquare, { className: "size-3" }), " ", workspace.source] })) : null] }), _jsx(Text, { tone: "muted", children: hasConfig
                                     ? 'Projects are defined in code. Add entries to elytra.config.ts and provision them with the CLI.'