@shop-on/theme-contract 0.5.0 → 0.7.0

package/dist/schemas.d.ts

@@ -19,6 +19,30 @@ export declare const SettingBinding: z.ZodDiscriminatedUnion<[z.ZodObject<{
   source: z.ZodLiteral<"collection_attribute">;
   attribute: z.ZodString;
   settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"collection_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"page_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"blog_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"article_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
   source: z.ZodLiteral<"page_attribute">;
   attribute: z.ZodString;
@@ -28,8 +52,55 @@ export declare const SettingBinding: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   source: z.ZodLiteral<"article_attribute">;
   attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_product_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_product_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_collection_attribute">;
+  attribute: z.ZodString;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_page_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_blog_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_article_attribute">;
+  attribute: z.ZodString;
 }, z.core.$strip>], "source">;
 export type SettingBinding = z.infer<typeof SettingBinding>;
+export declare const ClosestResource: z.ZodEnum<{
+  article: "article";
+  blog: "blog";
+  collection: "collection";
+  page: "page";
+  product: "product";
+}>;
+export type ClosestResource = z.infer<typeof ClosestResource>;
+export declare const CLOSEST_RESOURCES: ("article" | "blog" | "collection" | "page" | "product")[];
+export declare const ProviderDecl: z.ZodObject<{
+  from: z.ZodString;
+  each: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const THEME_FED = "$theme";
+export type ProviderDecl = z.infer<typeof ProviderDecl>;
+export declare const Provides: z.ZodRecord<z.ZodEnum<{
+  article: "article";
+  blog: "blog";
+  collection: "collection";
+  page: "page";
+  product: "product";
+}> & z.core.$partial, z.ZodObject<{
+  from: z.ZodString;
+  each: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;
+export type Provides = z.infer<typeof Provides>;
 export declare const SettingBindings: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
   source: z.ZodLiteral<"product_metafield">;
   namespace: z.ZodString;
@@ -48,6 +119,30 @@ export declare const SettingBindings: z.ZodRecord<z.ZodString, z.ZodDiscriminate
   source: z.ZodLiteral<"collection_attribute">;
   attribute: z.ZodString;
   settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"collection_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"page_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"blog_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"article_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  field: z.ZodOptional<z.ZodString>;
+  settingType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
   source: z.ZodLiteral<"page_attribute">;
   attribute: z.ZodString;
@@ -57,6 +152,27 @@ export declare const SettingBindings: z.ZodRecord<z.ZodString, z.ZodDiscriminate
 }, z.core.$strip>, z.ZodObject<{
   source: z.ZodLiteral<"article_attribute">;
   attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_product_metafield">;
+  namespace: z.ZodString;
+  key: z.ZodString;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_product_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_collection_attribute">;
+  attribute: z.ZodString;
+  settingType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_page_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_blog_attribute">;
+  attribute: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  source: z.ZodLiteral<"closest_article_attribute">;
+  attribute: z.ZodString;
 }, z.core.$strip>], "source">>;
 export type SettingBindings = z.infer<typeof SettingBindings>;
 export declare const SchemaSetting: z.ZodObject<{
@@ -237,6 +353,16 @@ export declare const SectionSchema: z.ZodObject<{
     settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     blocks: z.ZodOptional<z.ZodArray<z.ZodType<BlockDefinition, unknown, z.core.$ZodTypeInternals<BlockDefinition, unknown>>>>;
   }, z.core.$loose>>>;
+  provides: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+    article: "article";
+    blog: "blog";
+    collection: "collection";
+    page: "page";
+    product: "product";
+  }> & z.core.$partial, z.ZodObject<{
+    from: z.ZodString;
+    each: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>>;
 }, z.core.$loose>;
 export type SectionSchema = z.infer<typeof SectionSchema>;
 export declare const BlockSchema: z.ZodObject<{
@@ -270,6 +396,16 @@ export declare const BlockSchema: z.ZodObject<{
     settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     blocks: z.ZodOptional<z.ZodArray<z.ZodType<BlockDefinition, unknown, z.core.$ZodTypeInternals<BlockDefinition, unknown>>>>;
   }, z.core.$loose>>>;
+  provides: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+    article: "article";
+    blog: "blog";
+    collection: "collection";
+    page: "page";
+    product: "product";
+  }> & z.core.$partial, z.ZodObject<{
+    from: z.ZodString;
+    each: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>>;
 }, z.core.$loose>;
 export type BlockSchema = z.infer<typeof BlockSchema>;
 export type TemplateBlock = {
@@ -287,7 +423,16 @@ export type TemplateBlock = {
   appId?: string;
   tag?: string;
   scriptUrl?: string;
+  closestSettings?: Record<string, Record<string, unknown>>;
 };
+/** A `$theme` list's per-item values for a batch of its items: block-id path
+ * below the provider (the `each` id first, joined with `/`) → item handle →
+ * settings. `resolveListOverlays` (@shop-on/theme-loader) builds it,
+ * `withClosestOverlays` (@shop-on/theme-react) merges it into
+ * `closestSettings`. Strings only: a closest source binds string sinks alone
+ * (text, textarea, inline_richtext, richtext, color, url), which is also what
+ * lets a server fn return it. */
+export type ClosestOverlays = Record<string, Record<string, Record<string, string>>>;
 export declare const TemplateBlock: z.ZodType<TemplateBlock>;
 export declare const TemplateSection: z.ZodObject<{
   type: z.ZodString;
@@ -310,6 +455,30 @@ export declare const TemplateSection: z.ZodObject<{
     source: z.ZodLiteral<"collection_attribute">;
     attribute: z.ZodString;
     settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"collection_metafield">;
+    namespace: z.ZodString;
+    key: z.ZodString;
+    field: z.ZodOptional<z.ZodString>;
+    settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"page_metafield">;
+    namespace: z.ZodString;
+    key: z.ZodString;
+    field: z.ZodOptional<z.ZodString>;
+    settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"blog_metafield">;
+    namespace: z.ZodString;
+    key: z.ZodString;
+    field: z.ZodOptional<z.ZodString>;
+    settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"article_metafield">;
+    namespace: z.ZodString;
+    key: z.ZodString;
+    field: z.ZodOptional<z.ZodString>;
+    settingType: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>, z.ZodObject<{
     source: z.ZodLiteral<"page_attribute">;
     attribute: z.ZodString;
@@ -319,6 +488,27 @@ export declare const TemplateSection: z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     source: z.ZodLiteral<"article_attribute">;
     attribute: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_product_metafield">;
+    namespace: z.ZodString;
+    key: z.ZodString;
+    settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_product_attribute">;
+    attribute: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_collection_attribute">;
+    attribute: z.ZodString;
+    settingType: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_page_attribute">;
+    attribute: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_blog_attribute">;
+    attribute: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"closest_article_attribute">;
+    attribute: z.ZodString;
   }, z.core.$strip>], "source">>>;
   disabled: z.ZodOptional<z.ZodBoolean>;
   customName: z.ZodOptional<z.ZodString>;
@@ -356,6 +546,30 @@ export declare const Template: z.ZodObject<{
       source: z.ZodLiteral<"collection_attribute">;
       attribute: z.ZodString;
       settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"collection_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"page_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"blog_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"article_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
       source: z.ZodLiteral<"page_attribute">;
       attribute: z.ZodString;
@@ -365,6 +579,27 @@ export declare const Template: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
       source: z.ZodLiteral<"article_attribute">;
       attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_product_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_product_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_collection_attribute">;
+      attribute: z.ZodString;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_page_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_blog_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_article_attribute">;
+      attribute: z.ZodString;
     }, z.core.$strip>], "source">>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     customName: z.ZodOptional<z.ZodString>;
@@ -401,6 +636,30 @@ export declare const Template: z.ZodObject<{
         source: z.ZodLiteral<"collection_attribute">;
         attribute: z.ZodString;
         settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"collection_metafield">;
+        namespace: z.ZodString;
+        key: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"page_metafield">;
+        namespace: z.ZodString;
+        key: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"blog_metafield">;
+        namespace: z.ZodString;
+        key: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"article_metafield">;
+        namespace: z.ZodString;
+        key: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        settingType: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>, z.ZodObject<{
         source: z.ZodLiteral<"page_attribute">;
         attribute: z.ZodString;
@@ -410,6 +669,27 @@ export declare const Template: z.ZodObject<{
       }, z.core.$strip>, z.ZodObject<{
         source: z.ZodLiteral<"article_attribute">;
         attribute: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_product_metafield">;
+        namespace: z.ZodString;
+        key: z.ZodString;
+        settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_product_attribute">;
+        attribute: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_collection_attribute">;
+        attribute: z.ZodString;
+        settingType: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_page_attribute">;
+        attribute: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_blog_attribute">;
+        attribute: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        source: z.ZodLiteral<"closest_article_attribute">;
+        attribute: z.ZodString;
       }, z.core.$strip>], "source">>>;
       disabled: z.ZodOptional<z.ZodBoolean>;
       customName: z.ZodOptional<z.ZodString>;
@@ -449,6 +729,30 @@ export declare const SectionGroup: z.ZodObject<{
       source: z.ZodLiteral<"collection_attribute">;
       attribute: z.ZodString;
       settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"collection_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"page_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"blog_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"article_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      field: z.ZodOptional<z.ZodString>;
+      settingType: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
       source: z.ZodLiteral<"page_attribute">;
       attribute: z.ZodString;
@@ -458,6 +762,27 @@ export declare const SectionGroup: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
       source: z.ZodLiteral<"article_attribute">;
       attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_product_metafield">;
+      namespace: z.ZodString;
+      key: z.ZodString;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_product_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_collection_attribute">;
+      attribute: z.ZodString;
+      settingType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_page_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_blog_attribute">;
+      attribute: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      source: z.ZodLiteral<"closest_article_attribute">;
+      attribute: z.ZodString;
     }, z.core.$strip>], "source">>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     customName: z.ZodOptional<z.ZodString>;

package/dist/schemas.js

@@ -1,13 +1,16 @@
 import { z } from "zod";
 //#region src/schemas.ts
-const SettingBinding = z.discriminatedUnion("source", [
-	z.object({
-		source: z.literal("product_metafield"),
+function resourceMetafieldArm(source) {
+	return z.object({
+		source: z.literal(source),
 		namespace: z.string(),
 		key: z.string(),
 		field: z.string().optional(),
 		settingType: z.string().optional()
-	}),
+	});
+}
+const SettingBinding = z.discriminatedUnion("source", [
+	resourceMetafieldArm("product_metafield"),
 	z.object({
 		source: z.literal("product_attribute"),
 		attribute: z.string()
@@ -23,6 +26,10 @@ const SettingBinding = z.discriminatedUnion("source", [
 		attribute: z.string(),
 		settingType: z.string().optional()
 	}),
+	resourceMetafieldArm("collection_metafield"),
+	resourceMetafieldArm("page_metafield"),
+	resourceMetafieldArm("blog_metafield"),
+	resourceMetafieldArm("article_metafield"),
 	z.object({
 		source: z.literal("page_attribute"),
 		attribute: z.string()
@@ -34,8 +41,49 @@ const SettingBinding = z.discriminatedUnion("source", [
 	z.object({
 		source: z.literal("article_attribute"),
 		attribute: z.string()
+	}),
+	z.object({
+		source: z.literal("closest_product_metafield"),
+		namespace: z.string(),
+		key: z.string(),
+		settingType: z.string().optional()
+	}),
+	z.object({
+		source: z.literal("closest_product_attribute"),
+		attribute: z.string()
+	}),
+	z.object({
+		source: z.literal("closest_collection_attribute"),
+		attribute: z.string(),
+		settingType: z.string().optional()
+	}),
+	z.object({
+		source: z.literal("closest_page_attribute"),
+		attribute: z.string()
+	}),
+	z.object({
+		source: z.literal("closest_blog_attribute"),
+		attribute: z.string()
+	}),
+	z.object({
+		source: z.literal("closest_article_attribute"),
+		attribute: z.string()
 	})
 ]);
+const ClosestResource = z.enum([
+	"product",
+	"collection",
+	"page",
+	"blog",
+	"article"
+]);
+const CLOSEST_RESOURCES = ClosestResource.options;
+const ProviderDecl = z.object({
+	from: z.string(),
+	each: z.array(z.string())
+});
+const THEME_FED = "$theme";
+const Provides = z.partialRecord(ClosestResource, ProviderDecl);
 const SettingBindings = z.record(z.string(), SettingBinding);
 const SchemaSetting = z.object({
 	type: z.string(),
@@ -96,7 +144,8 @@ const SectionSchema = z.object({
 	settings: z.array(SchemaSetting).default([]),
 	blocks: z.array(BlockDefinition).default([]),
 	max_blocks: z.number().optional(),
-	presets: z.array(SectionPreset).optional()
+	presets: z.array(SectionPreset).optional(),
+	provides: Provides.optional()
 }).passthrough();
 const BlockSchema = z.object({
 	name: z.string().optional(),
@@ -104,7 +153,8 @@ const BlockSchema = z.object({
 	blocks: z.array(BlockDefinition).optional(),
 	max_blocks: z.number().optional(),
 	previewable: z.boolean().optional(),
-	presets: z.array(SectionPreset).optional()
+	presets: z.array(SectionPreset).optional(),
+	provides: Provides.optional()
 }).passthrough();
 const TemplateBlock = z.lazy(() => z.object({
 	type: z.string(),
@@ -155,4 +205,4 @@ const SectionGroup = z.object({
 	order: z.array(z.string()).default([])
 }).passthrough();
 //#endregion
-export { BlockDefinition, BlockSchema, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, Template, TemplateBlock, TemplateSection };
+export { BlockDefinition, BlockSchema, CLOSEST_RESOURCES, ClosestResource, ProviderDecl, Provides, SchemaSetting, SectionGroup, SectionPreset, SectionSchema, SettingBinding, SettingBindings, SettingsData, SettingsSchema, SettingsSchemaSection, THEME_FED, Template, TemplateBlock, TemplateSection };

package/dist/section-scope.d.ts

@@ -0,0 +1,17 @@
+//#region src/section-scope.d.ts
+type SectionPlacement = {
+  enabled_on?: {
+    groups?: string[];
+    templates?: string[];
+  };
+  disabled_on?: {
+    groups?: string[];
+    templates?: string[];
+  };
+};
+export declare function templateMatches(pattern: string, id: string): boolean;
+export declare function isSectionEnabledOnTemplate(schema: SectionPlacement, templateId: string): boolean;
+export declare function isSectionAddableInGroup(schema: SectionPlacement, groupType: string): boolean;
+export declare function isSectionAllowedInGroup(schema: SectionPlacement, groupType: string): boolean;
+//#endregion
+export {};

package/dist/section-scope.js

@@ -0,0 +1,22 @@
+//#region src/section-scope.ts
+function templateMatches(pattern, id) {
+	return pattern.endsWith(".*") ? id.startsWith(pattern.slice(0, -1)) : pattern === id;
+}
+function isSectionEnabledOnTemplate(schema, templateId) {
+	if (schema.enabled_on?.groups?.length) return false;
+	if (schema.disabled_on?.templates?.includes("*")) return false;
+	if (schema.enabled_on?.templates?.length) return schema.enabled_on.templates.some((pattern) => templateMatches(pattern, templateId));
+	return true;
+}
+function isSectionAddableInGroup(schema, groupType) {
+	return schema.enabled_on?.groups?.includes(groupType) ?? false;
+}
+function isSectionAllowedInGroup(schema, groupType) {
+	const disabledGroups = schema.disabled_on?.groups;
+	if (disabledGroups?.includes("*") || disabledGroups?.includes(groupType)) return false;
+	if (schema.enabled_on?.groups?.length) return schema.enabled_on.groups.includes(groupType);
+	if (schema.enabled_on?.templates?.length) return false;
+	return true;
+}
+//#endregion
+export { isSectionAddableInGroup, isSectionAllowedInGroup, isSectionEnabledOnTemplate, templateMatches };

package/dist/store-path.d.ts

@@ -1,4 +1,13 @@
 //#region src/store-path.d.ts
 export declare const STORE_SLUG_RE: RegExp;
 export declare const INSTALL_ID_RE: RegExp;
+/** Hash field marking an orchestrator draft hash as seeded, so an install with
+ *  zero templates or groups still has the key. Never a template id or group type. */
+export declare const DRAFT_SEEDED_KEY = "__seeded";
+/**
+ * True unless `id` is safe as one file name under a config dir (template,
+ * section group, layout). It is joined into a disk path, so `..` and
+ * separators must never pass.
+ */
+export declare function invalidTemplateId(id: string | undefined): boolean;
 //#endregion

package/dist/store-path.js

@@ -1,5 +1,17 @@
 //#region src/store-path.ts
 const STORE_SLUG_RE = /^[a-z0-9][a-z0-9-]{0,62}$/;
 const INSTALL_ID_RE = /^[a-z0-9_-]{4,32}$/;
+/** Hash field marking an orchestrator draft hash as seeded, so an install with
+*  zero templates or groups still has the key. Never a template id or group type. */
+const DRAFT_SEEDED_KEY = "__seeded";
+const TEMPLATE_ID_RE = /^[A-Za-z0-9_.-]+$/;
+/**
+* True unless `id` is safe as one file name under a config dir (template,
+* section group, layout). It is joined into a disk path, so `..` and
+* separators must never pass.
+*/
+function invalidTemplateId(id) {
+	return !id || !TEMPLATE_ID_RE.test(id) || /[/\\]|\.\./.test(id);
+}
 //#endregion
-export { INSTALL_ID_RE, STORE_SLUG_RE };
+export { DRAFT_SEEDED_KEY, INSTALL_ID_RE, STORE_SLUG_RE, invalidTemplateId };

package/dist/template-limits.d.ts

@@ -0,0 +1,34 @@
+//#region src/template-limits.d.ts
+export declare const MAX_SECTIONS_PER_TEMPLATE = 25;
+export declare const MAX_BLOCKS_PER_TEMPLATE = 1250;
+export declare const MAX_BLOCK_NESTING_DEPTH = 8;
+/** One template or section group, as compact JSON. The largest a shipped
+ *  theme has is ~60 KB; a template at the block cap is ~250–500 KB. */
+export declare const MAX_ENTRY_BYTES: number;
+/** The blocks under `node` (a section or a block), at every depth. */
+export declare function countNestedBlocks(node: unknown): number;
+/** A template's or section group's sections (its `order`, as the editor
+ *  counts them) and its blocks across every section. Both are
+ *  `{sections, order}` documents. */
+export declare function templateCounts(entry: unknown): {
+  sections: number;
+  blocks: number;
+};
+/** The deepest block level in a template or section group, as the editor
+ *  counts it against `MAX_BLOCK_NESTING_DEPTH`: a block directly in a section
+ *  is level 1, a section with no blocks is 0. */
+export declare function maxBlockDepth(entry: unknown): number;
+export declare function countBlocksInBlock(block: unknown): number;
+/** 1-indexed depth of the deepest descendant within `block` (the block itself
+ *  counts as 1). Prices a subtree about to be inserted against the nesting cap. */
+export declare function maxDepthOfBlock(block: {
+  blocks?: Record<string, unknown>;
+}): number;
+export declare function maxDepthOfBlockSchema(blockType: string, blockSchemas: readonly {
+  type?: string;
+  blocks?: {
+    type: string;
+    static?: boolean;
+  }[];
+}[], remaining?: number): number;
+//#endregion