@shop-on/theme-contract 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -1,12 +1,21 @@
-import { BlockDefinition, BlockSchema, LayoutGroupDef, SchemaSetting, SectionGroup, SectionGroupData, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingValue, SettingsData, SettingsSchema, SettingsSchemaSection, Template, TemplateBlock, TemplateSection } from "./schemas.js";
+import { BlockDefinition, BlockSchema, CLOSEST_RESOURCES, ClosestOverlays, ClosestResource, LayoutGroupDef, ProviderDecl, Provides, SchemaSetting, SectionGroup, SectionGroupData, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingValue, SettingsData, SettingsSchema, SettingsSchemaSection, THEME_FED, Template, TemplateBlock, TemplateSection } from "./schemas.js";
+import { EntryDoc, MAX_BATCH_BYTES, MAX_BATCH_OPS, MAX_PATH_DEPTH, MAX_SEGMENT_LENGTH, Op, OpBatch, OpBatchBody, OpBatchBodySchema, OpReset, OpSchema, ThemeDocument, TouchedEntries, applyOps, chunkOps, diffDocument, invertOps, touchedEntries } from "./ops.js";
+import { ClosestScope, PICKER_RESOURCES, Providers, ScopeLink, closestScopeAt, providersOf } from "./closest-scope.js";
+import { RICHTEXT_ALLOWED_TAGS, RICHTEXT_FIELD_TAGS, RICHTEXT_SANITIZE_CONFIG, RichTextPurifier, RichtextTag, hasRichText, registerRichTextHooks, stripInlineTokenSentinels } from "./richtext.js";
 import { BLOCK_PATH_SEPARATOR, blockPathsEqual, isBlockPathPrefix, joinBlockPath, normalizeBlockPath, resolveContainerAtPath, splitBlockPath } from "./block-path.js";
 import { EDITOR_COMMANDS, EditorCommand, EditorKeyInput, editorCommand, isEditorCommand, shortcutKey, undoHotkey } from "./editor-keys.js";
-import { CollectedTypes, SeedMissingStaticsReport, SelectedSection, TemplateShape, buildBlockInstance, buildSectionInstance, buildStaticChildren, collectTypes, defaultSettings, seedMissingStatics, selectRenderableChildren, selectRenderableSections, staticBlockId, staticChildId, stripStaticFromBlockOrder } from "./document.js";
+import { APP_BLOCK_WILDCARD, CollectedTypes, MAX_APP_BLOCK_CONTAINER_DEPTH, SeedMissingStaticsReport, SelectedSection, TemplateShape, acceptsAppBlocks, buildBlockInstance, buildSectionInstance, buildStaticChildren, collectTypes, defaultSettings, seedMissingStatics, selectRenderableChildren, selectRenderableSections, staticBlockId, staticChildId, stripStaticFromBlockOrder } from "./document.js";
 import { MAX_PALETTE_COLORS, MIN_PALETTE_COLORS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, PaletteColor, comparePaletteIds, hasPaletteRefs, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette } from "./color-palette.js";
 import { FieldSource, ResolverCtx, ResolverScope, ResolverShape, ResolverSpec, SKIP, Skip, buildDisabledAncestorSet, buildParentMap, resolveField, walkBlocks, walkSections } from "./resolvers.js";
-import { ARTICLE_ATTRIBUTE_KEYS, ArticleAttributeKey, BLOG_ATTRIBUTE_KEYS, BlogAttributeKey, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, CollectionAttributeBindingSources, CollectionAttributeKey, CollectionInlineAttributeKey, InlineSegment, InlineSources, PAGE_ATTRIBUTE_KEYS, PRODUCT_ATTRIBUTE_KEYS, PageAttributeKey, ProductAttributeKey, WholeValueBindingOpts, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, decodeStorefrontMetafield, encodeSourceToken, escapeInertHtmlText, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, parseSourceDescriptor, serializeSourceDescriptor, settingTypeSupportsBinding, splitInlineTokens, stripInlineTokenSentinels } from "./metafield-binding.js";
+import { ARTICLE_ATTRIBUTE_KEYS, ArticleAttributeKey, BLOG_ATTRIBUTE_KEYS, BlogAttributeKey, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, ClosestItemSources, ClosestLookup, CollectionAttributeBindingSources, CollectionAttributeKey, CollectionInlineAttributeKey, InlineSegment, InlineSources, PAGE_ATTRIBUTE_KEYS, PRODUCT_ATTRIBUTE_KEYS, PageAttributeKey, ProductAttributeKey, RESOURCE_METAFIELD_SOURCES, ROUTE_METAFIELD_RESOURCE, ROUTE_METAFIELD_SOURCES, ResourceMetafieldBinding, ResourceMetafieldSource, RouteMetafieldSource, WholeValueBindingOpts, applyClosestBindings, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, closestResourceOf, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, decodeStorefrontMetafield, encodeSourceToken, escapeInertHtmlText, isClosestSink, isResourceMetafieldBinding, isResourceMetafieldSource, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, nodeSourceDescriptors, parseSourceDescriptor, routeTwin, serializeSourceDescriptor, settingTypeSupportsBinding, splitInlineTokens, templateReferencesSource } from "./metafield-binding.js";
 import { metaobjectGid, metaobjectIdFromGid } from "./metaobject-gid.js";
