@elytracms/studio 0.0.42 → 0.0.44

package/dist/components/rail-view-source.js

@@ -0,0 +1,139 @@
+import { useCallback, useMemo, useState } from 'react';
+import { defaultViewState } from '@elytracms/studio/lib/cms-views';
+/** The default normalizer for an {@link OkResult}: a failure maps to a
+ *  surfaced {@link OperationError}; a success maps to no error at all. */
+export function normalizeOkResult(result) {
+    return result.ok ? null : { code: 'unknown', message: result.message };
+}
+/**
+ * Project a lens document's values into a meta bag (EC-311/EC-240/EC-303):
+ * every entry whose key is NOT one of the rail's canonical/identity field
+ * names round-trips through the record's open `meta` bag. Shared by the users
+ * (`IDENTITY_FIELDS`) and redirects (`CANONICAL_REDIRECT_FIELDS`) rails — the
+ * assets rail's projection is schema-FIELDS-driven inclusion (iterating the
+ * schema's declared fields, not the document's value keys), a genuinely
+ * different shape that stays bespoke in `assets-collection-view-source.ts`.
+ */
+export function metaBagProjection(values, canonicalNames) {
+    const meta = {};
+    for (const [key, value] of Object.entries(values)) {
+        if (!canonicalNames.has(key))
+            meta[key] = value;
+    }
+    return meta;
+}
+/** Wrap a raw store write (save/remove) so a normalized failure surfaces via
+ *  `setError` — the factory's error-mapping plumbing, pulled out as a plain
+ *  function (no hook) so it is unit-testable without a `renderHook` harness. */
+export function createErrorMappedWriter(write, normalize, setError) {
+    return (arg) => {
+        void write(arg).then((result) => {
+            const error = normalize(result);
+            if (error)
+                setError(error);
+        });
+    };
+}
+/**
+ * Pure assembly of a {@link CollectionViewSource} from a rail's resolved
+ * fields + state. Exported (and taking plain data/functions, no hook) so it is
+ * directly unit-testable — this workspace runs vitest in `environment: 'node'`
+ * (no `renderHook`); {@link useRailViewSource} is a thin `useState`/`useMemo`
+ * wrapper around it.
+ */
+export function assembleRailViewSource(input) {
+    const { projectId, schema, capabilities, localeConfig, documents, get, titleOf, referenceCandidates, collections, detailPath, listPath, isFieldReadOnly, fieldAccess, validate, create, lastError, clearLastError, viewState, setViewState, save, remove, } = input;
+    return {
+        collectionId: schema.id,
+        schema,
+        capabilities,
+        projectId,
+        localeConfig,
+        activeLocale: localeConfig.default,
+        documents,
+        get,
+        titleOf,
+        referenceCandidates: referenceCandidates ?? (() => []),
+        collections: collections ?? [schema],
+        ...(detailPath ? { detailPath } : {}),
+        ...(listPath !== undefined ? { listPath } : {}),
+        isFieldReadOnly: isFieldReadOnly ?? ((field) => field.form?.readOnly ?? false),
+        ...(fieldAccess ? { fieldAccess } : {}),
+        validate,
+        lastError,
+        clearLastError,
+        viewState: () => viewState,
+        setViewState,
+        create,
+        save,
+        remove,
+    };
+}
+/**
+ * The shared scaffold factory (EC-327) behind the assets/users/redirects rail
+ * `CollectionViewSource` hooks: `viewState`/`lastError` state, the
+ * `setViewState` updater-fn wrapper, the error-mapped save/remove wiring (via
+ * the rail's own result normalizer), and the final assembled source. See the
+ * module doc for what stays a per-rail parameter rather than being absorbed
+ * here.
+ */
+export function useRailViewSource(adapter) {
+    const { projectId, schema, capabilities, localeConfig, documents, get, titleOf, referenceCandidates, collections, detailPath, listPath, isFieldReadOnly, fieldAccess, validate, create, save: rawSave, remove: rawRemove, normalizeSaveResult, normalizeRemoveResult, } = adapter;
+    const [viewState, setViewStateRaw] = useState(() => defaultViewState(schema));
+    const [lastError, setLastError] = useState(null);
+    const setViewState = useCallback((update) => {
+        setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update));
+    }, []);
+    const clearLastError = useCallback(() => setLastError(null), []);
+    const save = useCallback(createErrorMappedWriter(rawSave, normalizeSaveResult, setLastError), [
+        rawSave,
+        normalizeSaveResult,
+    ]);
+    const remove = useCallback(createErrorMappedWriter(rawRemove, normalizeRemoveResult, setLastError), [rawRemove, normalizeRemoveResult]);
+    return useMemo(() => assembleRailViewSource({
+        projectId,
+        schema,
+        capabilities,
+        localeConfig,
+        documents,
+        get,
+        titleOf,
+        referenceCandidates,
+        collections,
+        detailPath,
+        listPath,
+        isFieldReadOnly,
+        fieldAccess,
+        validate,
+        create,
+        lastError,
+        clearLastError,
+        viewState,
+        setViewState,
+        save,
+        remove,
+    }), [
+        projectId,
+        schema,
+        capabilities,
+        localeConfig,
+        documents,
+        get,
+        titleOf,
+        referenceCandidates,
+        collections,
+        detailPath,
+        listPath,
+        isFieldReadOnly,
+        fieldAccess,
+        validate,
+        create,
+        lastError,
+        clearLastError,
+        viewState,
+        setViewState,
+        save,
+        remove,
+    ]);
+}
+//# sourceMappingURL=rail-view-source.js.map

