@velastack/cms 0.4.0 → 0.5.0

package/dist/components/cms/cms-link.svelte

@@ -10,37 +10,43 @@
 	};
 
 	export type CmsLinkRenderProps = { label: string; href: string; newTab: boolean };
+
+	export const normalizeLink = (raw: unknown): CmsLinkValue => {
+		if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {};
+		const r = raw as Record<string, unknown>;
+		const out: CmsLinkValue = {};
+		if (typeof r.label === 'string') out.label = r.label;
+		if (typeof r.href === 'string') out.href = r.href;
+		if (typeof r.routeId === 'string') out.routeId = r.routeId;
+		if (r.params && typeof r.params === 'object' && !Array.isArray(r.params)) {
+			out.params = r.params as Record<string, string>;
+		}
+		if (typeof r.newTab === 'boolean') out.newTab = r.newTab;
+		return out;
+	};
 </script>
 
 <script lang="ts">
 	import type { Snippet } from 'svelte';
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 	import { resolveRouteUrl } from '../admin-bar/resolve-route.js';
 
 	type Props = {
 		name: string;
+		scope?: string;
 		fallback?: CmsLinkValue;
 		value?: unknown;
 		class?: string;
 		children?: Snippet<[CmsLinkRenderProps]>;
 	};
-	let { name, fallback, value, class: className, children }: Props = $props();
+	let { name, scope, fallback, value, class: className, children }: Props = $props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): CmsLinkValue => (raw === undefined ? (fallback ?? {}) : normalizeLink(raw))
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const link = $derived.by((): CmsLinkValue => {
-		if (resolved && typeof resolved === 'object') return resolved as CmsLinkValue;
-		return fallback ?? {};
-	});
+	const link = $derived(field.current);
 
 	const href = $derived.by(() => {
 		if (link.routeId) {
@@ -55,12 +61,11 @@
 
 	const label = $derived(link.label ?? '');
 	const newTab = $derived(!!link.newTab);
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	{#await import('./cms-link-editable.svelte') then { default: Editable }}
-		<Editable scope={ref} {name} initial={link} {className} {children} />
+		<Editable scope={field.ref} {name} initial={link} {className} {children} />
 	{/await}
 {:else if children}
 	{@render children({ label, href, newTab })}
@@ -73,8 +78,10 @@
 	>
 		{label || name}
 	</a>
+{:else if field.raw === null}
+	<!-- cleared by the editor -->
 {:else}
-	<span class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>
+	<span class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}>
 		{name}
 	</span>
 {/if}

package/dist/components/cms/cms-link.svelte.d.ts

@@ -12,9 +12,11 @@ export type CmsLinkRenderProps = {
     href: string;
     newTab: boolean;
 };
+export declare const normalizeLink: (raw: unknown) => CmsLinkValue;
 import type { Snippet } from 'svelte';
 type Props = {
     name: string;
+    scope?: string;
     fallback?: CmsLinkValue;
     value?: unknown;
     class?: string;

package/dist/components/cms/cms-markdown.svelte

@@ -1,42 +1,41 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import { marked } from 'marked';
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 
 	type Props = {
 		name: string;
+		scope?: string;
 		fallback?: string;
 		value?: unknown;
 		children?: Snippet;
 	};
 
-	let { name, fallback, value, children }: Props = $props();
+	let { name, scope, fallback, value, children }: Props = $props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): string | undefined => {
+			if (raw === undefined) return fallback;
+			return typeof raw === 'string' ? raw : '';
+		}
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const source = $derived(typeof resolved === 'string' ? resolved : (fallback ?? ''));
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
+	const source = $derived(field.current ?? '');
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	{#await import('./cms-markdown-editable.svelte') then { default: Editable }}
-		<Editable scope={ref} {name} initial={source} />
+		<Editable scope={field.ref} {name} initial={source} />
 	{/await}
 {:else if source}
 	<div class="cms-markdown">{@html marked.parse(source, { async: false })}</div>
+{:else if field.raw === null}
+	<!-- cleared by the editor -->
 {:else if children}
 	{@render children()}
 {:else}
-	<div class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>
+	<div class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}>
 		{name}
 	</div>
 {/if}

package/dist/components/cms/cms-markdown.svelte.d.ts

@@ -1,6 +1,7 @@
 import type { Snippet } from 'svelte';
 type Props = {
     name: string;
+    scope?: string;
     fallback?: string;
     value?: unknown;
     children?: Snippet;

package/dist/components/cms/cms-number-editable.svelte

@@ -15,7 +15,7 @@
 
 	const live = $derived(cmsStore.getValue(scope, name));
 	const display = $derived.by(() => {
-		const v = typeof live === 'number' ? live : initial;
+		const v = typeof live === 'number' ? live : live === null ? undefined : initial;
 		return typeof v === 'number' && Number.isFinite(v) ? String(v) : '';
 	});
 
@@ -34,7 +34,9 @@
 
 	const onInput = (e: Event) => {
 		const raw = (e.currentTarget as HTMLInputElement).value;
-		if (raw === '') return;
+		// An emptied input clears the field explicitly (`null`), so the
+		// published value no longer shows through.
+		if (raw === '') return cmsStore.setValue(scope, name, null);
 		const n = Number(raw);
 		if (!Number.isFinite(n)) return;
 		cmsStore.setValue(scope, name, integer ? Math.trunc(n) : n);

package/dist/components/cms/cms-number.svelte

@@ -3,8 +3,9 @@
 
 	export type CmsNumberProps = {
 		name: string;
+		scope?: string;
 		fallback?: number;
-		/** Per-item override used by `CmsRepeater`. */
+		/** Per-item override used by structured components. */
 		value?: unknown;
 		min?: number;
 		max?: number;
@@ -16,37 +17,37 @@
 </script>
 
 <script lang="ts">
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 
-	let { name, fallback, value, min, max, step, integer, children }: CmsNumberProps = $props();
+	let { name, scope, fallback, value, min, max, step, integer, children }: CmsNumberProps =
+		$props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): number | undefined => {
+			if (raw === undefined) return fallback;
+			return typeof raw === 'number' && Number.isFinite(raw) ? raw : undefined;
+		}
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const current = $derived(typeof resolved === 'number' ? resolved : fallback);
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
+	const current = $derived(field.current);
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	{#await import('./cms-number-editable.svelte') then { default: Editable }}
-		<Editable scope={ref} {name} initial={current} {min} {max} {step} {integer} />
+		<Editable scope={field.ref} {name} initial={current} {min} {max} {step} {integer} />
 	{/await}
 {:else if current !== undefined && children}
 	{@render children(current)}
 {:else if current !== undefined}
 	{current}
+{:else if field.raw === null}
+	<!-- cleared by the editor -->
 {:else if children}
 	{@render children(0)}
 {:else}
-	<span class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>{name}</span
+	<span class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}
+		>{name}</span
 	>
 {/if}
 

package/dist/components/cms/cms-number.svelte.d.ts

@@ -1,8 +1,9 @@
 import type { Snippet } from 'svelte';
 export type CmsNumberProps = {
     name: string;
+    scope?: string;
     fallback?: number;
-    /** Per-item override used by `CmsRepeater`. */
+    /** Per-item override used by structured components. */
     value?: unknown;
     min?: number;
     max?: number;

package/dist/components/cms/cms-repeater.svelte

@@ -1,43 +1,40 @@
 <script lang="ts" generics="T extends Record<string, unknown> = Record<string, unknown>">
 	import type { Snippet } from 'svelte';
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 
 	type Props = {
 		name: string;
+		scope?: string;
 		fallback?: T[];
 		value?: unknown;
 		children: Snippet<[T, number]>;
 	};
 
-	let { name, fallback, value, children }: Props = $props();
+	let { name, scope, fallback, value, children }: Props = $props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): T[] => {
+			if (raw === undefined) return Array.isArray(fallback) ? fallback : [];
+			return Array.isArray(raw) ? (raw as T[]) : [];
+		}
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const items = $derived(
-		Array.isArray(resolved) ? (resolved as T[]) : Array.isArray(fallback) ? fallback : []
-	);
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
+	const items = $derived(field.current);
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	{#await import('./cms-repeater-editable.svelte') then { default: Editable }}
-		<Editable scope={ref} {name} {items} {children} />
+		<Editable scope={field.ref} {name} {items} {children} />
 	{/await}
 {:else if items.length}
 	{#each items as item, i}
 		{@render children(item, i)}
 	{/each}
+{:else if field.raw === null}
+	<!-- cleared by the editor -->
 {:else}
-	<span class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>
+	<span class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}>
 		{name}
 	</span>
 {/if}

package/dist/components/cms/cms-repeater.svelte.d.ts

@@ -2,6 +2,7 @@ import type { Snippet } from 'svelte';
 declare function $$render<T extends Record<string, unknown> = Record<string, unknown>>(): {
     props: {
         name: string;
+        scope?: string;
         fallback?: T[];
         value?: unknown;
         children: Snippet<[T, number]>;

package/dist/components/cms/cms-rich-text.svelte

@@ -1,48 +1,41 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 
 	type Props = {
 		name: string;
+		scope?: string;
 		fallback?: string;
 		value?: unknown;
 		children?: Snippet;
 	};
 
-	let { name, fallback, value, children }: Props = $props();
+	let { name, scope, fallback, value, children }: Props = $props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): string | undefined => {
+			if (raw === undefined) return fallback;
+			return typeof raw === 'string' ? raw : '';
+		}
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const html = $derived(typeof resolved === 'string' ? resolved : (fallback ?? ''));
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
+	const html = $derived(field.current ?? '');
 
 	let childrenEl = $state<HTMLDivElement>();
 	let initialFromChildren = $state<string | undefined>(undefined);
 
 	$effect.pre(() => {
-		if (editable && childrenEl && initialFromChildren === undefined) {
+		if (field.editable && childrenEl && initialFromChildren === undefined) {
 			const inner = childrenEl.innerHTML.trim();
 			initialFromChildren = inner || undefined;
 		}
 	});
 
-	const editInitial = $derived.by(() => {
-		if (typeof resolved === 'string') return resolved;
-		if (fallback !== undefined) return fallback;
-		return initialFromChildren ?? '';
-	});
+	const editInitial = $derived(field.current ?? initialFromChildren ?? '');
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	<!-- Mounted straight into edit mode (navigation while editing): the
 	     children branch below never rendered, so render it hidden once to
 	     capture the default markup. Removed as soon as it's captured. -->
@@ -50,14 +43,16 @@
 		<div bind:this={childrenEl} class="cms-rich-text-capture">{@render children()}</div>
 	{/if}
 	{#await import('./cms-rich-text-editable.svelte') then { default: Editable }}
-		<Editable scope={ref} {name} initial={editInitial} />
+		<Editable scope={field.ref} {name} initial={editInitial} />
 	{/await}
 {:else if html}
 	<div class="cms-rich-text">{@html html}</div>
+{:else if field.raw === null}
+	<!-- cleared by the editor -->
 {:else if children}
 	<div bind:this={childrenEl} class="cms-rich-text-children">{@render children()}</div>
 {:else}
-	<div class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>
+	<div class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}>
 		{name}
 	</div>
 {/if}

package/dist/components/cms/cms-rich-text.svelte.d.ts

@@ -1,6 +1,7 @@
 import type { Snippet } from 'svelte';
 type Props = {
     name: string;
+    scope?: string;
     fallback?: string;
     value?: unknown;
     children?: Snippet;

package/dist/components/cms/cms-store.svelte.d.ts

@@ -38,9 +38,23 @@ declare class CmsStore {
     private _activeLocale;
     private overlayFetchToken;
     private entriesFetchToken;
+    private localeOverlayTokens;
     toggleEdit(): void;
     setActiveLocale(locale: string | null): void;
     private effectiveLocale;
+    /** The locale edits currently target: the editor's `?locale=` override, else the page's. */
+    get activeLocale(): string;
+    /** The project's default locale, `cms.locales[0]`. */
+    get defaultLocale(): string;
+    /** Every supported locale from the payload. */
+    get locales(): string[];
+    /**
+     * Make sure the overlay for `locale` is loaded for the current route's
+     * scopes, so a structured editor's translation tab and the Locales panel
+     * can read another locale's strings without switching the page. Uses the
+     * open release's preview key when there is one.
+     */
+    loadLocaleOverlay(locale: string): Promise<void>;
     /** Base doc (server-rendered) for a scope. Already locale-resolved by `resolveCmsPayload`. */
     private baseDoc;
     /** Merged read tree: base ∪ overlay (∪ draft when editing) for the given locale. */

package/dist/components/cms/cms-store.svelte.js

@@ -105,6 +105,7 @@ class CmsStore {
     _activeLocale = $state(null);
     overlayFetchToken = 0;
     entriesFetchToken = 0;
+    localeOverlayTokens = {};
     toggleEdit() {
         this.isEditing = !this.isEditing;
     }
@@ -114,6 +115,38 @@ class CmsStore {
     effectiveLocale() {
         return this._activeLocale ?? pageLocale();
     }
+    /** The locale edits currently target: the editor's `?locale=` override, else the page's. */
+    get activeLocale() {
+        return this.effectiveLocale();
+    }
+    /** The project's default locale, `cms.locales[0]`. */
+    get defaultLocale() {
+        return pageDefaultLocale();
+    }
+    /** Every supported locale from the payload. */
+    get locales() {
+        return page.data?.cms?.locales ?? [];
+    }
+    /**
+     * Make sure the overlay for `locale` is loaded for the current route's
+     * scopes, so a structured editor's translation tab and the Locales panel
+     * can read another locale's strings without switching the page. Uses the
+     * open release's preview key when there is one.
+     */
+    async loadLocaleOverlay(locale) {
+        const cms = page.data?.cms;
+        if (!cms)
+            return;
+        const scopes = Object.values(cms.scopes);
+        const loaded = scopes.every((s) => composeKey({ scopeId: s.scopeId, routeId: s.routeId, params: s.params }, locale) in
+            this.overlay);
+        if (loaded)
+            return;
+        await this.loadAndApplyOverlay(cms.endpoint, scopes, this.openRelease?.preview_key ?? null, {
+            locale,
+            defaultLocale: cms.locales[0]
+        });
+    }
     /** Base doc (server-rendered) for a scope. Already locale-resolved by `resolveCmsPayload`. */
     baseDoc(scope) {
         const cms = page.data?.cms;
@@ -234,7 +267,11 @@ class CmsStore {
      * overlays applied during navigation while new-page scopes load.
      */
     async loadAndApplyOverlay(endpoint, scopes, previewKey, opts) {
-        const token = ++this.overlayFetchToken;
+        // One in-flight fetch per locale: a translation tab loading `es` must
+        // not cancel the page's own `en` overlay load, and vice versa.
+        const token = (this.localeOverlayTokens[opts.locale] =
+            (this.localeOverlayTokens[opts.locale] ?? 0) + 1);
+        this.overlayFetchToken = token;
         const versionKey = opts.versionKey ?? null;
         const locale = opts.locale;
         const defaultLocale = opts.defaultLocale ?? pageDefaultLocale() ?? locale;
@@ -271,7 +308,7 @@ class CmsStore {
                 ? Promise.all(scopes.map((s) => fetchScope(s, defaultLocale)))
                 : Promise.resolve(null)
         ]);
-        if (token !== this.overlayFetchToken)
+        if (token !== this.localeOverlayTokens[locale])
             return;
         const merged = mergeLocaleDocs(collect(requestedPairs), fallbackPairs ? collect(fallbackPairs) : null);
         const scopeIndex = new Map();

package/dist/components/cms/cms-text.svelte

@@ -1,30 +1,29 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
-	import { getCmsScope } from './scope.js';
-	import { cmsStore, type CmsScopeRef } from './cms-store.svelte.js';
+	import { useCmsField } from './use-cms-field.svelte.js';
 
 	type Props = {
 		name: string;
+		/** `'root'` for the root layout scope, or an explicit scope id. */
+		scope?: string;
 		fallback?: string;
-		/** Per-item override used by `CmsRepeater`. */
+		/** Per-item override used by structured components. */
 		value?: unknown;
 		children?: Snippet;
 	};
 
-	let { name, fallback, value, children }: Props = $props();
+	let { name, scope, fallback, value, children }: Props = $props();
 
-	const scope = getCmsScope();
-	const ref = $derived<CmsScopeRef | null>(
-		scope ? { scopeId: scope.scopeId, routeId: scope.routeId, params: scope.params } : null
+	// `undefined` → fallback (or children); `null` → cleared, shown empty.
+	const field = useCmsField(
+		() => ({ name, scope, value }),
+		(raw): string | undefined => {
+			if (raw === undefined) return fallback;
+			return typeof raw === 'string' ? raw : '';
+		}
 	);
 
-	const resolved = $derived.by(() => {
-		if (value !== undefined) return value;
-		return ref ? cmsStore.getValue(ref, name) : undefined;
-	});
-
-	const display = $derived(typeof resolved === 'string' ? resolved : (fallback ?? ''));
-	const editable = $derived(cmsStore.isEditing && value === undefined && !!ref);
+	const display = $derived(field.current ?? '');
 
 	let el = $state<HTMLSpanElement>();
 	let childrenEl = $state<HTMLElement>();
@@ -32,17 +31,13 @@
 	let composing = false;
 
 	$effect.pre(() => {
-		if (editable && childrenEl && initialFromChildren === undefined) {
+		if (field.editable && childrenEl && initialFromChildren === undefined) {
 			const text = childrenEl.textContent?.trim();
 			initialFromChildren = text || undefined;
 		}
 	});
 
-	const editValue = $derived.by(() => {
-		if (typeof resolved === 'string') return resolved;
-		if (fallback !== undefined) return fallback;
-		return initialFromChildren ?? '';
-	});
+	const editValue = $derived(field.current ?? initialFromChildren ?? '');
 
 	$effect(() => {
 		if (!el) return;
@@ -52,14 +47,9 @@
 		el.textContent = target;
 	});
 
-	const writeValue = (text: string) => {
-		if (!ref) return;
-		cmsStore.setValue(ref, name, text);
-	};
-
 	const onInput = (e: Event) => {
 		if (composing) return;
-		writeValue((e.currentTarget as HTMLElement).textContent ?? '');
+		field.set((e.currentTarget as HTMLElement).textContent ?? '');
 	};
 
 	const onKeydown = (e: KeyboardEvent) => {
@@ -68,11 +58,11 @@
 
 	const onCompositionEnd = (e: CompositionEvent) => {
 		composing = false;
-		writeValue((e.currentTarget as HTMLElement).textContent ?? '');
+		field.set((e.currentTarget as HTMLElement).textContent ?? '');
 	};
 </script>
 
-{#if editable && ref}
+{#if field.editable && field.ref}
 	<!-- Mounted straight into edit mode (navigation while editing): the
 	     children branch below never rendered, so render it hidden once to
 	     capture the default text. Removed as soon as it's captured. -->
@@ -85,7 +75,7 @@
 		contenteditable="plaintext-only"
 		data-placeholder={name}
 		data-cms-name={name}
-		data-cms-scope={scope?.scopeId ?? '?'}
+		data-cms-scope={field.ref.scopeId}
 		role="textbox"
 		tabindex="0"
 		aria-multiline="false"
@@ -98,10 +88,13 @@
 	></span>
 {:else if display}
 	{display}
+{:else if field.raw === null}
+	<!-- cleared by the editor: render nothing -->
 {:else if children}
 	<span bind:this={childrenEl} class="cms-text-children">{@render children()}</span>
 {:else}
-	<span class="cms-missing" data-cms-name={name} data-cms-scope={scope?.scopeId ?? '?'}>{name}</span
+	<span class="cms-missing" data-cms-name={name} data-cms-scope={field.ref?.scopeId ?? '?'}
+		>{name}</span
 	>
 {/if}
 

package/dist/components/cms/cms-text.svelte.d.ts

@@ -1,8 +1,10 @@
 import type { Snippet } from 'svelte';
 type Props = {
     name: string;
+    /** `'root'` for the root layout scope, or an explicit scope id. */
+    scope?: string;
     fallback?: string;
-    /** Per-item override used by `CmsRepeater`. */
+    /** Per-item override used by structured components. */
     value?: unknown;
     children?: Snippet;
 };