-import { RICHTEXT_ALLOWED_TAGS, RichtextTag } from "./richtext.js";
 import { isNodeIdToken, nodeGid } from "./node-id.js";
-import { INSTALL_ID_RE, STORE_SLUG_RE } from "./store-path.js";
-export { ARTICLE_ATTRIBUTE_KEYS, ArticleAttributeKey, BLOCK_PATH_SEPARATOR, BLOG_ATTRIBUTE_KEYS, BlockDefinition, BlockSchema, BlogAttributeKey, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, CollectedTypes, CollectionAttributeBindingSources, CollectionAttributeKey, CollectionInlineAttributeKey, EDITOR_COMMANDS, EditorCommand, EditorKeyInput, FieldSource, INSTALL_ID_RE, InlineSegment, InlineSources, LayoutGroupDef, MAX_PALETTE_COLORS, MIN_PALETTE_COLORS, PAGE_ATTRIBUTE_KEYS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, PRODUCT_ATTRIBUTE_KEYS, PageAttributeKey, PaletteColor, ProductAttributeKey, RICHTEXT_ALLOWED_TAGS, ResolverCtx, ResolverScope, ResolverShape, ResolverSpec, RichtextTag, SKIP, STORE_SLUG_RE, SchemaSetting, SectionGroup, SectionGroupData, SectionPreset, SectionSchema, SeedMissingStaticsReport, SelectedSection, SettingBinding, SettingBindings, SettingValue, SettingsData, SettingsSchema, SettingsSchemaSection, Skip, Template, TemplateBlock, TemplateSection, TemplateShape, WholeValueBindingOpts, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, blockPathsEqual, buildBlockInstance, buildDisabledAncestorSet, buildParentMap, buildSectionInstance, buildStaticChildren, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, collectTypes, comparePaletteIds, decodeStorefrontMetafield, defaultSettings, editorCommand, encodeSourceToken, escapeInertHtmlText, hasPaletteRefs, isBlockPathPrefix, isEditorCommand, isNodeIdToken, joinBlockPath, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, metaobjectGid, metaobjectIdFromGid, nodeGid, normalizeBlockPath, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, parseSourceDescriptor, resolveContainerAtPath, resolveField, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette, seedMissingStatics, selectRenderableChildren, selectRenderableSections, serializeSourceDescriptor, settingTypeSupportsBinding, shortcutKey, splitBlockPath, splitInlineTokens, staticBlockId, staticChildId, stripInlineTokenSentinels, stripStaticFromBlockOrder, undoHotkey, walkBlocks, walkSections };
+import { DRAFT_SEEDED_KEY, INSTALL_ID_RE, STORE_SLUG_RE, invalidTemplateId } from "./store-path.js";
+import { MAX_BLOCKS_PER_TEMPLATE, MAX_BLOCK_NESTING_DEPTH, MAX_ENTRY_BYTES, MAX_SECTIONS_PER_TEMPLATE, countBlocksInBlock, countNestedBlocks, maxBlockDepth, maxDepthOfBlock, maxDepthOfBlockSchema, templateCounts } from "./template-limits.js";
+import { isSectionAddableInGroup, isSectionAllowedInGroup, isSectionEnabledOnTemplate, templateMatches } from "./section-scope.js";
+import { allowedChildBlockTypes } from "./block-allowlist.js";
+import { NormalizedUrl, normalizeCustomUrl } from "./link-url.js";
+import { VideoProvider, isAcceptedVideoUrl, parseVideoUrl } from "./video-url.js";
+import { GOOGLE_FONTS, GoogleFontEntry } from "./google-fonts.generated.js";
+import { SYSTEM_FONT_FAMILIES, isCatalogFontFamily } from "./fonts.js";
+export { APP_BLOCK_WILDCARD, ARTICLE_ATTRIBUTE_KEYS, ArticleAttributeKey, BLOCK_PATH_SEPARATOR, BLOG_ATTRIBUTE_KEYS, BlockDefinition, BlockSchema, BlogAttributeKey, CLOSEST_RESOURCES, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, ClosestItemSources, ClosestLookup, ClosestOverlays, ClosestResource, ClosestScope, CollectedTypes, CollectionAttributeBindingSources, CollectionAttributeKey, CollectionInlineAttributeKey, DRAFT_SEEDED_KEY, EDITOR_COMMANDS, EditorCommand, EditorKeyInput, EntryDoc, FieldSource, GOOGLE_FONTS, type GoogleFontEntry, INSTALL_ID_RE, InlineSegment, InlineSources, LayoutGroupDef, MAX_APP_BLOCK_CONTAINER_DEPTH, MAX_BATCH_BYTES, MAX_BATCH_OPS, MAX_BLOCKS_PER_TEMPLATE, MAX_BLOCK_NESTING_DEPTH, MAX_ENTRY_BYTES, MAX_PALETTE_COLORS, MAX_PATH_DEPTH, MAX_SECTIONS_PER_TEMPLATE, MAX_SEGMENT_LENGTH, MIN_PALETTE_COLORS, NormalizedUrl, Op, OpBatch, OpBatchBody, OpBatchBodySchema, OpReset, OpSchema, PAGE_ATTRIBUTE_KEYS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, PICKER_RESOURCES, PRODUCT_ATTRIBUTE_KEYS, PageAttributeKey, PaletteColor, ProductAttributeKey, ProviderDecl, Providers, Provides, RESOURCE_METAFIELD_SOURCES, RICHTEXT_ALLOWED_TAGS, RICHTEXT_FIELD_TAGS, RICHTEXT_SANITIZE_CONFIG, ROUTE_METAFIELD_RESOURCE, ROUTE_METAFIELD_SOURCES, ResolverCtx, ResolverScope, ResolverShape, ResolverSpec, ResourceMetafieldBinding, ResourceMetafieldSource, RichTextPurifier, RichtextTag, RouteMetafieldSource, SKIP, STORE_SLUG_RE, SYSTEM_FONT_FAMILIES, SchemaSetting, ScopeLink, SectionGroup, SectionGroupData, SectionPreset, SectionSchema, SeedMissingStaticsReport, SelectedSection, SettingBinding, SettingBindings, SettingValue, SettingsData, SettingsSchema, SettingsSchemaSection, Skip, THEME_FED, Template, TemplateBlock, TemplateSection, TemplateShape, ThemeDocument, TouchedEntries, VideoProvider, WholeValueBindingOpts, acceptsAppBlocks, allowedChildBlockTypes, applyClosestBindings, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, applyOps, blockPathsEqual, buildBlockInstance, buildDisabledAncestorSet, buildParentMap, buildSectionInstance, buildStaticChildren, chunkOps, closestResourceOf, closestScopeAt, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, collectTypes, comparePaletteIds, countBlocksInBlock, countNestedBlocks, decodeStorefrontMetafield, defaultSettings, diffDocument, editorCommand, encodeSourceToken, escapeInertHtmlText, hasPaletteRefs, hasRichText, invalidTemplateId, invertOps, isAcceptedVideoUrl, isBlockPathPrefix, isCatalogFontFamily, isClosestSink, isEditorCommand, isNodeIdToken, isResourceMetafieldBinding, isResourceMetafieldSource, isSectionAddableInGroup, isSectionAllowedInGroup, isSectionEnabledOnTemplate, joinBlockPath, maxBlockDepth, maxDepthOfBlock, maxDepthOfBlockSchema, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, metaobjectGid, metaobjectIdFromGid, nodeGid, nodeSourceDescriptors, normalizeBlockPath, normalizeCustomUrl, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, parseSourceDescriptor, parseVideoUrl, providersOf, registerRichTextHooks, resolveContainerAtPath, resolveField, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette, routeTwin, seedMissingStatics, selectRenderableChildren, selectRenderableSections, serializeSourceDescriptor, settingTypeSupportsBinding, shortcutKey, splitBlockPath, splitInlineTokens, staticBlockId, staticChildId, stripInlineTokenSentinels, stripStaticFromBlockOrder, templateCounts, templateMatches, templateReferencesSource, touchedEntries, undoHotkey, walkBlocks, walkSections };

