@elytracms/studio 0.0.1

package/dist/lib/dnd/drop-rules.js

@@ -0,0 +1,257 @@
+import { DEFAULT_SLOT, GRID_COMPONENT_ID, OUTLET_SLOT, STACK_COMPONENT_ID, getNode, getParentInfo, gridContainerNode, isDescendantOf, removeNode, updateNode, } from '@elytracms/project-graph';
+function rejected(code, reason) {
+    return { eligible: false, code, reason };
+}
+// ---------------------------------------------------------------------------
+// Slot rules
+// ---------------------------------------------------------------------------
+/**
+ * The slot an `into` drop inserts into: the default `children` slot when
+ * declared, else the first authored slot that is not the layout `outlet`.
+ * Mirrors the shell's insert-context resolution so click-insert and
+ * drag-insert land in the same place.
+ */
+export function primaryInsertSlot(manifest) {
+    if (!manifest)
+        return undefined;
+    return (manifest.slots.find((s) => s.name === DEFAULT_SLOT) ??
+        manifest.slots.find((s) => s.name !== OUTLET_SLOT));
+}
+/** True when a component can receive `into` drops at all (declares an insertable slot). */
+export function canNestInto(getManifest, componentId) {
+    return primaryInsertSlot(getManifest(componentId)) !== undefined;
+}
+/** True when a slot's allow-list (if any) permits the component id. */
+export function slotAllows(slot, componentId) {
+    if (!slot?.allow)
+        return true;
+    return slot.allow.includes(componentId);
+}
+// ---------------------------------------------------------------------------
+// Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a prospective drop into either an executable plan (one `move` or
+ * `insert` builder action → one operations command → one undo step) or a
+ * structured rejection the UI shows *during* the drag. Pure: same inputs,
+ * same answer, on both surfaces.
+ */
+export function resolveDrop(args) {
+    const { root, getManifest, subject, location } = args;
+    if (subject.kind === 'node' && subject.nodeId === root.id) {
+        return rejected('root', 'The page root cannot be moved.');
+    }
+    const reference = getNode(root, location.nodeId);
+    if (!reference) {
+        return rejected('missing-target', `Node "${location.nodeId}" is not on this page.`);
+    }
+    // EC-162: dropping beside the reference wraps both in a two-column Grid.
+    if (location.position === 'left' || location.position === 'right') {
+        return resolveWrap({ root, getManifest, subject, reference, side: location.position });
+    }
+    // Resolve the concrete insertion point: parent node, slot, index.
+    let parentId;
+    let slotRule;
+    let slotName;
+    let index;
+    if (location.position === 'into') {
+        const manifest = getManifest(reference.componentId);
+        const slot = primaryInsertSlot(manifest);
+        if (!slot) {
+            return rejected('no-slot', `"${reference.componentId}" does not accept children.`);
+        }
+        parentId = reference.id;
+        slotRule = slot;
+        slotName = slot.name;
+        index = (reference.slots?.[slot.name] ?? []).length;
+    }
+    else {
+        const info = getParentInfo(root, reference.id);
+        if (!info) {
+            return rejected('root', 'Nothing can be dropped beside the page root.');
+        }
+        parentId = info.parent.id;
+        slotName = info.slot;
+        // Unknown parent manifests impose no allow-list; validation owns that issue.
+        slotRule = getManifest(info.parent.componentId)?.slots.find((s) => s.name === info.slot);
+        index = info.index + (location.position === 'after' ? 1 : 0);
+    }
+    if (!slotAllows(slotRule, subject.componentId)) {
+        return rejected('not-allowed', `Slot "${slotName}" does not allow "${subject.componentId}".`);
+    }
+    const target = { parentId, slot: slotName, index };
+    if (subject.kind === 'component') {
+        return { eligible: true, kind: 'insert', target };
+    }
+    // Cycle prevention: a node can never land inside its own subtree.
+    if (subject.nodeId === parentId || isDescendantOf(root, subject.nodeId, parentId)) {
+        return rejected('own-subtree', 'A node cannot be dropped into its own subtree.');
+    }
+    // No-op detection: the final position (after same-slot removal compensation,
+    // matching `moveNode`) equals the node's current position.
+    const current = getParentInfo(root, subject.nodeId);
+    if (current && current.parent.id === parentId && current.slot === slotName) {
+        const finalIndex = index > current.index ? index - 1 : index;
+        if (finalIndex === current.index) {
+            return rejected('no-op', 'Dropping here would not move the node.');
+        }
+    }
+    return { eligible: true, kind: 'move', nodeId: subject.nodeId, target };
+}
+// ---------------------------------------------------------------------------
+// Wrap gesture (EC-162): drop beside → two-column Grid container
+// ---------------------------------------------------------------------------
+/**
+ * The container a "drop beside" gesture creates. Canonical choice (EC-161
+ * semantics): a `Grid` with two columns, **not** a horizontal `Stack` —
+ * EC-161 gives `Grid` the canonical column vocabulary (`columns` is a
+ * validated graph value the contextual inspector refines from 2 → n), while
+ * a horizontal Stack expresses flow order, not column tracks. The values
+ * mirror the Grid manifest defaults (`columns: 2`, `gap: '4'`), so the
+ * gesture's graph is exactly what composing the same layout manually would
+ * produce.
+ */
+export const WRAP_GRID_OPTIONS = { columns: 2, gap: '4' };
+/** Eligibility for a `left`/`right` (wrap-beside) drop. */
+function resolveWrap(args) {
+    const { root, getManifest, subject, reference, side } = args;
+    // The Grid takes the reference's place in its parent slot — so the
+    // reference needs a parent (the root is the page anchor, never wrapped)
+    // and that slot's allow-list must accept a Grid.
+    const info = getParentInfo(root, reference.id);
+    if (!info) {
+        return rejected('root', 'The page root cannot be wrapped in a container.');
+    }
+    const parentSlotRule = getManifest(info.parent.componentId)?.slots.find((s) => s.name === info.slot);
+    if (!slotAllows(parentSlotRule, GRID_COMPONENT_ID)) {
+        return rejected('not-allowed', `Slot "${info.slot}" does not allow a Grid container.`);
+    }
+    // Both columns land in the Grid's children slot.
+    const gridSlot = primaryInsertSlot(getManifest(GRID_COMPONENT_ID));
+    for (const componentId of [reference.componentId, subject.componentId]) {
+        if (!slotAllows(gridSlot, componentId)) {
+            return rejected('not-allowed', `A Grid container does not allow "${componentId}".`);
+        }
+    }
+    if (subject.kind === 'component') {
+        return { eligible: true, kind: 'wrap', referenceId: reference.id, side };
+    }
+    if (subject.nodeId === reference.id) {
+        return rejected('no-op', 'A node cannot be placed beside itself.');
+    }
+    // The reference must not live inside the dragged subtree (the subject is
+    // lifted out first — taking the reference with it would orphan the wrap).
+    if (isDescendantOf(root, subject.nodeId, reference.id)) {
+        return rejected('own-subtree', 'A node cannot wrap an element of its own subtree.');
+    }
+    return { eligible: true, kind: 'wrap', referenceId: reference.id, side, nodeId: subject.nodeId };
+}
+/**
+ * Execute a wrap plan as **one** structural edit: lift the partner out of the
+ * tree (when it is an existing node) and replace the reference with
+ * `gridContainerNode(containerId, WRAP_GRID_OPTIONS, [left, right])` in a
+ * single pass. The caller commits the result as one builder action → one
+ * operations command → one undo step; EC-161 normalization then runs on the
+ * *committed* tree, so the two-child container can never be observed (or
+ * persisted) in a half-built state. Returns `null` for structurally invalid
+ * input (missing nodes, root reference, reference inside the partner).
+ *
+ * Determinism (EC-162): the produced container subtree is exactly the
+ * `gridContainerNode` constructor output — identical to manual composition.
+ */
+export function applyWrap(args) {
+    const { root, referenceId, side, partner, containerId } = args;
+    if (referenceId === root.id || !getNode(root, referenceId))
+        return null;
+    let working = root;
+    let partnerNode;
+    if (partner.kind === 'node') {
+        if (partner.nodeId === referenceId || partner.nodeId === root.id)
+            return null;
+        const node = getNode(root, partner.nodeId);
+        if (!node || isDescendantOf(root, partner.nodeId, referenceId))
+            return null;
+        partnerNode = node;
+        working = removeNode(root, partner.nodeId);
+    }
+    else {
+        partnerNode = partner.node;
+    }
+    const next = updateNode(working, referenceId, (reference) => gridContainerNode(containerId, WRAP_GRID_OPTIONS, side === 'left' ? [partnerNode, reference] : [reference, partnerNode]));
+    return { root: next, containerId };
+}
+function staticPropValue(node, name) {
+    const prop = node.props?.[name];
+    return prop?.kind === 'static' ? prop.value : undefined;
+}
+/**
+ * The flow axis of a container — the axis its children stack along, and
+ * therefore the hit-band axis for drops over those children (EC-162 ledger
+ * fix: bands follow the parent's flow direction, on both surfaces). Mirrors
+ * the renderer: a horizontal Stack flows horizontally; a Grid flows
+ * horizontally when it actually has ≥ 2 column tracks (an absent/invalid
+ * `columns` renders one column). Everything else is block flow (vertical).
+ */
+export function containerFlowAxis(node) {
+    if (!node)
+        return 'vertical';
+    if (node.componentId === STACK_COMPONENT_ID) {
+        return staticPropValue(node, 'direction') === 'horizontal' ? 'horizontal' : 'vertical';
+    }
+    if (node.componentId === GRID_COMPONENT_ID) {
+        const columns = staticPropValue(node, 'columns');
+        return typeof columns === 'number' && columns >= 2 ? 'horizontal' : 'vertical';
+    }
+    return 'vertical';
+}
+/** Cross-axis side-band width (fraction of the box) that triggers the wrap gesture. */
+const WRAP_BAND = 0.18;
+/**
+ * Map a 2D pointer offset within a drop target's box onto a `DropPosition`
+ * (EC-162). `flow` is the flow axis of the target's *parent* — before/after
+ * bands run along it. On vertically flowing targets, narrow side bands on the
+ * cross axis produce `left`/`right` (the wrap-into-columns gesture, when
+ * `wrappable`); children of horizontal containers get left/right bands for
+ * plain reorder instead, so "beside" already means before/after there.
+ */
+export function dropPositionForPoint(args) {
+    const { x, y, flow, nestable, edges, wrappable = false } = args;
+    if (!edges)
+        return 'into';
+    if (wrappable && flow === 'vertical') {
+        if (x < WRAP_BAND)
+            return 'left';
+        if (x > 1 - WRAP_BAND)
+            return 'right';
+    }
+    return dropPositionForPointer({ ratio: flow === 'horizontal' ? x : y, nestable, edges });
+}
+/**
+ * Map a pointer offset within a drop target's box onto a `DropPosition`.
+ * `ratio` is the pointer's offset along the target's main axis, 0..1 — the
+ * caller picks the axis (the parent's flow axis; see `containerFlowAxis`).
+ *
+ * - nestable targets with siblings: edge quarters insert before/after, the
+ *   middle half nests into the slot
+ * - leaf targets: top/bottom halves insert before/after
+ * - targets without siblings (the root): always `into`
+ */
+export function dropPositionForPointer(args) {
+    const { ratio, nestable, edges } = args;
+    if (!edges)
+        return 'into';
+    if (nestable) {
+        if (ratio < 0.25)
+            return 'before';
+        if (ratio > 0.75)
+            return 'after';
+        return 'into';
+    }
+    return ratio < 0.5 ? 'before' : 'after';
+}
+export function dropIndicatorFor(resolution, position) {
+    if (resolution.eligible)
+        return position;
+    return resolution.code === 'no-op' ? null : 'blocked';
+}
+//# sourceMappingURL=drop-rules.js.map