package/dist/components/rail-view-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rail-view-source.js","sourceRoot":"","sources":["../../src/components/rail-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  DocumentRef,\n  FieldDef,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport type { OperationError } from '@elytracms/core/operations'\nimport { defaultViewState } from '@elytracms/studio/lib/cms-views'\nimport type { TableViewState } from '@elytracms/studio/lib/cms-views'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n  FieldAccess,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\n\n/**\n * The shared scaffold behind the primitive-rail `CollectionViewSource` hooks\n * (EC-327) — assets, users, redirects. All three hand-rolled identical\n * `viewState`/`lastError` state, an identical `setViewState` updater-fn\n * wrapper, an identical `if (!result.ok) setLastError(...)` error-mapping\n * shape (assets' `remove` diverges — see {@link OkResult} below), and a large\n * final `useMemo` assembling the same ~20-field {@link CollectionViewSource}.\n * The 4th rail (`useCmsCollectionViewSource`) does NOT reduplicate this — it\n * delegates to the ambient `CmsStore` — so this scaffold is scoped to the\n * three self-contained rails, not a fully generic replacement for the CMS\n * adapter.\n *\n * Genuinely divergent per-rail behaviour is a PARAMETER, never hidden here:\n * users' principal-based `fieldAccess`, users' no-op vs. redirects/assets'\n * registry-driven `validate`, redirects-only `create`, and — the one save/\n * remove result-shape mismatch — assets' `remove()` returns an\n * `outcome`-discriminated result where users/redirects use `{ ok }`; each rail\n * supplies its own `normalizeSaveResult`/`normalizeRemoveResult` to reconcile\n * whichever shape its store returns into `lastError`.\n */\n\n/** The common `{ ok: true; … } | { ok: false; message }` store-result shape —\n *  users' and redirects' save/remove, and assets' `updateMetadata` (save). */\nexport type OkResult = { ok: true } | { ok: false; message: string }\n\n/** The default normalizer for an {@link OkResult}: a failure maps to a\n *  surfaced {@link OperationError}; a success maps to no error at all. */\nexport function normalizeOkResult(result: OkResult): OperationError | null {\n  return result.ok ? null : { code: 'unknown', message: result.message }\n}\n\n/**\n * Project a lens document's values into a meta bag (EC-311/EC-240/EC-303):\n * every entry whose key is NOT one of the rail's canonical/identity field\n * names round-trips through the record's open `meta` bag. Shared by the users\n * (`IDENTITY_FIELDS`) and redirects (`CANONICAL_REDIRECT_FIELDS`) rails — the\n * assets rail's projection is schema-FIELDS-driven inclusion (iterating the\n * schema's declared fields, not the document's value keys), a genuinely\n * different shape that stays bespoke in `assets-collection-view-source.ts`.\n */\nexport function metaBagProjection(\n  values: Record<string, unknown>,\n  canonicalNames: ReadonlySet<string>,\n): Record<string, unknown> {\n  const meta: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(values)) {\n    if (!canonicalNames.has(key)) meta[key] = value\n  }\n  return meta\n}\n\n/** Wrap a raw store write (save/remove) so a normalized failure surfaces via\n *  `setError` — the factory's error-mapping plumbing, pulled out as a plain\n *  function (no hook) so it is unit-testable without a `renderHook` harness. */\nexport function createErrorMappedWriter<TArg, TResult>(\n  write: (arg: TArg) => Promise<TResult>,\n  normalize: (result: TResult) => OperationError | null,\n  setError: (error: OperationError) => void,\n): (arg: TArg) => void {\n  return (arg: TArg) => {\n    void write(arg).then((result) => {\n      const error = normalize(result)\n      if (error) setError(error)\n    })\n  }\n}\n\n/** The fields shared by {@link RailAdapter} and the pure assembly input —\n *  everything the factory copies straight onto the assembled source, or\n *  defaults when a rail omits it. */\ninterface RailViewSourceCore {\n  readonly projectId: string\n  readonly schema: CollectionDef\n  readonly capabilities: CollectionViewCapabilities\n  readonly localeConfig: LocaleConfig\n  documents(): CmsDocument[]\n  get(ref: DocumentRef): CmsDocument | undefined\n  titleOf(ref: DocumentRef): string\n  /** Default `() => []` — none of the three rails carry cross-collection relation fields (v1). */\n  referenceCandidates?(collectionId: string): CmsDocument[]\n  /** Default `[schema]` — the rail's own schema is the only collection in scope. */\n  collections?: readonly CollectionDef[]\n  detailPath?(id: string): string\n  listPath?: string\n  /** Default `field => field.form?.readOnly ?? false`. */\n  isFieldReadOnly?(field: FieldDef): boolean\n  /** Principal-based tri-state — only the users rail supplies one. */\n  fieldAccess?(field: FieldDef, record?: CmsDocument): FieldAccess\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  create(): DocumentRef\n}\n\n/** A rail's input to {@link useRailViewSource}: its store-facing reads/writes,\n *  capability profile, and lens projections. `TSaveResult`/`TRemoveResult` are\n *  each rail's own store-result shape — reconciled to `lastError` by the\n *  rail's own `normalizeSaveResult`/`normalizeRemoveResult`. */\nexport interface RailAdapter<TSaveResult, TRemoveResult> extends RailViewSourceCore {\n  save(doc: CmsDocument): Promise<TSaveResult>\n  remove(ref: DocumentRef): Promise<TRemoveResult>\n  normalizeSaveResult(result: TSaveResult): OperationError | null\n  normalizeRemoveResult(result: TRemoveResult): OperationError | null\n}\n\n/** The already-resolved state + error-wrapped writes {@link useRailViewSource}\n *  hands to the pure assembly function below. */\ninterface RailViewSourceAssemblyInput extends RailViewSourceCore {\n  lastError: OperationError | null\n  clearLastError(): void\n  viewState: TableViewState\n  setViewState: CollectionViewSource['setViewState']\n  save(doc: CmsDocument): void\n  remove(ref: DocumentRef): void\n}\n\n/**\n * Pure assembly of a {@link CollectionViewSource} from a rail's resolved\n * fields + state. Exported (and taking plain data/functions, no hook) so it is\n * directly unit-testable — this workspace runs vitest in `environment: 'node'`\n * (no `renderHook`); {@link useRailViewSource} is a thin `useState`/`useMemo`\n * wrapper around it.\n */\nexport function assembleRailViewSource(input: RailViewSourceAssemblyInput): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    validate,\n    create,\n    lastError,\n    clearLastError,\n    viewState,\n    setViewState,\n    save,\n    remove,\n  } = input\n  return {\n    collectionId: schema.id,\n    schema,\n    capabilities,\n    projectId,\n    localeConfig,\n    activeLocale: localeConfig.default,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates: referenceCandidates ?? (() => []),\n    collections: collections ?? [schema],\n    ...(detailPath ? { detailPath } : {}),\n    ...(listPath !== undefined ? { listPath } : {}),\n    isFieldReadOnly: isFieldReadOnly ?? ((field: FieldDef) => field.form?.readOnly ?? false),\n    ...(fieldAccess ? { fieldAccess } : {}),\n    validate,\n    lastError,\n    clearLastError,\n    viewState: () => viewState,\n    setViewState,\n    create,\n    save,\n    remove,\n  }\n}\n\n/**\n * The shared scaffold factory (EC-327) behind the assets/users/redirects rail\n * `CollectionViewSource` hooks: `viewState`/`lastError` state, the\n * `setViewState` updater-fn wrapper, the error-mapped save/remove wiring (via\n * the rail's own result normalizer), and the final assembled source. See the\n * module doc for what stays a per-rail parameter rather than being absorbed\n * here.\n */\nexport function useRailViewSource<TSaveResult, TRemoveResult>(\n  adapter: RailAdapter<TSaveResult, TRemoveResult>,\n): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    validate,\n    create,\n    save: rawSave,\n    remove: rawRemove,\n    normalizeSaveResult,\n    normalizeRemoveResult,\n  } = adapter\n\n  const [viewState, setViewStateRaw] = useState<TableViewState>(() => defaultViewState(schema))\n  const [lastError, setLastError] = useState<OperationError | null>(null)\n\n  const setViewState = useCallback<CollectionViewSource['setViewState']>((update) => {\n    setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update))\n  }, [])\n  const clearLastError = useCallback(() => setLastError(null), [])\n\n  const save = useCallback(createErrorMappedWriter(rawSave, normalizeSaveResult, setLastError), [\n    rawSave,\n    normalizeSaveResult,\n  ])\n  const remove = useCallback(\n    createErrorMappedWriter(rawRemove, normalizeRemoveResult, setLastError),\n    [rawRemove, normalizeRemoveResult],\n  )\n\n  return useMemo(\n    () =>\n      assembleRailViewSource({\n        projectId,\n        schema,\n        capabilities,\n        localeConfig,\n        documents,\n        get,\n        titleOf,\n        referenceCandidates,\n        collections,\n        detailPath,\n        listPath,\n        isFieldReadOnly,\n        fieldAccess,\n        validate,\n        create,\n        lastError,\n        clearLastError,\n        viewState,\n        setViewState,\n        save,\n        remove,\n      }),\n    [\n      projectId,\n      schema,\n      capabilities,\n      localeConfig,\n      documents,\n      get,\n      titleOf,\n      referenceCandidates,\n      collections,\n      detailPath,\n      listPath,\n      isFieldReadOnly,\n      fieldAccess,\n      validate,\n      create,\n      lastError,\n      clearLastError,\n      viewState,\n      setViewState,\n      save,\n      remove,\n    ],\n  )\n}\n"]}