package/dist/index.js

@@ -1,12 +1,21 @@
-import { BlockDefinition, BlockSchema, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, Template, TemplateBlock, TemplateSection } from "./schemas.js";
+import { BlockDefinition, BlockSchema, CLOSEST_RESOURCES, ClosestResource, ProviderDecl, Provides, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, THEME_FED, Template, TemplateBlock, TemplateSection } from "./schemas.js";
 import { BLOCK_PATH_SEPARATOR, blockPathsEqual, isBlockPathPrefix, joinBlockPath, normalizeBlockPath, resolveContainerAtPath, splitBlockPath } from "./block-path.js";
 import { EDITOR_COMMANDS, editorCommand, isEditorCommand, shortcutKey, undoHotkey } from "./editor-keys.js";
-import { buildBlockInstance, buildSectionInstance, buildStaticChildren, collectTypes, defaultSettings, seedMissingStatics, selectRenderableChildren, selectRenderableSections, staticBlockId, staticChildId, stripStaticFromBlockOrder } from "./document.js";
+import { APP_BLOCK_WILDCARD, MAX_APP_BLOCK_CONTAINER_DEPTH, acceptsAppBlocks, buildBlockInstance, buildSectionInstance, buildStaticChildren, collectTypes, defaultSettings, seedMissingStatics, selectRenderableChildren, selectRenderableSections, staticBlockId, staticChildId, stripStaticFromBlockOrder } from "./document.js";
 import { MAX_PALETTE_COLORS, MIN_PALETTE_COLORS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, comparePaletteIds, hasPaletteRefs, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette } from "./color-palette.js";
 import { SKIP, buildDisabledAncestorSet, buildParentMap, resolveField, walkBlocks, walkSections } from "./resolvers.js";
 import { metaobjectGid, metaobjectIdFromGid } from "./metaobject-gid.js";