package/dist/lib/dnd/drop-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-rules.js","sourceRoot":"","sources":["../../../src/lib/dnd/drop-rules.ts"],"names":[],"mappings":"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"}

package/dist/lib/dnd/gap-drag.d.ts

@@ -0,0 +1,66 @@
+import type { ComponentNode, SpacingTokenName } from '@elytracms/project-graph';
+import type { FlowAxis } from './drop-rules';
+/**
+ * Tokenized gap-drag math (EC-163, vision §3.1 / AD-10) — pure functions with
+ * no DOM dependencies, shared by the canvas spacing handles. The drag model is
+ * deliberately token-quantized: a pointer delta moves the gap through the
+ * EC-161 spacing-token *steps*, and the only values that can ever be produced
+ * are a `SpacingTokenName` or `null` ("no gap" — the prop is removed, exactly
+ * what the layout inspector's "None" choice does). No freeform pixel value can
+ * leave this module, so none can enter the graph from the canvas.
+ */
+/** A gap step the drag can land on: a spacing token, or `null` for "no gap". */
+export type GapStep = SpacingTokenName | null;
+/** The full drag range, smallest to largest: none, then the EC-161 token scale. */
+export declare const GAP_STEPS: readonly GapStep[];
+/** Canvas root font size — the deterministic rem basis for token CSS lengths. */
+export declare const GAP_REM_PX = 16;
+/** The pixel length of a gap step at the canvas rem basis. */
+export declare function gapStepPx(step: GapStep): number;
+/** The CSS length a previewed step renders with (the same length the renderer emits). */
+export declare function gapStepCss(step: GapStep): string;
+/** Snap a raw pixel gap onto the nearest step of the token scale. */
+export declare function nearestGapStep(px: number): GapStep;
+/**
+ * The step a drag lands on: the starting step's pixel length plus the pointer
+ * delta along the container's flow axis, snapped to the scale. Monotonic and
+ * deterministic — the same delta from the same start always lands on the same
+ * token.
+ */
+export declare function gapStepFromDrag(start: GapStep, deltaPx: number): GapStep;
+/**
+ * The current gap step of a container node: a token name verbatim, a legacy
+ * on-scale integer mapped to its token, anything else (absent, off-scale,
+ * bound) as `null` — mirroring how the layout inspector reads the same prop,
+ * so handle and inspector always start from the same value.
+ */
+export declare function containerGapStep(node: ComponentNode): GapStep;
+/** A minimal rectangle (client or document coordinates — caller's choice). */
+export interface GapRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * One draggable spot between two adjacent children. `x`/`y` is the gap's
+ * center point; `crossStart`/`crossLength` span the children's shared extent
+ * on the cross axis (the handle's visible length).
+ */
+export interface GapHandleSpot {
+    /** Index of the leading child of the pair. */
+    index: number;
+    x: number;
+    y: number;
+    crossStart: number;
+    crossLength: number;
+}
+/**
+ * The handle spots between consecutive child rects along the container's flow
+ * axis. Pairs that wrap (grid rows: the next rect starts before the previous
+ * ends along the axis) or that do not overlap on the cross axis yield no
+ * handle — handles only ever sit in real gaps between visual neighbours.
+ * Works at gap 0 too: the handle sits on the shared boundary so a closed gap
+ * can be dragged open.
+ */
+export declare function gapHandleSpots(rects: readonly GapRect[], axis: FlowAxis): GapHandleSpot[];

package/dist/lib/dnd/gap-drag.js

@@ -0,0 +1,95 @@
+import { SPACING_TOKEN_CSS, SPACING_TOKEN_NAMES, isSpacingTokenName, spacingTokenFromLegacyGap, } from '@elytracms/project-graph';
+/** The full drag range, smallest to largest: none, then the EC-161 token scale. */
+export const GAP_STEPS = [null, ...SPACING_TOKEN_NAMES];
+/** Canvas root font size — the deterministic rem basis for token CSS lengths. */
+export const GAP_REM_PX = 16;
+/** The pixel length of a gap step at the canvas rem basis. */
+export function gapStepPx(step) {
+    if (step === null)
+        return 0;
+    const css = SPACING_TOKEN_CSS[step];
+    const value = Number.parseFloat(css);
+    return css.endsWith('rem') ? value * GAP_REM_PX : value;
+}
+/** The CSS length a previewed step renders with (the same length the renderer emits). */
+export function gapStepCss(step) {
+    return step === null ? '0px' : SPACING_TOKEN_CSS[step];
+}
+/** Snap a raw pixel gap onto the nearest step of the token scale. */
+export function nearestGapStep(px) {
+    let best = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const step of GAP_STEPS) {
+        const distance = Math.abs(gapStepPx(step) - px);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = step;
+        }
+    }
+    return best;
+}
+/**
+ * The step a drag lands on: the starting step's pixel length plus the pointer
+ * delta along the container's flow axis, snapped to the scale. Monotonic and
+ * deterministic — the same delta from the same start always lands on the same
+ * token.
+ */
+export function gapStepFromDrag(start, deltaPx) {
+    return nearestGapStep(gapStepPx(start) + deltaPx);
+}
+/**
+ * The current gap step of a container node: a token name verbatim, a legacy
+ * on-scale integer mapped to its token, anything else (absent, off-scale,
+ * bound) as `null` — mirroring how the layout inspector reads the same prop,
+ * so handle and inspector always start from the same value.
+ */
+export function containerGapStep(node) {
+    const prop = node.props?.['gap'];
+    if (prop?.kind !== 'static')
+        return null;
+    if (typeof prop.value === 'string' && isSpacingTokenName(prop.value))
+        return prop.value;
+    if (typeof prop.value === 'number') {
+        const token = spacingTokenFromLegacyGap(prop.value);
+        if (token)
+            return token;
+    }
+    return null;
+}
+/**
+ * The handle spots between consecutive child rects along the container's flow
+ * axis. Pairs that wrap (grid rows: the next rect starts before the previous
+ * ends along the axis) or that do not overlap on the cross axis yield no
+ * handle — handles only ever sit in real gaps between visual neighbours.
+ * Works at gap 0 too: the handle sits on the shared boundary so a closed gap
+ * can be dragged open.
+ */
+export function gapHandleSpots(rects, axis) {
+    const spots = [];
+    for (let i = 0; i < rects.length - 1; i += 1) {
+        const a = rects[i];
+        const b = rects[i + 1];
+        const aEnd = axis === 'horizontal' ? a.left + a.width : a.top + a.height;
+        const bStart = axis === 'horizontal' ? b.left : b.top;
+        // Wrapped to the next row/column: not visual neighbours along the axis.
+        // A small tolerance keeps sub-pixel layout from dropping legitimate pairs.
+        if (bStart < aEnd - 0.5)
+            continue;
+        const crossStart = axis === 'horizontal' ? Math.max(a.top, b.top) : Math.max(a.left, b.left);
+        const crossEnd = axis === 'horizontal'
+            ? Math.min(a.top + a.height, b.top + b.height)
+            : Math.min(a.left + a.width, b.left + b.width);
+        if (crossEnd <= crossStart)
+            continue;
+        const mid = (aEnd + bStart) / 2;
+        spots.push({
+            index: i,
+            x: axis === 'horizontal' ? mid : crossStart + (crossEnd - crossStart) / 2,
+            y: axis === 'horizontal' ? crossStart + (crossEnd - crossStart) / 2 : mid,
+            crossStart,
+            crossLength: crossEnd - crossStart,
+        });
+    }
+    return spots;
+}
+//# sourceMappingURL=gap-drag.js.map