package/dist/components/redirects/redirects-collection-view-source.d.ts

@@ -1,6 +1,14 @@
 import type { CmsDocument, CollectionDef } from '@elytracms/core/cms-core';
 import type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence';
-import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+import type { CollectionViewCapabilities, CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/**
+ * The capability profile of the redirects rail (EC-303): content-gated, create
+ * + remove, no publish/versions/locales — redirects are CONTENT (an editor
+ * owns them), so unlike the users rail this source allows `create`, is NOT
+ * admin-only, and needs no principal field-access policy. Hoisted to a
+ * module-level constant (EC-327), mirroring `ASSET_COLLECTION_CAPABILITIES`.
+ */
+export declare const REDIRECT_COLLECTION_CAPABILITIES: CollectionViewCapabilities;
 /** Project a stored redirect into the lens's `values` shape. */
 export declare function redirectToDocument(entry: RedirectEntry): CmsDocument;
 /** Map an edited lens document back to the redirect write contract. */
@@ -21,5 +29,9 @@ export declare function documentToSaveRedirect(doc: CmsDocument): SaveRedirectIn
  * names+types are contract-locked, so the projection helpers still read the same
  * canonical values; a mount's *additive* fields (Tier 2) round-trip through the
  * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).
+ *
+ * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`
+ * plumbing and the assembled source; this hook supplies only the redirects-store
+ * reads/writes, the capability profile, and the registry-driven `validate`.
  */
 export declare function useRedirectsCollectionViewSource(projectId: string, schema?: CollectionDef): CollectionViewSource;

package/dist/components/redirects/redirects-collection-view-source.js

@@ -1,15 +1,35 @@
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback, useMemo } from 'react';
 import { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core';
 import { studioPath } from '@elytracms/studio/router';
-import { defaultViewState } from '@elytracms/studio/lib/cms-views';
 import { useRedirects } from './redirects-store';
 import { redirectsCollectionDef } from './redirects-schema';
+import { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source';
 /** The redirects rail is not localized — one implicit locale keeps the lens honest. */
 const REDIRECTS_LOCALE = 'en';
 const REDIRECTS_LOCALE_CONFIG = {
     default: REDIRECTS_LOCALE,
     locales: [REDIRECTS_LOCALE],
 };
+/**
+ * The capability profile of the redirects rail (EC-303): content-gated, create
+ * + remove, no publish/versions/locales — redirects are CONTENT (an editor
+ * owns them), so unlike the users rail this source allows `create`, is NOT
+ * admin-only, and needs no principal field-access policy. Hoisted to a
+ * module-level constant (EC-327), mirroring `ASSET_COLLECTION_CAPABILITIES`.
+ */
+export const REDIRECT_COLLECTION_CAPABILITIES = {
+    publish: false,
+    versions: false,
+    locales: false,
+    inlineEdit: false,
+    create: true, // editors create redirects
+    remove: true,
+    bulk: false,
+    liveUrl: false,
+    hierarchy: false,
+    importExport: false,
+    adminOnly: false, // content, not administration
+};
 /**
  * The canonical redirect fields — the storage/delivery contract of the primitive
  * rail. Anything a mount adds via *additive* `nav.redirects({ fields })` (EC-311
@@ -39,11 +59,7 @@ export function documentToSaveRedirect(doc) {
     // additive `nav.redirects({ fields })` override — persist it in the meta bag. The
     // editor holds the complete additive set, so this is the whole bag (replace, not
     // merge). Omit `meta` entirely for the default rail so its saves are unchanged.
-    const meta = {};
-    for (const [key, value] of Object.entries(values)) {
-        if (!CANONICAL_REDIRECT_FIELDS.has(key))
-            meta[key] = value;
-    }
+    const meta = metaBagProjection(values, CANONICAL_REDIRECT_FIELDS);
     return {
         id: doc.id,
         from: typeof values.from === 'string' ? values.from : '',
@@ -69,11 +85,13 @@ export function documentToSaveRedirect(doc) {
  * names+types are contract-locked, so the projection helpers still read the same
  * canonical values; a mount's *additive* fields (Tier 2) round-trip through the
  * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).
+ *
+ * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`
+ * plumbing and the assembled source; this hook supplies only the redirects-store
+ * reads/writes, the capability profile, and the registry-driven `validate`.
  */
 export function useRedirectsCollectionViewSource(projectId, schema = redirectsCollectionDef) {
     const store = useRedirects();
-    const [viewState, setViewStateRaw] = useState(() => defaultViewState(schema));
-    const [lastError, setLastError] = useState(null);
     // EC-311: run the (possibly customized) schema's validation — required/pattern and
     // custom `validate` fns on an overridden field must actually fire in the editor.
     const registry = useMemo(() => createCollectionRegistry([schema]), [schema]);
@@ -83,75 +101,29 @@ export function useRedirectsCollectionViewSource(projectId, schema = redirectsCo
         return record ? redirectToDocument(record) : undefined;
     }, [store]);
     const titleOf = useCallback((ref) => store.get(ref.id)?.from || '(new redirect)', [store]);
-    const setViewState = useCallback((update) => {
-        setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update));
-    }, []);
+    const validate = useCallback((doc) => validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }), [registry]);
     const create = useCallback(() => ({ collection: redirectsCollectionDef.id, id: store.createDraft() }), [store]);
-    const save = useCallback((doc) => {
-        void store.save(documentToSaveRedirect(doc)).then((result) => {
-            if (!result.ok)
-                setLastError({ code: 'unknown', message: result.message });
-        });
-    }, [store]);
-    const remove = useCallback((ref) => {
-        void store.remove(ref.id).then((result) => {
-            if (!result.ok)
-                setLastError({ code: 'unknown', message: result.message });
-        });
-    }, [store]);
-    return useMemo(() => {
-        const capabilities = {
-            publish: false,
-            versions: false,
-            locales: false,
-            inlineEdit: false,
-            create: true, // editors create redirects
-            remove: true,
-            bulk: false,
-            liveUrl: false,
-            hierarchy: false,
-            importExport: false,
-            adminOnly: false, // content, not administration
-        };
-        const source = {
-            collectionId: schema.id,
-            schema,
-            capabilities,
-            projectId,
-            localeConfig: REDIRECTS_LOCALE_CONFIG,
-            activeLocale: REDIRECTS_LOCALE,
-            documents,
-            get,
-            titleOf,
-            // Redirects carry no relation/asset fields, so nothing cross-collection to resolve.
-            referenceCandidates: () => [],
-            collections: [schema],
-            detailPath: (id) => studioPath.redirect(id),
-            listPath: studioPath.redirects(),
-            isFieldReadOnly: (field) => field.form?.readOnly ?? false,
-            validate: (doc) => validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }),
-            lastError,
-            clearLastError: () => setLastError(null),
-            viewState: () => viewState,
-            setViewState,
-            create,
-            save,
-            remove,
-        };
-        return source;
-    }, [
+    const save = useCallback((doc) => store.save(documentToSaveRedirect(doc)), [store]);
+    const remove = useCallback((ref) => store.remove(ref.id), [store]);
+    return useRailViewSource({
         projectId,
         schema,
-        registry,
+        capabilities: REDIRECT_COLLECTION_CAPABILITIES,
+        localeConfig: REDIRECTS_LOCALE_CONFIG,
         documents,
         get,
         titleOf,
-        setViewState,
+        // No `referenceCandidates`/`collections` override: redirects carry no
+        // relation/asset fields, so nothing cross-collection to resolve (the
+        // factory's `() => []` / `[schema]` defaults apply).
+        detailPath: (id) => studioPath.redirect(id),
+        listPath: studioPath.redirects(),
+        validate,
         create,
         save,
         remove,
-        viewState,
-        lastError,
-    ]);
+        normalizeSaveResult: normalizeOkResult,
+        normalizeRemoveResult: normalizeOkResult,
+    });
 }
 //# sourceMappingURL=redirects-collection-view-source.js.map