-import { ARTICLE_ATTRIBUTE_KEYS, BLOG_ATTRIBUTE_KEYS, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, PAGE_ATTRIBUTE_KEYS, PRODUCT_ATTRIBUTE_KEYS, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, decodeStorefrontMetafield, encodeSourceToken, escapeInertHtmlText, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, parseSourceDescriptor, serializeSourceDescriptor, settingTypeSupportsBinding, splitInlineTokens, stripInlineTokenSentinels } from "./metafield-binding.js";
-import { RICHTEXT_ALLOWED_TAGS } from "./richtext.js";
+import { RICHTEXT_ALLOWED_TAGS, RICHTEXT_FIELD_TAGS, RICHTEXT_SANITIZE_CONFIG, hasRichText, registerRichTextHooks, stripInlineTokenSentinels } from "./richtext.js";
+import { ARTICLE_ATTRIBUTE_KEYS, BLOG_ATTRIBUTE_KEYS, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, PAGE_ATTRIBUTE_KEYS, PRODUCT_ATTRIBUTE_KEYS, RESOURCE_METAFIELD_SOURCES, ROUTE_METAFIELD_RESOURCE, ROUTE_METAFIELD_SOURCES, applyClosestBindings, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, closestResourceOf, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, decodeStorefrontMetafield, encodeSourceToken, escapeInertHtmlText, isClosestSink, isResourceMetafieldBinding, isResourceMetafieldSource, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, nodeSourceDescriptors, parseSourceDescriptor, routeTwin, serializeSourceDescriptor, settingTypeSupportsBinding, splitInlineTokens, templateReferencesSource } from "./metafield-binding.js";
+import { PICKER_RESOURCES, closestScopeAt, providersOf } from "./closest-scope.js";
 import { isNodeIdToken, nodeGid } from "./node-id.js";