package/dist/lib/dnd/gap-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-drag.js","sourceRoot":"","sources":["../../../src/lib/dnd/gap-drag.ts"],"names":[],"mappings":"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"}

package/dist/lib/locale/binding-fallback.d.ts

@@ -0,0 +1,28 @@
+import type { Locale } from '@elytracms/cms-core';
+import type { BindingReference } from '@elytracms/project-graph';
+import type { DataSource } from '@elytracms/data-binding';
+import type { DisplayedFallback } from './fallback';
+/**
+ * Fallback visibility for BOUND content (EC-176): given a stored content
+ * binding and its CMS source, decide whether the value the canvas currently
+ * previews for the active locale is served via EC-018 locale fallback. Used
+ * by the inspector's Content tab — the surface that explains what a bound
+ * field shows (the canvas overlay itself is out of this wave's reach; see
+ * EC-176 notes).
+ *
+ * Deterministic over the playground delivery engine: the same
+ * `@elytracms/content` resolution that produced the previewed value reports
+ * which fields fell back (`ResolutionInfo.localeFallbacks`), so the label can
+ * never disagree with the displayed value.
+ */
+/** A previewed bound value that fell back, plus which field it came from. */
+export interface BoundValueFallback extends DisplayedFallback {
+    field: string;
+}
+/**
+ * Whether the bound field's previewed value (first entry for list/repeater
+ * bindings, the bound document otherwise) is a locale fallback in `locale`.
+ * `null` when the binding is not CMS-shaped, points at no field, or the value
+ * is a real translation.
+ */
+export declare function cmsBindingFallback(binding: BindingReference, source: DataSource | undefined, locale: Locale): BoundValueFallback | null;