package/dist/components/redirects/redirects-collection-view-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirects-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-collection-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentRef,\n  FieldDef,\n  Locale,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport type { OperationError } from '@elytracms/core/operations'\nimport { studioPath } from '@elytracms/studio/router'\nimport { defaultViewState } from '@elytracms/studio/lib/cms-views'\nimport type { TableViewState } from '@elytracms/studio/lib/cms-views'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useRedirects } from './redirects-store'\nimport { redirectsCollectionDef } from './redirects-schema'\n\n/** The redirects rail is not localized — one implicit locale keeps the lens honest. */\nconst REDIRECTS_LOCALE: Locale = 'en'\nconst REDIRECTS_LOCALE_CONFIG: LocaleConfig = {\n  default: REDIRECTS_LOCALE,\n  locales: [REDIRECTS_LOCALE],\n}\n\n/**\n * The canonical redirect fields — the storage/delivery contract of the primitive\n * rail. Anything a mount adds via *additive* `nav.redirects({ fields })` (EC-311\n * Tier 2) is by definition NOT one of these, so its value round-trips through the\n * record's open `meta` bag. Derived from the built-in def so the two never drift.\n */\nconst CANONICAL_REDIRECT_FIELDS = new Set(redirectsCollectionDef.fields.map((f) => f.name))\n\n/** Project a stored redirect into the lens's `values` shape. */\nexport function redirectToDocument(entry: RedirectEntry): CmsDocument {\n  return {\n    collection: redirectsCollectionDef.id,\n    id: entry.id,\n    values: {\n      from: entry.from,\n      to: entry.to,\n      permanent: entry.permanent,\n      enabled: entry.enabled,\n      // EC-311 Tier 2: additive schema fields round-trip through the open meta bag.\n      ...(entry.meta ?? {}),\n    },\n  }\n}\n\n/** Map an edited lens document back to the redirect write contract. */\nexport function documentToSaveRedirect(doc: CmsDocument): SaveRedirectInput {\n  const values = doc.values ?? {}\n  // EC-311 Tier 2: any value keyed outside the canonical set comes from a mount's\n  // additive `nav.redirects({ fields })` override — persist it in the meta bag. The\n  // editor holds the complete additive set, so this is the whole bag (replace, not\n  // merge). Omit `meta` entirely for the default rail so its saves are unchanged.\n  const meta: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(values)) {\n    if (!CANONICAL_REDIRECT_FIELDS.has(key)) meta[key] = value\n  }\n  return {\n    id: doc.id,\n    from: typeof values.from === 'string' ? values.from : '',\n    to: typeof values.to === 'string' ? values.to : '',\n    permanent: typeof values.permanent === 'boolean' ? values.permanent : true,\n    enabled: typeof values.enabled === 'boolean' ? values.enabled : true,\n    ...(Object.keys(meta).length > 0 ? { meta } : {}),\n  }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **redirects rail** (EC-303) —\n * the portable list/edit surfaces over the editorial redirects store instead of\n * the CMS store. Redirects are CONTENT (an editor owns them), so unlike the users\n * rail this source allows `create`, is NOT admin-only, and needs no principal\n * field-access policy. No publish/versions/locales/inline/bulk/import — a redirect\n * is a small record saved explicitly (a saved+enabled one is live).\n *\n * Must be mounted under a `RedirectsProvider` (for {@link useRedirects}).\n *\n * `schema` defaults to the engine-owned {@link redirectsCollectionDef}; a mount may\n * pass a customized def (EC-311 — built-in fields overridden by equal name via\n * `nav.redirects({ fields })`). The canonical `from`/`to`/`permanent`/`enabled`\n * names+types are contract-locked, so the projection helpers still read the same\n * canonical values; a mount's *additive* fields (Tier 2) round-trip through the\n * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).\n */\nexport function useRedirectsCollectionViewSource(\n  projectId: string,\n  schema: CollectionDef = redirectsCollectionDef,\n): CollectionViewSource {\n  const store = useRedirects()\n  const [viewState, setViewStateRaw] = useState<TableViewState>(() => defaultViewState(schema))\n  const [lastError, setLastError] = useState<OperationError | null>(null)\n  // EC-311: run the (possibly customized) schema's validation — required/pattern and\n  // custom `validate` fns on an overridden field must actually fire in the editor.\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n\n  const documents = useCallback(\n    () => store.redirects.map(redirectToDocument),\n    [store.redirects],\n  )\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.get(ref.id)\n      return record ? redirectToDocument(record) : undefined\n    },\n    [store],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => store.get(ref.id)?.from || '(new redirect)',\n    [store],\n  )\n  const setViewState = useCallback<CollectionViewSource['setViewState']>((update) => {\n    setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update))\n  }, [])\n\n  const create = useCallback(\n    (): DocumentRef => ({ collection: redirectsCollectionDef.id, id: store.createDraft() }),\n    [store],\n  )\n  const save = useCallback(\n    (doc: CmsDocument) => {\n      void store.save(documentToSaveRedirect(doc)).then((result) => {\n        if (!result.ok) setLastError({ code: 'unknown', message: result.message })\n      })\n    },\n    [store],\n  )\n  const remove = useCallback(\n    (ref: DocumentRef) => {\n      void store.remove(ref.id).then((result) => {\n        if (!result.ok) setLastError({ code: 'unknown', message: result.message })\n      })\n    },\n    [store],\n  )\n\n  return useMemo(() => {\n    const capabilities: CollectionViewCapabilities = {\n      publish: false,\n      versions: false,\n      locales: false,\n      inlineEdit: false,\n      create: true, // editors create redirects\n      remove: true,\n      bulk: false,\n      liveUrl: false,\n      hierarchy: false,\n      importExport: false,\n      adminOnly: false, // content, not administration\n    }\n    const source: CollectionViewSource = {\n      collectionId: schema.id,\n      schema,\n      capabilities,\n      projectId,\n      localeConfig: REDIRECTS_LOCALE_CONFIG,\n      activeLocale: REDIRECTS_LOCALE,\n      documents,\n      get,\n      titleOf,\n      // Redirects carry no relation/asset fields, so nothing cross-collection to resolve.\n      referenceCandidates: () => [],\n      collections: [schema],\n      detailPath: (id: string) => studioPath.redirect(id),\n      listPath: studioPath.redirects(),\n      isFieldReadOnly: (field: FieldDef) => field.form?.readOnly ?? false,\n      validate: (doc: CmsDocument) =>\n        validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }),\n      lastError,\n      clearLastError: () => setLastError(null),\n      viewState: () => viewState,\n      setViewState,\n      create,\n      save,\n      remove,\n    }\n    return source\n  }, [\n    projectId,\n    schema,\n    registry,\n    documents,\n    get,\n    titleOf,\n    setViewState,\n    create,\n    save,\n    remove,\n    viewState,\n    lastError,\n  ])\n}\n"]}
+{"version":3,"file":"redirects-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-collection-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo } from 'react'\nimport type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig } from '@elytracms/core/cms-core'\nimport { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { studioPath } from '@elytracms/studio/router'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useRedirects } from './redirects-store'\nimport { redirectsCollectionDef } from './redirects-schema'\nimport { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source'\n\n/** The redirects rail is not localized — one implicit locale keeps the lens honest. */\nconst REDIRECTS_LOCALE: Locale = 'en'\nconst REDIRECTS_LOCALE_CONFIG: LocaleConfig = {\n  default: REDIRECTS_LOCALE,\n  locales: [REDIRECTS_LOCALE],\n}\n\n/**\n * The capability profile of the redirects rail (EC-303): content-gated, create\n * + remove, no publish/versions/locales — redirects are CONTENT (an editor\n * owns them), so unlike the users rail this source allows `create`, is NOT\n * admin-only, and needs no principal field-access policy. Hoisted to a\n * module-level constant (EC-327), mirroring `ASSET_COLLECTION_CAPABILITIES`.\n */\nexport const REDIRECT_COLLECTION_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: true, // editors create redirects\n  remove: true,\n  bulk: false,\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false,\n  adminOnly: false, // content, not administration\n}\n\n/**\n * The canonical redirect fields — the storage/delivery contract of the primitive\n * rail. Anything a mount adds via *additive* `nav.redirects({ fields })` (EC-311\n * Tier 2) is by definition NOT one of these, so its value round-trips through the\n * record's open `meta` bag. Derived from the built-in def so the two never drift.\n */\nconst CANONICAL_REDIRECT_FIELDS = new Set(redirectsCollectionDef.fields.map((f) => f.name))\n\n/** Project a stored redirect into the lens's `values` shape. */\nexport function redirectToDocument(entry: RedirectEntry): CmsDocument {\n  return {\n    collection: redirectsCollectionDef.id,\n    id: entry.id,\n    values: {\n      from: entry.from,\n      to: entry.to,\n      permanent: entry.permanent,\n      enabled: entry.enabled,\n      // EC-311 Tier 2: additive schema fields round-trip through the open meta bag.\n      ...(entry.meta ?? {}),\n    },\n  }\n}\n\n/** Map an edited lens document back to the redirect write contract. */\nexport function documentToSaveRedirect(doc: CmsDocument): SaveRedirectInput {\n  const values = doc.values ?? {}\n  // EC-311 Tier 2: any value keyed outside the canonical set comes from a mount's\n  // additive `nav.redirects({ fields })` override — persist it in the meta bag. The\n  // editor holds the complete additive set, so this is the whole bag (replace, not\n  // merge). Omit `meta` entirely for the default rail so its saves are unchanged.\n  const meta = metaBagProjection(values, CANONICAL_REDIRECT_FIELDS)\n  return {\n    id: doc.id,\n    from: typeof values.from === 'string' ? values.from : '',\n    to: typeof values.to === 'string' ? values.to : '',\n    permanent: typeof values.permanent === 'boolean' ? values.permanent : true,\n    enabled: typeof values.enabled === 'boolean' ? values.enabled : true,\n    ...(Object.keys(meta).length > 0 ? { meta } : {}),\n  }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **redirects rail** (EC-303) —\n * the portable list/edit surfaces over the editorial redirects store instead of\n * the CMS store. Redirects are CONTENT (an editor owns them), so unlike the users\n * rail this source allows `create`, is NOT admin-only, and needs no principal\n * field-access policy. No publish/versions/locales/inline/bulk/import — a redirect\n * is a small record saved explicitly (a saved+enabled one is live).\n *\n * Must be mounted under a `RedirectsProvider` (for {@link useRedirects}).\n *\n * `schema` defaults to the engine-owned {@link redirectsCollectionDef}; a mount may\n * pass a customized def (EC-311 — built-in fields overridden by equal name via\n * `nav.redirects({ fields })`). The canonical `from`/`to`/`permanent`/`enabled`\n * names+types are contract-locked, so the projection helpers still read the same\n * canonical values; a mount's *additive* fields (Tier 2) round-trip through the\n * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).\n *\n * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`\n * plumbing and the assembled source; this hook supplies only the redirects-store\n * reads/writes, the capability profile, and the registry-driven `validate`.\n */\nexport function useRedirectsCollectionViewSource(\n  projectId: string,\n  schema: CollectionDef = redirectsCollectionDef,\n): CollectionViewSource {\n  const store = useRedirects()\n  // EC-311: run the (possibly customized) schema's validation — required/pattern and\n  // custom `validate` fns on an overridden field must actually fire in the editor.\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n\n  const documents = useCallback(() => store.redirects.map(redirectToDocument), [store.redirects])\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.get(ref.id)\n      return record ? redirectToDocument(record) : undefined\n    },\n    [store],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => store.get(ref.id)?.from || '(new redirect)',\n    [store],\n  )\n  const validate = useCallback(\n    (doc: CmsDocument) => validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }),\n    [registry],\n  )\n  const create = useCallback(\n    (): DocumentRef => ({ collection: redirectsCollectionDef.id, id: store.createDraft() }),\n    [store],\n  )\n  const save = useCallback((doc: CmsDocument) => store.save(documentToSaveRedirect(doc)), [store])\n  const remove = useCallback((ref: DocumentRef) => store.remove(ref.id), [store])\n\n  return useRailViewSource({\n    projectId,\n    schema,\n    capabilities: REDIRECT_COLLECTION_CAPABILITIES,\n    localeConfig: REDIRECTS_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    // No `referenceCandidates`/`collections` override: redirects carry no\n    // relation/asset fields, so nothing cross-collection to resolve (the\n    // factory's `() => []` / `[schema]` defaults apply).\n    detailPath: (id: string) => studioPath.redirect(id),\n    listPath: studioPath.redirects(),\n    validate,\n    create,\n    save,\n    remove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeOkResult,\n  })\n}\n"]}

package/dist/components/redirects/redirects-store.d.ts

@@ -39,8 +39,9 @@ export interface RedirectsStore {
     /** Re-list from the backend. */
     refresh(): Promise<void>;
 }
+declare const useRedirects: () => RedirectsStore;
 export declare function RedirectsProvider({ projectId, children, }: {
     projectId: string;
     children: ReactNode;
 }): import("react").JSX.Element;
-export declare function useRedirects(): RedirectsStore;
+export { useRedirects };

package/dist/components/redirects/redirects-store.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 import { getStudioOperations } from '@elytracms/studio/lib/operations';
 import { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query';
-const RedirectsContext = createContext(null);
+import { createRequiredContext } from '@elytracms/studio/lib/required-context';
+const { Context: RedirectsContext, useRequired: useRedirects } = createRequiredContext('Redirects');
 const EMPTY_REDIRECTS = [];
 let draftCounter = 0;
 /** A collision-resistant client id for a new redirect (used as its real id on save). */
@@ -114,10 +115,5 @@ export function RedirectsProvider({ projectId, children, }) {
     }), [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh]);
     return _jsx(RedirectsContext.Provider, { value: store, children: children });
 }