-import { INSTALL_ID_RE, STORE_SLUG_RE } from "./store-path.js";
-export { ARTICLE_ATTRIBUTE_KEYS, BLOCK_PATH_SEPARATOR, BLOG_ATTRIBUTE_KEYS, BlockDefinition, BlockSchema, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, EDITOR_COMMANDS, INSTALL_ID_RE, MAX_PALETTE_COLORS, MIN_PALETTE_COLORS, PAGE_ATTRIBUTE_KEYS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, PRODUCT_ATTRIBUTE_KEYS, RICHTEXT_ALLOWED_TAGS, SKIP, STORE_SLUG_RE, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, Template, TemplateBlock, TemplateSection, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, blockPathsEqual, buildBlockInstance, buildDisabledAncestorSet, buildParentMap, buildSectionInstance, buildStaticChildren, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, collectTypes, comparePaletteIds, decodeStorefrontMetafield, defaultSettings, editorCommand, encodeSourceToken, escapeInertHtmlText, hasPaletteRefs, isBlockPathPrefix, isEditorCommand, isNodeIdToken, joinBlockPath, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, metaobjectGid, metaobjectIdFromGid, nodeGid, normalizeBlockPath, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, parseSourceDescriptor, resolveContainerAtPath, resolveField, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette, seedMissingStatics, selectRenderableChildren, selectRenderableSections, serializeSourceDescriptor, settingTypeSupportsBinding, shortcutKey, splitBlockPath, splitInlineTokens, staticBlockId, staticChildId, stripInlineTokenSentinels, stripStaticFromBlockOrder, undoHotkey, walkBlocks, walkSections };
+import { DRAFT_SEEDED_KEY, INSTALL_ID_RE, STORE_SLUG_RE, invalidTemplateId } from "./store-path.js";
+import { MAX_BATCH_BYTES, MAX_BATCH_OPS, MAX_PATH_DEPTH, MAX_SEGMENT_LENGTH, OpBatchBodySchema, OpSchema, applyOps, chunkOps, diffDocument, invertOps, touchedEntries } from "./ops.js";
+import { MAX_BLOCKS_PER_TEMPLATE, MAX_BLOCK_NESTING_DEPTH, MAX_ENTRY_BYTES, MAX_SECTIONS_PER_TEMPLATE, countBlocksInBlock, countNestedBlocks, maxBlockDepth, maxDepthOfBlock, maxDepthOfBlockSchema, templateCounts } from "./template-limits.js";
+import { isSectionAddableInGroup, isSectionAllowedInGroup, isSectionEnabledOnTemplate, templateMatches } from "./section-scope.js";
+import { allowedChildBlockTypes } from "./block-allowlist.js";
+import { normalizeCustomUrl } from "./link-url.js";
+import { isAcceptedVideoUrl, parseVideoUrl } from "./video-url.js";
+import { GOOGLE_FONTS } from "./google-fonts.generated.js";
+import { SYSTEM_FONT_FAMILIES, isCatalogFontFamily } from "./fonts.js";
+export { APP_BLOCK_WILDCARD, ARTICLE_ATTRIBUTE_KEYS, BLOCK_PATH_SEPARATOR, BLOG_ATTRIBUTE_KEYS, BlockDefinition, BlockSchema, CLOSEST_RESOURCES, COLLECTION_ATTRIBUTE_KEYS, COLLECTION_INLINE_ATTRIBUTE_KEYS, ClosestResource, DRAFT_SEEDED_KEY, EDITOR_COMMANDS, GOOGLE_FONTS, INSTALL_ID_RE, MAX_APP_BLOCK_CONTAINER_DEPTH, MAX_BATCH_BYTES, MAX_BATCH_OPS, MAX_BLOCKS_PER_TEMPLATE, MAX_BLOCK_NESTING_DEPTH, MAX_ENTRY_BYTES, MAX_PALETTE_COLORS, MAX_PATH_DEPTH, MAX_SECTIONS_PER_TEMPLATE, MAX_SEGMENT_LENGTH, MIN_PALETTE_COLORS, OpBatchBodySchema, OpSchema, PAGE_ATTRIBUTE_KEYS, PALETTE_FALLBACK_COLOR, PALETTE_GROUP_TYPE, PALETTE_PREFIX, PALETTE_REF_PREFIX, PICKER_RESOURCES, PRODUCT_ATTRIBUTE_KEYS, ProviderDecl, Provides, RESOURCE_METAFIELD_SOURCES, RICHTEXT_ALLOWED_TAGS, RICHTEXT_FIELD_TAGS, RICHTEXT_SANITIZE_CONFIG, ROUTE_METAFIELD_RESOURCE, ROUTE_METAFIELD_SOURCES, SKIP, STORE_SLUG_RE, SYSTEM_FONT_FAMILIES, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, THEME_FED, Template, TemplateBlock, TemplateSection, acceptsAppBlocks, allowedChildBlockTypes, applyClosestBindings, applyCollectionAttributeBindings, applyInlineSources, applyMetafieldBindings, applyMetaobjectFieldBindings, applyOps, blockPathsEqual, buildBlockInstance, buildDisabledAncestorSet, buildParentMap, buildSectionInstance, buildStaticChildren, chunkOps, closestResourceOf, closestScopeAt, collectCollectionAttributeBindings, collectMetaobjectEntryIds, collectTraversedEntryIds, collectTypes, comparePaletteIds, countBlocksInBlock, countNestedBlocks, decodeStorefrontMetafield, defaultSettings, diffDocument, editorCommand, encodeSourceToken, escapeInertHtmlText, hasPaletteRefs, hasRichText, invalidTemplateId, invertOps, isAcceptedVideoUrl, isBlockPathPrefix, isCatalogFontFamily, isClosestSink, isEditorCommand, isNodeIdToken, isResourceMetafieldBinding, isResourceMetafieldSource, isSectionAddableInGroup, isSectionAllowedInGroup, isSectionEnabledOnTemplate, joinBlockPath, maxBlockDepth, maxDepthOfBlock, maxDepthOfBlockSchema, metafieldDefinitionFitsSetting, metafieldTypeSupportsInlineToken, metafieldTypeToSettingTypes, metaobjectGid, metaobjectIdFromGid, nodeGid, nodeSourceDescriptors, normalizeBlockPath, normalizeCustomUrl, paletteKey, paletteRef, paletteValues, parsePalette, parsePaletteRef, parseSourceDescriptor, parseVideoUrl, providersOf, registerRichTextHooks, resolveContainerAtPath, resolveField, resolvePaletteRefs, resolvePaletteValue, resolveThemeSettingsPalette, routeTwin, seedMissingStatics, selectRenderableChildren, selectRenderableSections, serializeSourceDescriptor, settingTypeSupportsBinding, shortcutKey, splitBlockPath, splitInlineTokens, staticBlockId, staticChildId, stripInlineTokenSentinels, stripStaticFromBlockOrder, templateCounts, templateMatches, templateReferencesSource, touchedEntries, undoHotkey, walkBlocks, walkSections };