package/dist/lib/locale/binding-fallback.js

@@ -0,0 +1,66 @@
+import { listQueryOfConfig } from '../bindings/section-bindings';
+import { getCollectionDocument, runCollectionListQuery } from '../data/collection-content';
+function isCmsSource(source) {
+    return source.kind === 'cms';
+}
+/** JSON-pointer-ish token → path segments ('/0/title' → ['0', 'title']). */
+function pathOfToken(token) {
+    return token
+        .split('/')
+        .filter((segment) => segment.length > 0)
+        .map((segment) => segment.replaceAll('~1', '/').replaceAll('~0', '~'));
+}
+/**
+ * Whether the bound field's previewed value (first entry for list/repeater
+ * bindings, the bound document otherwise) is a locale fallback in `locale`.
+ * `null` when the binding is not CMS-shaped, points at no field, or the value
+ * is a real translation.
+ */
+export function cmsBindingFallback(binding, source, locale) {
+    if (source === undefined || !isCmsSource(source))
+        return null;
+    if (binding.mode !== 'value' && binding.mode !== 'repeaterItem')
+        return null;
+    const config = source.config;
+    let path = pathOfToken(binding.token);
+    if (path.length === 0)
+        return null;
+    // List-shaped value bindings carry a leading entry index; repeater-item
+    // bindings preview the first entry (the same convention as ContentPreview).
+    let entryIndex = 0;
+    const listShaped = config.documentId === undefined;
+    if (binding.mode === 'value' && listShaped) {
+        const head = path[0];
+        if (!/^\d+$/.test(head))
+            return null;
+        entryIndex = Number(head);
+        path = path.slice(1);
+    }
+    const field = path[0];
+    if (field === undefined)
+        return null;
+    // Resolve the previewed document's id, then ask the delivery engine which
+    // fields fell back for it in the active locale.
+    let documentId = config.documentId;
+    if (documentId === undefined) {
+        const list = runCollectionListQuery(config.collectionId, listQueryOfConfig(config), locale);
+        if (!list.ok)
+            return null;
+        const entry = list.documents[entryIndex];
+        if (entry === undefined)
+            return null;
+        documentId = entry.id;
+    }
+    const { info } = getCollectionDocument(config.collectionId, documentId, locale);
+    if (info === null)
+        return null;
+    const fellBack = info.localeFallbacks.find((entry) => entry.path[0] === field);
+    if (fellBack === undefined)
+        return null;
+    return {
+        field,
+        sourceLocale: fellBack.sourceLocale,
+        requestedLocale: fellBack.requestedLocale,
+    };
+}
+//# sourceMappingURL=binding-fallback.js.map