-export function useRedirects() {
-    const store = useContext(RedirectsContext);
-    if (!store)
-        throw new Error('useRedirects must be used within a <RedirectsProvider>.');
-    return store;
-}
+export { useRedirects };
 //# sourceMappingURL=redirects-store.js.map

package/dist/components/redirects/redirects-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\n\n/**\n * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302\n * forwards — read + written through the shared operations client (`redirects.*`),\n * the same seam the users/assets stores use. Content-gated (a viewer reads, an\n * editor writes); no draft/published split — a saved+enabled redirect is live.\n *\n * The \"New\" flow keeps an unsaved redirect as a LOCAL draft (memory only) until\n * the first explicit save persists it — so an abandoned \"New\" never writes a stub\n * to the backend and never shows in the list. Drafts are reachable via {@link\n * RedirectsStore.get} (the detail editor loads one), never listed.\n */\n\nexport interface RedirectsStore {\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */\n  redirects: readonly RedirectEntry[]\n  /** One redirect: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RedirectEntry | undefined\n  /** Mint a blank in-memory draft and return its id (the \"New\" navigation target). */\n  createDraft(): string\n  /** Persist a create/modify; drops the matching draft on success. */\n  save(\n    input: SaveRedirectInput,\n  ): Promise<{ ok: true; redirect: RedirectEntry } | { ok: false; message: string }>\n  /** Delete a persisted redirect, or silently discard an unsaved draft. */\n  remove(id: string): Promise<{ ok: true } | { ok: false; message: string }>\n  /** Re-list from the backend. */\n  refresh(): Promise<void>\n}\n\nconst RedirectsContext = createContext<RedirectsStore | null>(null)\n\nconst EMPTY_REDIRECTS: readonly RedirectEntry[] = []\n\nlet draftCounter = 0\n/** A collision-resistant client id for a new redirect (used as its real id on save). */\nfunction newDraftId(): string {\n  draftCounter += 1\n  return `redirect_${Date.now().toString(36)}_${draftCounter}`\n}\n\nfunction redirectsQueryKey(projectId: string): readonly [string, string] {\n  return ['redirects', projectId]\n}\n\nasync function loadRedirects(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<RedirectEntry[]> {\n  const result = await operations.redirects.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\nfunction byFrom(a: RedirectEntry, b: RedirectEntry): number {\n  return a.from < b.from ? -1 : a.from > b.from ? 1 : 0\n}\n\nexport function RedirectsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useOperationQuery<RedirectEntry[]>({\n    queryKey: redirectsQueryKey(projectId),\n    loader: (operations) => loadRedirects(operations, projectId),\n  })\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const persisted = query.data ?? EMPTY_REDIRECTS\n  const { status, errorMessage } = listStoreState(query)\n\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RedirectEntry>>({})\n\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback<RedirectsStore['get']>(\n    (id) => drafts[id] ?? persisted.find((r) => r.id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback<RedirectsStore['createDraft']>(() => {\n    const id = newDraftId()\n    const now = new Date().toISOString()\n    const draft: RedirectEntry = {\n      id,\n      projectId,\n      from: '',\n      to: '',\n      permanent: true,\n      // New redirects default to enabled — the reason you create one is for it to\n      // work; `enabled` is really the switch for *pausing* an existing redirect. A\n      // half-filled draft can't go live anyway (save requires from/to).\n      enabled: true,\n      createdAt: now,\n      updatedAt: now,\n    }\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [projectId])\n\n  const save = useCallback<RedirectsStore['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.save({\n        projectId,\n        ...(input.id !== undefined ? { id: input.id } : {}),\n        from: input.from,\n        to: input.to,\n        ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),\n        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),\n        ...(input.meta !== undefined ? { meta: input.meta } : {}),\n      })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) => {\n        const rest = (prev ?? []).filter((r) => r.id !== saved.id)\n        return [...rest, saved].sort(byFrom)\n      })\n      // The record is now persisted — drop any matching draft.\n      setDrafts((prev) => {\n        if (!(saved.id in prev)) return prev\n        const next = { ...prev }\n        delete next[saved.id]\n        return next\n      })\n      return { ok: true, redirect: saved }\n    },\n    [projectId, cache],\n  )\n\n  const remove = useCallback<RedirectsStore['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (drafts[id]) {\n        setDrafts((prev) => {\n          const next = { ...prev }\n          delete next[id]\n          return next\n        })\n        return { ok: true }\n      }\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) =>\n        (prev ?? []).filter((r) => r.id !== id),\n      )\n      return { ok: true }\n    },\n    [projectId, cache, drafts],\n  )\n\n  const store = useMemo<RedirectsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      redirects: persisted,\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RedirectsContext.Provider value={store}>{children}</RedirectsContext.Provider>\n}\n\nexport function useRedirects(): RedirectsStore {\n  const store = useContext(RedirectsContext)\n  if (!store) throw new Error('useRedirects must be used within a <RedirectsProvider>.')\n  return store\n}\n"]}
+{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\n/**\n * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302\n * forwards — read + written through the shared operations client (`redirects.*`),\n * the same seam the users/assets stores use. Content-gated (a viewer reads, an\n * editor writes); no draft/published split — a saved+enabled redirect is live.\n *\n * The \"New\" flow keeps an unsaved redirect as a LOCAL draft (memory only) until\n * the first explicit save persists it — so an abandoned \"New\" never writes a stub\n * to the backend and never shows in the list. Drafts are reachable via {@link\n * RedirectsStore.get} (the detail editor loads one), never listed.\n */\n\nexport interface RedirectsStore {\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */\n  redirects: readonly RedirectEntry[]\n  /** One redirect: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RedirectEntry | undefined\n  /** Mint a blank in-memory draft and return its id (the \"New\" navigation target). */\n  createDraft(): string\n  /** Persist a create/modify; drops the matching draft on success. */\n  save(\n    input: SaveRedirectInput,\n  ): Promise<{ ok: true; redirect: RedirectEntry } | { ok: false; message: string }>\n  /** Delete a persisted redirect, or silently discard an unsaved draft. */\n  remove(id: string): Promise<{ ok: true } | { ok: false; message: string }>\n  /** Re-list from the backend. */\n  refresh(): Promise<void>\n}\n\nconst { Context: RedirectsContext, useRequired: useRedirects } =\n  createRequiredContext<RedirectsStore>('Redirects')\n\nconst EMPTY_REDIRECTS: readonly RedirectEntry[] = []\n\nlet draftCounter = 0\n/** A collision-resistant client id for a new redirect (used as its real id on save). */\nfunction newDraftId(): string {\n  draftCounter += 1\n  return `redirect_${Date.now().toString(36)}_${draftCounter}`\n}\n\nfunction redirectsQueryKey(projectId: string): readonly [string, string] {\n  return ['redirects', projectId]\n}\n\nasync function loadRedirects(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<RedirectEntry[]> {\n  const result = await operations.redirects.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\nfunction byFrom(a: RedirectEntry, b: RedirectEntry): number {\n  return a.from < b.from ? -1 : a.from > b.from ? 1 : 0\n}\n\nexport function RedirectsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useOperationQuery<RedirectEntry[]>({\n    queryKey: redirectsQueryKey(projectId),\n    loader: (operations) => loadRedirects(operations, projectId),\n  })\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const persisted = query.data ?? EMPTY_REDIRECTS\n  const { status, errorMessage } = listStoreState(query)\n\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RedirectEntry>>({})\n\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback<RedirectsStore['get']>(\n    (id) => drafts[id] ?? persisted.find((r) => r.id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback<RedirectsStore['createDraft']>(() => {\n    const id = newDraftId()\n    const now = new Date().toISOString()\n    const draft: RedirectEntry = {\n      id,\n      projectId,\n      from: '',\n      to: '',\n      permanent: true,\n      // New redirects default to enabled — the reason you create one is for it to\n      // work; `enabled` is really the switch for *pausing* an existing redirect. A\n      // half-filled draft can't go live anyway (save requires from/to).\n      enabled: true,\n      createdAt: now,\n      updatedAt: now,\n    }\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [projectId])\n\n  const save = useCallback<RedirectsStore['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.save({\n        projectId,\n        ...(input.id !== undefined ? { id: input.id } : {}),\n        from: input.from,\n        to: input.to,\n        ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),\n        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),\n        ...(input.meta !== undefined ? { meta: input.meta } : {}),\n      })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) => {\n        const rest = (prev ?? []).filter((r) => r.id !== saved.id)\n        return [...rest, saved].sort(byFrom)\n      })\n      // The record is now persisted — drop any matching draft.\n      setDrafts((prev) => {\n        if (!(saved.id in prev)) return prev\n        const next = { ...prev }\n        delete next[saved.id]\n        return next\n      })\n      return { ok: true, redirect: saved }\n    },\n    [projectId, cache],\n  )\n\n  const remove = useCallback<RedirectsStore['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (drafts[id]) {\n        setDrafts((prev) => {\n          const next = { ...prev }\n          delete next[id]\n          return next\n        })\n        return { ok: true }\n      }\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) =>\n        (prev ?? []).filter((r) => r.id !== id),\n      )\n      return { ok: true }\n    },\n    [projectId, cache, drafts],\n  )\n\n  const store = useMemo<RedirectsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      redirects: persisted,\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RedirectsContext.Provider value={store}>{children}</RedirectsContext.Provider>\n}\n\nexport { useRedirects }\n"]}

package/dist/components/section-state.d.ts

@@ -16,7 +16,16 @@ export interface SectionStateViewProps {
 }
 /** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */
 export declare function SectionStateView({ state, title, description, action, className, }: SectionStateViewProps): import("react").JSX.Element;
-/** Shimmer skeleton standing in for an in-flight section load. */
-export declare function SectionSkeleton({ className }: {
+export interface SectionSkeletonProps {
     className?: string;
-}): import("react").JSX.Element;
+    /**
+     * Section-specific loading heading (e.g. "Loading assets…", EC-327). Renders
+     * as real text instead of the generic shimmer bar; omitted keeps the bare
+     * shimmer (the pre-EC-327 look, still used by callers with no rail-specific
+     * copy to show).
+     */
+    label?: string;
+    description?: ReactNode;
+}
+/** Shimmer skeleton standing in for an in-flight section load. */
+export declare function SectionSkeleton({ className, label, description }: SectionSkeletonProps): import("react").JSX.Element;

package/dist/components/section-state.js

@@ -28,8 +28,12 @@ const PRESETS = {
 };
 /** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */
 export function SectionStateView({ state, title, description, action, className, }) {
-    if (state === 'loading')
-        return _jsx(SectionSkeleton, { className: className });
+    // `title`/`description` thread through to the skeleton's optional label slot
+    // (EC-327) — without this, a caller's section-specific loading copy (e.g. "Loading
+    // assets…") would be silently dropped the moment `state` was 'loading'.
+    if (state === 'loading') {
+        return _jsx(SectionSkeleton, { className: className, label: title, description: description });
+    }
     const preset = PRESETS[state];
     const Icon = preset.icon;
     // `state` is narrowed to a non-loading state here, so each has a title/description/badge key.
@@ -44,7 +48,7 @@ export function SectionStateView({ state, title, description, action, className,
     return (_jsx("div", { "data-section-state": state, className: cn('grid min-h-[18rem] place-items-center p-8', className), children: _jsxs(Stack, { gap: "3", align: "center", className: cn('max-w-sm rounded-xl border border-dashed px-8 py-10 text-center', tone), children: [_jsx("span", { className: "grid size-11 place-items-center rounded-lg border border-border bg-background text-muted-foreground", children: _jsx(Icon, { className: "size-5" }) }), _jsxs(Stack, { gap: "1", align: "center", children: [_jsx(Heading, { level: 2, size: "h3", children: title ?? presetTitle }), _jsx(Text, { size: "sm", tone: "muted", children: description ?? presetDescription })] }), _jsx(Badge, { variant: preset.badgeVariant, children: badgeLabel }), action ? _jsx("div", { className: "pt-1", children: action }) : null] }) }));
 }
 /** Shimmer skeleton standing in for an in-flight section load. */
-export function SectionSkeleton({ className }) {
-    return (_jsxs("div", { "data-section-state": "loading", className: cn('space-y-4 p-6', className), "aria-busy": true, children: [_jsx("div", { className: "h-7 w-48 animate-pulse rounded-md bg-muted" }), _jsx("div", { className: "grid gap-3 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsx("div", { className: "h-28 animate-pulse rounded-xl bg-muted/70" }, i))) })] }));
+export function SectionSkeleton({ className, label, description }) {
+    return (_jsxs("div", { "data-section-state": "loading", className: cn('space-y-4 p-6', className), "aria-busy": true, children: [label ? (_jsxs(Stack, { gap: "1", children: [_jsx(Text, { weight: "medium", children: label }), description ? (_jsx(Text, { size: "sm", tone: "muted", children: description })) : null] })) : (_jsx("div", { className: "h-7 w-48 animate-pulse rounded-md bg-muted" })), _jsx("div", { className: "grid gap-3 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsx("div", { className: "h-28 animate-pulse rounded-xl bg-muted/70" }, i))) })] }));
 }
 //# sourceMappingURL=section-state.js.map

package/dist/components/section-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-state.js","sourceRoot":"","sources":["../../src/components/section-state.tsx"],"names":[],"mappings":"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","sourcesContent":["import { CircleAlert, Clock, Inbox, Loader2, Lock, type LucideIcon } from 'lucide-react'\nimport type { ReactNode } from 'react'\nimport type { SectionAvailability, SectionState } from '@elytracms/core/studio-core'\nimport { Badge, Heading, Stack, Text } from '@elytracms/studio/ui'\nimport { cn } from '@elytracms/studio/lib/utils'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Resolve the runtime state of a section (brief §8.1, §11). A `forced` value\n * (e.g. from a `?state=` param) wins, making every state reachable\n * deterministically; otherwise availability decides.\n */\nexport function resolveSectionState(\n  availability: SectionAvailability,\n  forced?: SectionState | null,\n): SectionState {\n  if (forced) return forced\n  if (availability === 'planned') return 'planned'\n  if (availability === 'unavailable') return 'unavailable'\n  return 'working'\n}\n\ninterface StatePreset {\n  icon: LucideIcon\n  badgeVariant: 'outline' | 'warning' | 'error' | 'info'\n  spin?: boolean\n}\n\n// Structural (icon/variant) only; the title/description/badge copy is resolved at\n// the render site via `translate` so it reflects the active UI locale (EC-241).\nconst PRESETS: Record<Exclude<SectionState, 'working'>, StatePreset> = {\n  empty: { icon: Inbox, badgeVariant: 'outline' },\n  loading: { icon: Loader2, badgeVariant: 'info', spin: true },\n  error: { icon: CircleAlert, badgeVariant: 'error' },\n  unavailable: { icon: Lock, badgeVariant: 'outline' },\n  planned: { icon: Clock, badgeVariant: 'warning' },\n}\n\nexport interface SectionStateViewProps {\n  state: Exclude<SectionState, 'working'>\n  /** Section-specific heading, e.g. \"CMS\" — overrides the generic preset title. */\n  title?: string\n  description?: ReactNode\n  action?: ReactNode\n  className?: string\n}\n\n/** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */\nexport function SectionStateView({\n  state,\n  title,\n  description,\n  action,\n  className,\n}: SectionStateViewProps) {\n  if (state === 'loading') return <SectionSkeleton className={className} />\n\n  const preset = PRESETS[state]\n  const Icon = preset.icon\n  // `state` is narrowed to a non-loading state here, so each has a title/description/badge key.\n  const presetTitle = translate(`shell.sectionState.${state}.title`)\n  const presetDescription = translate(`shell.sectionState.${state}.description`)\n  const badgeLabel = translate(`shell.sectionState.badge.${state}`)\n  const tone =\n    state === 'error'\n      ? 'border-destructive/30 bg-destructive/5'\n      : state === 'planned'\n        ? 'border-warning/30 bg-warning/5'\n        : 'border-border bg-card/40'\n\n  return (\n    <div\n      data-section-state={state}\n      className={cn('grid min-h-[18rem] place-items-center p-8', className)}\n    >\n      <Stack\n        gap=\"3\"\n        align=\"center\"\n        className={cn('max-w-sm rounded-xl border border-dashed px-8 py-10 text-center', tone)}\n      >\n        <span className=\"grid size-11 place-items-center rounded-lg border border-border bg-background text-muted-foreground\">\n          <Icon className=\"size-5\" />\n        </span>\n        <Stack gap=\"1\" align=\"center\">\n          <Heading level={2} size=\"h3\">\n            {title ?? presetTitle}\n          </Heading>\n          <Text size=\"sm\" tone=\"muted\">\n            {description ?? presetDescription}\n          </Text>\n        </Stack>\n        <Badge variant={preset.badgeVariant}>{badgeLabel}</Badge>\n        {action ? <div className=\"pt-1\">{action}</div> : null}\n      </Stack>\n    </div>\n  )\n}\n\n/** Shimmer skeleton standing in for an in-flight section load. */\nexport function SectionSkeleton({ className }: { className?: string }) {\n  return (\n    <div data-section-state=\"loading\" className={cn('space-y-4 p-6', className)} aria-busy>\n      <div className=\"h-7 w-48 animate-pulse rounded-md bg-muted\" />\n      <div className=\"grid gap-3 sm:grid-cols-2 lg:grid-cols-3\">\n        {Array.from({ length: 6 }).map((_, i) => (\n          <div key={i} className=\"h-28 animate-pulse rounded-xl bg-muted/70\" />\n        ))}\n      </div>\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"section-state.js","sourceRoot":"","sources":["../../src/components/section-state.tsx"],"names":[],"mappings":"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","sourcesContent":["import { CircleAlert, Clock, Inbox, Loader2, Lock, type LucideIcon } from 'lucide-react'\nimport type { ReactNode } from 'react'\nimport type { SectionAvailability, SectionState } from '@elytracms/core/studio-core'\nimport { Badge, Heading, Stack, Text } from '@elytracms/studio/ui'\nimport { cn } from '@elytracms/studio/lib/utils'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Resolve the runtime state of a section (brief §8.1, §11). A `forced` value\n * (e.g. from a `?state=` param) wins, making every state reachable\n * deterministically; otherwise availability decides.\n */\nexport function resolveSectionState(\n  availability: SectionAvailability,\n  forced?: SectionState | null,\n): SectionState {\n  if (forced) return forced\n  if (availability === 'planned') return 'planned'\n  if (availability === 'unavailable') return 'unavailable'\n  return 'working'\n}\n\ninterface StatePreset {\n  icon: LucideIcon\n  badgeVariant: 'outline' | 'warning' | 'error' | 'info'\n  spin?: boolean\n}\n\n// Structural (icon/variant) only; the title/description/badge copy is resolved at\n// the render site via `translate` so it reflects the active UI locale (EC-241).\nconst PRESETS: Record<Exclude<SectionState, 'working'>, StatePreset> = {\n  empty: { icon: Inbox, badgeVariant: 'outline' },\n  loading: { icon: Loader2, badgeVariant: 'info', spin: true },\n  error: { icon: CircleAlert, badgeVariant: 'error' },\n  unavailable: { icon: Lock, badgeVariant: 'outline' },\n  planned: { icon: Clock, badgeVariant: 'warning' },\n}\n\nexport interface SectionStateViewProps {\n  state: Exclude<SectionState, 'working'>\n  /** Section-specific heading, e.g. \"CMS\" — overrides the generic preset title. */\n  title?: string\n  description?: ReactNode\n  action?: ReactNode\n  className?: string\n}\n\n/** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */\nexport function SectionStateView({\n  state,\n  title,\n  description,\n  action,\n  className,\n}: SectionStateViewProps) {\n  // `title`/`description` thread through to the skeleton's optional label slot\n  // (EC-327) — without this, a caller's section-specific loading copy (e.g. \"Loading\n  // assets…\") would be silently dropped the moment `state` was 'loading'.\n  if (state === 'loading') {\n    return <SectionSkeleton className={className} label={title} description={description} />\n  }\n\n  const preset = PRESETS[state]\n  const Icon = preset.icon\n  // `state` is narrowed to a non-loading state here, so each has a title/description/badge key.\n  const presetTitle = translate(`shell.sectionState.${state}.title`)\n  const presetDescription = translate(`shell.sectionState.${state}.description`)\n  const badgeLabel = translate(`shell.sectionState.badge.${state}`)\n  const tone =\n    state === 'error'\n      ? 'border-destructive/30 bg-destructive/5'\n      : state === 'planned'\n        ? 'border-warning/30 bg-warning/5'\n        : 'border-border bg-card/40'\n\n  return (\n    <div\n      data-section-state={state}\n      className={cn('grid min-h-[18rem] place-items-center p-8', className)}\n    >\n      <Stack\n        gap=\"3\"\n        align=\"center\"\n        className={cn('max-w-sm rounded-xl border border-dashed px-8 py-10 text-center', tone)}\n      >\n        <span className=\"grid size-11 place-items-center rounded-lg border border-border bg-background text-muted-foreground\">\n          <Icon className=\"size-5\" />\n        </span>\n        <Stack gap=\"1\" align=\"center\">\n          <Heading level={2} size=\"h3\">\n            {title ?? presetTitle}\n          </Heading>\n          <Text size=\"sm\" tone=\"muted\">\n            {description ?? presetDescription}\n          </Text>\n        </Stack>\n        <Badge variant={preset.badgeVariant}>{badgeLabel}</Badge>\n        {action ? <div className=\"pt-1\">{action}</div> : null}\n      </Stack>\n    </div>\n  )\n}\n\nexport interface SectionSkeletonProps {\n  className?: string\n  /**\n   * Section-specific loading heading (e.g. \"Loading assets…\", EC-327). Renders\n   * as real text instead of the generic shimmer bar; omitted keeps the bare\n   * shimmer (the pre-EC-327 look, still used by callers with no rail-specific\n   * copy to show).\n   */\n  label?: string\n  description?: ReactNode\n}\n\n/** Shimmer skeleton standing in for an in-flight section load. */\nexport function SectionSkeleton({ className, label, description }: SectionSkeletonProps) {\n  return (\n    <div data-section-state=\"loading\" className={cn('space-y-4 p-6', className)} aria-busy>\n      {label ? (\n        <Stack gap=\"1\">\n          <Text weight=\"medium\">{label}</Text>\n          {description ? (\n            <Text size=\"sm\" tone=\"muted\">\n              {description}\n            </Text>\n          ) : null}\n        </Stack>\n      ) : (\n        <div className=\"h-7 w-48 animate-pulse rounded-md bg-muted\" />\n      )}\n      <div className=\"grid gap-3 sm:grid-cols-2 lg:grid-cols-3\">\n        {Array.from({ length: 6 }).map((_, i) => (\n          <div key={i} className=\"h-28 animate-pulse rounded-xl bg-muted/70\" />\n        ))}\n      </div>\n    </div>\n  )\n}\n"]}

package/dist/components/studio-context.d.ts

@@ -16,7 +16,8 @@ export interface StudioStore {
     /** Record a project as active + most-recent (idempotent). */
     activate(id: ProjectId): void;
 }
+declare const useStudio: () => StudioStore;
 export declare function StudioProvider({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
-export declare function useStudio(): StudioStore;
+export { useStudio };