package/dist/link-url.d.ts

@@ -0,0 +1,9 @@
+//#region src/link-url.d.ts
+export type NormalizedUrl = {
+  ok: true;
+  url: string;
+} | {
+  ok: false;
+};
+export declare function normalizeCustomUrl(raw: string): NormalizedUrl;
+//#endregion

package/dist/link-url.js

@@ -0,0 +1,33 @@
+//#region src/link-url.ts
+const SCHEME = /^([a-z][a-z0-9+.-]*):/i;
+const LINK_SCHEMES = /* @__PURE__ */ new Set([
+	"http",
+	"https",
+	"mailto",
+	"tel"
+]);
+function normalizeCustomUrl(raw) {
+	const trimmed = raw.trim();
+	if (!trimmed) return { ok: false };
+	if (trimmed.includes("\\")) return { ok: false };
+	if (trimmed.startsWith("//")) return {
+		ok: true,
+		url: `https:${trimmed}`
+	};
+	if (trimmed.startsWith("/") || trimmed.startsWith("#")) return {
+		ok: true,
+		url: trimmed
+	};
+	const scheme = SCHEME.exec(trimmed);
+	if (scheme && !scheme[1].includes(".")) return LINK_SCHEMES.has(scheme[1].toLowerCase()) ? {
+		ok: true,
+		url: trimmed
+	} : { ok: false };
+	if (/\s/.test(trimmed) || !trimmed.includes(".")) return { ok: false };
+	return {
+		ok: true,
+		url: `https://${trimmed}`
+	};
+}
+//#endregion
+export { normalizeCustomUrl };

package/dist/metafield-binding.d.ts

@@ -1,4 +1,4 @@
-import { SettingBinding, SettingValue } from "./schemas.js";
+import { ClosestResource, SettingBinding, SettingValue } from "./schemas.js";
 //#region src/metafield-binding.d.ts
 export declare const metafieldTypeToSettingTypes: Record<string, readonly string[]>;
 /** True if a setting of this `type` can be bound to a metafield in v1. */