package/dist/lib/locale/binding-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-fallback.js","sourceRoot":"","sources":["../../../src/lib/locale/binding-fallback.ts"],"names":[],"mappings":"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"}

package/dist/lib/locale/fallback.d.ts

@@ -0,0 +1,43 @@
+import type { CmsDocument, CollectionDef, Locale, LocaleConfig } from '@elytracms/cms-core';
+/**
+ * Fallback visibility (EC-176) — the pure "is this displayed value a
+ * fallback?" decision the CMS table cells, detail-editor fields, and the
+ * builder's Content tab all share. One function answers it, so a value is
+ * either labeled everywhere or a real translation everywhere — never
+ * silently mixed.
+ */
+/** A displayed value that came from the fallback locale, not the active one. */
+export interface DisplayedFallback {
+    /** The locale the rendered value was actually read from. */
+    sourceLocale: Locale;
+    /** The locale the surface asked for (the ambient active locale). */
+    requestedLocale: Locale;
+}
+/** True when the document stores an explicit variant of `field` for `locale`. */
+export declare function hasLocaleVariant(doc: CmsDocument, fieldName: string, locale: Locale): boolean;
+/**
+ * Whether the value a surface displays for `field` in `locale` is served via
+ * EC-018 default-locale fallback. `null` means "not a fallback": the field is
+ * not localized (locale-independent by design), the active locale has its own
+ * variant, or there is nothing to display at all (an empty field is empty,
+ * not a fallback).
+ */
+export declare function displayedFieldFallback(collection: CollectionDef, doc: CmsDocument, fieldName: string, locale: Locale, config: LocaleConfig): DisplayedFallback | null;
+/**
+ * The value a surface should display for `field` in `locale` (explicit
+ * variant, else fallback) together with its fallback marker. Display and
+ * label come from the same resolution, so they can never disagree.
+ */
+export declare function resolveDisplayedValue(collection: CollectionDef, doc: CmsDocument, fieldName: string, locale: Locale, config: LocaleConfig): {
+    value: unknown;
+    fallback: DisplayedFallback | null;
+};
+/**
+ * True when editing `field` in `locale` would CREATE a new localized variant
+ * (rather than update an existing one): the field is localized and the active
+ * locale isn't the document's fallback source and has no variant yet. Drives
+ * the "translating from EN" affordance on editors.
+ */
+export declare function editCreatesVariant(collection: CollectionDef, doc: CmsDocument, fieldName: string, locale: Locale, config: LocaleConfig): boolean;
+/** Compact display form of a locale code for chips/badges ("en" → "EN"). */
+export declare function localeChipLabel(locale: Locale): string;

package/dist/lib/locale/fallback.js

@@ -0,0 +1,52 @@
+import { documentDefaultLocale, isFieldLocalized, resolveField } from '@elytracms/cms-core';
+/** True when the document stores an explicit variant of `field` for `locale`. */
+export function hasLocaleVariant(doc, fieldName, locale) {
+    const bag = doc.localized?.[locale];
+    return bag !== undefined && fieldName in bag;
+}
+/**
+ * Whether the value a surface displays for `field` in `locale` is served via
+ * EC-018 default-locale fallback. `null` means "not a fallback": the field is
+ * not localized (locale-independent by design), the active locale has its own
+ * variant, or there is nothing to display at all (an empty field is empty,
+ * not a fallback).
+ */
+export function displayedFieldFallback(collection, doc, fieldName, locale, config) {
+    if (!isFieldLocalized(collection, fieldName))
+        return null;
+    if (hasLocaleVariant(doc, fieldName, locale))
+        return null;
+    const resolved = resolveField(collection, doc, fieldName, locale, config);
+    if (!resolved.fellBack || resolved.value === undefined)
+        return null;
+    return { sourceLocale: resolved.sourceLocale, requestedLocale: locale };
+}
+/**
+ * The value a surface should display for `field` in `locale` (explicit
+ * variant, else fallback) together with its fallback marker. Display and
+ * label come from the same resolution, so they can never disagree.
+ */
+export function resolveDisplayedValue(collection, doc, fieldName, locale, config) {
+    return {
+        value: resolveField(collection, doc, fieldName, locale, config).value,
+        fallback: displayedFieldFallback(collection, doc, fieldName, locale, config),
+    };
+}
+/**
+ * True when editing `field` in `locale` would CREATE a new localized variant
+ * (rather than update an existing one): the field is localized and the active
+ * locale isn't the document's fallback source and has no variant yet. Drives
+ * the "translating from EN" affordance on editors.
+ */
+export function editCreatesVariant(collection, doc, fieldName, locale, config) {
+    if (!isFieldLocalized(collection, fieldName))
+        return false;
+    if (locale === documentDefaultLocale(doc, config))
+        return false;
+    return !hasLocaleVariant(doc, fieldName, locale);
+}
+/** Compact display form of a locale code for chips/badges ("en" → "EN"). */
+export function localeChipLabel(locale) {
+    return locale.toUpperCase();
+}
+//# sourceMappingURL=fallback.js.map

package/dist/lib/locale/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/lib/locale/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmB3F,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,SAAiB,EAAE,MAAc;IAClF,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;IACnC,OAAO,GAAG,KAAK,SAAS,IAAI,SAAS,IAAI,GAAG,CAAA;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAyB,EACzB,GAAgB,EAChB,SAAiB,EACjB,MAAc,EACd,MAAoB;IAEpB,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IACzD,IAAI,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACzE,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAyB,EACzB,GAAgB,EAChB,SAAiB,EACjB,MAAc,EACd,MAAoB;IAEpB,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK;QACrE,QAAQ,EAAE,sBAAsB,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;KAC7E,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAyB,EACzB,GAAgB,EAChB,SAAiB,EACjB,MAAc,EACd,MAAoB;IAEpB,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1D,IAAI,MAAM,KAAK,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/D,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAA;AAC7B,CAAC"}

package/dist/lib/locale/index.d.ts

@@ -0,0 +1,6 @@
+export * from './locale-store';
+export * from './fallback';
+export * from './route-variant';
+export * from './binding-fallback';
+export * from './use-studio-locale';
+export * from './locale-switcher';