@@ -20,13 +20,37 @@ export interface WholeValueBindingOpts {
     value: string;
   }>>;
 }
-/** Overlay resolved product-metafield values onto a template's settings — for
- * each `product_metafield` binding, `metafields["namespace.key"]`. PDP-only (the
- * route product context); other sources are skipped. See applyWholeValueBindings. */
+export declare const ROUTE_METAFIELD_SOURCES: readonly ["collection_metafield", "page_metafield", "blog_metafield", "article_metafield"];
+export type RouteMetafieldSource = (typeof ROUTE_METAFIELD_SOURCES)[number];
+/** The route resource each source reads — the key of that resource on the
+ * loader's request and the editor's template families. */
+export declare const ROUTE_METAFIELD_RESOURCE: {
+  readonly collection_metafield: "collection";
+  readonly page_metafield: "page";
+  readonly blog_metafield: "blog";
+  readonly article_metafield: "article";
+};
+export declare const RESOURCE_METAFIELD_SOURCES: readonly ["product_metafield", "collection_metafield", "page_metafield", "blog_metafield", "article_metafield"];
+export type ResourceMetafieldSource = (typeof RESOURCE_METAFIELD_SOURCES)[number];
+/** True for a binding/descriptor that reads a route resource's metafield. */
+export declare function isResourceMetafieldSource(source: string): source is ResourceMetafieldSource;
+export type ResourceMetafieldBinding = Extract<SettingBinding, {
+  source: ResourceMetafieldSource;
+}>;
+/** True for a binding that reads a route resource's metafield. */
+export declare function isResourceMetafieldBinding(binding: SettingBinding): binding is ResourceMetafieldBinding;
+/** Overlay resolved resource-metafield values onto a template's settings — for
+ * each binding of `opts.source` (default `product_metafield`),
+ * `metafields["namespace.key"]`. The caller passes the route resource's map
+ * (the PDP's product, or the collection, page, blog or article a template
+ * renders); other sources are
+ * skipped. See applyWholeValueBindings. */
 export declare function applyMetafieldBindings(template: unknown, metafields: Record<string, {
   type: string;
   value: string;
-}>, opts?: WholeValueBindingOpts): void;
+}>, opts?: WholeValueBindingOpts & {
+  source?: ResourceMetafieldSource;
+}): void;
 /** Whole-value sibling for `metaobject_field` bindings — `metaobjectFields[entry][key]`.
  * Runs on every template (the entry is pinned, not the route product). */
 export declare function applyMetaobjectFieldBindings(template: unknown, metaobjectFields: Record<string, Record<string, {
@@ -50,8 +74,6 @@ export declare function applyCollectionAttributeBindings(template: unknown, sour
  * sidecars. The loader fetches the description HTML only when this includes
  * `description` (an inline description token resolves to "" and needs nothing). */
 export declare function collectCollectionAttributeBindings(template: unknown): string[];
-/** Strip inline-token sentinel delimiters from a string. */
-export declare function stripInlineTokenSentinels(value: string): string;
 export declare const PRODUCT_ATTRIBUTE_KEYS: readonly ["title", "vendor", "price"];
 export type ProductAttributeKey = (typeof PRODUCT_ATTRIBUTE_KEYS)[number];
 export declare const COLLECTION_ATTRIBUTE_KEYS: readonly ["title", "description"];
@@ -96,9 +118,14 @@ export interface InlineSources {
     value: string;
   }>>;
   collectionAttributes?: Record<string, string | null | undefined>;
+  routeMetafields?: Partial<Record<RouteMetafieldSource, Record<string, {
+    type: string;
+    value: string;
+  }>>>;
   pageAttributes?: Record<string, string | null | undefined>;
   blogAttributes?: Record<string, string | null | undefined>;
   articleAttributes?: Record<string, string | null | undefined>;
+  closest?: ClosestLookup;
 }
 /** Strip inline-token sentinels THEN HTML-escape — the full "make inert for an
  * HTML sink" transform. The single source of truth for both the `inline_richtext`
@@ -115,10 +142,62 @@ export declare function escapeInertHtmlText(value: string): string;
  * applyMetafieldBindings — a setting carries either a whole-value binding or
  * inline tokens, never both. */
 export declare function applyInlineSources(template: unknown, sources: InlineSources): void;
+/** The route arm a closest arm mirrors (same payload, `source` swapped), or
+ * null for a binding that is not a closest arm. */
+export declare function routeTwin(binding: SettingBinding): SettingBinding | null;
+/** The resource a closest arm resolves against, or null for any other arm. */
+export declare function closestResourceOf(binding: SettingBinding): ClosestResource | null;
+/** One in-scope item as the resolvers read it, the same shape for every
+ * resource: `attributes` keyed by the resource's `*_ATTRIBUTE_KEYS`, plus the
+ * product's `metafields` ("ns.key" → wire field) and the collection's
+ * `descriptionHtml` (whole-value `richtext` only). */
+export interface ClosestItemSources {
+  attributes: Record<string, string | null | undefined>;
+  metafields?: Record<string, {
+    type: string;
+    value: string;
+  }>;
+  descriptionHtml?: string | null;
+}
+/** The loader's answer to "what does this node resolve `closest_<resource>`
+ * against": a single item (a picker's, or the route's) per resource, and at
+ * most one `each` scope — the nearest list, whose item id the block mount
+ * carries. `singleAt` answers null for the `each` resource, so the shared copy
+ * blanks it and only the per-item overlays resolve it. */
+export interface ClosestLookup {
+  singleAt(node: unknown, resource: ClosestResource): ClosestItemSources | null;
+  eachAt(node: unknown): {
+    resource: ClosestResource;
+    items: ReadonlyArray<{
+      id: string;
+      sources: ClosestItemSources;
+    }>;
+  } | null;
+}
+/** True when a setting of `settingType` may carry a closest binding. */
+export declare function isClosestSink(settingType: string): boolean;
+/** Resolve every whole-value `closest_<resource>_*` binding on ONE node against
+ * ONE item, writing into `into` (a per-item overlay) or, by default, the node's
+ * own settings (a single scope). Other resources' arms and the route twins are
+ * untouched. A known sink is required — the schema's (`sinkTypeAt`) or the
+ * stamp's — and it must be one of the text / color / url sinks; the product
+ * metafield then goes through `resolveBoundValue` exactly as its twin does,
+ * and the collection description through the same inert-HTML path as
+ * `applyCollectionAttributeBindings`. The attribute arms are inline-only. */
+export declare function applyClosestBindings(node: unknown, resource: ClosestResource, item: ClosestItemSources, opts?: Pick<WholeValueBindingOpts, "serializeRichText" | "sinkTypeAt">, into?: Record<string, unknown>): void;
+/** Every source descriptor ONE node references — its `bindings` sidecar and
+ * the inline tokens in its string settings (both forms). The per-node half of
+ * `iterSourceDescriptors`, exported for the loader's closest-needs walk, which
+ * must attribute each descriptor to the node's own scope. */
+export declare function nodeSourceDescriptors(node: unknown): Generator<SettingBinding>;
 /** Distinct numeric metaobject entry ids PINNED anywhere in the template — via
  * `metaobject_field` sidecar bindings AND inline tokens. The theme loader fetches
  * exactly these before building the `metaobjectFields` map for the render passes. */
 export declare function collectMetaobjectEntryIds(template: unknown): string[];
+/** True when the template references `source` anywhere — a `bindings` sidecar
+ * or an inline token of either form. The loader asks this before fetching a
+ * resource's metafields, so a template that binds none makes no request. */
+export declare function templateReferencesSource(template: unknown, source: SettingBinding["source"]): boolean;
 /** Distinct numeric entry ids reached by field-bearing `product_metafield`
  * descriptors (bindings + both token forms). Unlike pinned entries these vary per
  * product, so the resolved `metafields` map (keyed `"ns.key"`, the shape
@@ -126,9 +205,10 @@ export declare function collectMetaobjectEntryIds(template: unknown): string[];
  * dereference each METAOBJECT_REFERENCE value to its entry GID. Shares both
  * resolve-time gates (`FIELD_KEY_RE` + `metaobjectRefEntryId`) with
  * `traverseMetaobjectReference` so the fetched set is exactly the resolvable
- * set. Empty on non-PDP loads (no product). */
+ * set. `source` names whose map `metafields` is (default the route product's);
+ * empty when that resource is absent from the load. */
 export declare function collectTraversedEntryIds(template: unknown, metafields: Record<string, {
   type: string;
   value: string;
-}>): string[];
+}>, source?: ResourceMetafieldSource): string[];
 //#endregion