@kubuild/schema 0.8.0 → 0.8.2

package/dist/json-schema.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.cts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.cts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const ManifestAssetItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    checksum: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestAssetItem = z.infer<typeof ManifestAssetItemSchema>;
+export declare const ManifestSchema: z.ZodObject<{
+    schema: z.ZodDefault<z.ZodLiteral<"stora.page">>;
+    schemaVersion: z.ZodDefault<z.ZodString>;
+    packageVersion: z.ZodDefault<z.ZodString>;
+    builderCompatibility: z.ZodDefault<z.ZodString>;
+    requiredComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    assets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        mimeType: z.ZodString;
+        size: z.ZodNumber;
+        checksum: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Manifest = z.infer<typeof ManifestSchema>;
+export declare function isManifest(value: unknown): value is Manifest;
+//# sourceMappingURL=manifest.d.cts.map

package/dist/manifest.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.cts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;iBASzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/template.d.cts

@@ -0,0 +1,213 @@
+import { z } from 'zod';
+import { type AssetReference } from './document.cjs';
+/**
+ * Validates a string as a safe URL or safe asset path.
+ */
+export declare function isSafeThumbnailUrl(url: string): boolean;
+/**
+ * Safe Thumbnail URL String Schema
+ */
+export declare const SafeThumbnailUrlSchema: z.ZodString;
+/**
+ * Safe Thumbnail Object Schema
+ */
+export declare const SafeThumbnailObjectSchema: z.ZodObject<{
+    url: z.ZodString;
+    alt: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SafeThumbnailObject = z.infer<typeof SafeThumbnailObjectSchema>;
+/**
+ * Safe Thumbnail Schema (AssetReference | safe URL string | safe thumbnail object)
+ */
+export declare const SafeThumbnailSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"asset">;
+    assetId: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    fallbackUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    url: z.ZodString;
+    alt: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodString]>;
+export type SafeThumbnail = AssetReference | SafeThumbnailObject | string;
+/**
+ * Template Package Reference Schema
+ * Points to an external or archived .stora / JSON package file.
+ */
+export declare const TemplatePackageRefSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    checksum: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        stora: "stora";
+    }>>;
+}, z.core.$strip>;
+export type TemplatePackageRef = z.infer<typeof TemplatePackageRefSchema>;
+/**
+ * Template Requirements Schema
+ * Declares custom components and host capabilities required by this template.
+ */
+export declare const TemplateRequirementsSchema: z.ZodObject<{
+    requiredComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TemplateRequirements = z.infer<typeof TemplateRequirementsSchema>;
+/**
+ * Template Record Schema v1
+ * Represents a reusable page template with full metadata, safe thumbnail,
+ * component/capability requirements, and snapshot document / package reference.
+ */
+export declare const TemplateRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    thumbnail: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"asset">;
+        assetId: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        fallbackUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodString]>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    document: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodLiteral<"stora.page">;
+        version: z.ZodDefault<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            title: z.ZodDefault<z.ZodString>;
+            description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            createdAt: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            tracking: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    client_only: "client_only";
+                    server_only: "server_only";
+                }>>>;
+                providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                    meta: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    google: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    gtm: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    tiktok: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    custom: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        tracking: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                client_only: "client_only";
+                server_only: "server_only";
+            }>>>;
+            providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                meta: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                google: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                gtm: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                tiktok: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                custom: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        theme: z.ZodOptional<z.ZodObject<{
+            colors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            fonts: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        }, z.core.$strip>>;
+        document: z.ZodType<import("./document.cjs").RootPageNode, unknown, z.core.$ZodTypeInternals<import("./document.cjs").RootPageNode, unknown>>;
+    }, z.core.$strip>>;
+    packageReference: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        checksum: z.ZodOptional<z.ZodString>;
+        format: z.ZodDefault<z.ZodEnum<{
+            json: "json";
+            stora: "stora";
+        }>>;
+    }, z.core.$strip>>;
+    requirements: z.ZodDefault<z.ZodObject<{
+        requiredComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TemplateRecord = z.infer<typeof TemplateRecordSchema>;
+/**
+ * Type guard for TemplateRecord
+ */
+export declare function isTemplateRecord(value: unknown): value is TemplateRecord;
+/**
+ * Type guard for SafeThumbnail
+ */
+export declare function isSafeThumbnail(value: unknown): value is SafeThumbnail;
+//# sourceMappingURL=template.d.cts.map

package/dist/template.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.cts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4C,KAAK,cAAc,EAAqB,MAAM,eAAe,CAAC;AASjH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;gCAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/template.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type AssetReference } from './document';
+import { type AssetReference } from './document.js';
 /**
  * Validates a string as a safe URL or safe asset path.
  */
@@ -182,7 +182,7 @@ export declare const TemplateRecordSchema: z.ZodObject<{
             radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
             spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         }, z.core.$strip>>;
-        document: z.ZodType<import("./document").RootPageNode, unknown, z.core.$ZodTypeInternals<import("./document").RootPageNode, unknown>>;
+        document: z.ZodType<import("./document.js").RootPageNode, unknown, z.core.$ZodTypeInternals<import("./document.js").RootPageNode, unknown>>;
     }, z.core.$strip>>;
     packageReference: z.ZodOptional<z.ZodObject<{
         path: z.ZodOptional<z.ZodString>;

package/dist/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4C,KAAK,cAAc,EAAqB,MAAM,YAAY,CAAC;AAS9G;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;gCAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4C,KAAK,cAAc,EAAqB,MAAM,eAAe,CAAC;AASjH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;gCAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/theme.d.cts

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+/**
+ * Document Theme / Design Tokens (STORA-551)
+ *
+ * A theme is a small, portable set of named design tokens stored on the document
+ * (`PageDocument.theme`). The renderer emits every token as a CSS custom property on
+ * the page root, and node styles reference tokens with a plain CSS `var()` string:
+ *
+ *   styles.base.backgroundColor = 'var(--kb-color-primary)'
+ *
+ * Because the reference is an ordinary CSS value it passes the existing style
+ * validation, renders unchanged in inline styles, generated CSS and exported HTML,
+ * and falls back gracefully (to the property's initial value) when a token is absent.
+ *
+ * Token groups map to custom-property prefixes:
+ *   colors  -> --kb-color-<key>
+ *   fonts   -> --kb-font-<key>
+ *   radii   -> --kb-radius-<key>
+ *   spacing -> --kb-space-<key>
+ *
+ * Security: token keys are restricted to a safe identifier alphabet and token values
+ * are screened like style values, and additionally may not contain characters that can
+ * terminate a CSS declaration/rule or open markup (`; { } < > \`), since values end up
+ * inside a `<style>` block in generated HTML.
+ */
+export declare const THEME_TOKEN_GROUPS: readonly ["colors", "fonts", "radii", "spacing"];
+export type ThemeTokenGroup = (typeof THEME_TOKEN_GROUPS)[number];
+/** CSS custom-property prefix per token group. */
+export declare const THEME_TOKEN_CSS_PREFIX: Readonly<Record<ThemeTokenGroup, string>>;
+/** True when `key` can be used as a theme token key (and custom-property suffix). */
+export declare function isSafeThemeTokenKey(key: unknown): key is string;
+/**
+ * True when `value` is safe to emit as a CSS custom-property value. Numbers are allowed
+ * (finite only); strings must be short and free of injection vectors.
+ */
+export declare function isSafeThemeTokenValue(value: unknown): value is string | number;
+export declare const ThemeTokenKeySchema: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+export declare const ThemeTokenValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+export type ThemeTokenValue = z.infer<typeof ThemeTokenValueSchema>;
+export declare const ThemeTokenMapSchema: z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+export type ThemeTokenMap = Record<string, ThemeTokenValue>;
+export declare const ThemeSchema: z.ZodObject<{
+    colors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    fonts: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+}, z.core.$strip>;
+export type Theme = z.infer<typeof ThemeSchema>;
+/**
+ * Builds the custom-property name for a token, e.g. `('colors', 'primary')` ->
+ * `--kb-color-primary`. Returns `null` for unsafe keys.
+ */
+export declare function themeTokenCssVarName(group: ThemeTokenGroup, key: string): string | null;
+/**
+ * Builds the style value that references a token, e.g. `var(--kb-color-primary)`.
+ * This is the canonical token reference format stored in node styles.
+ */
+export declare function themeTokenRef(group: ThemeTokenGroup, key: string): string;
+/**
+ * Parses a token reference style value back into `{ group, key }`, or `null` when the
+ * value is not a theme token reference.
+ */
+export declare function parseThemeTokenRef(value: unknown): {
+    group: ThemeTokenGroup;
+    key: string;
+} | null;
+/**
+ * Merges theme layers left-to-right (later layers win per token). Used to apply a host
+ * runtime override on top of the document theme without mutating either. Unsafe tokens in
+ * any layer are skipped, so an invalid override never clobbers a valid lower-layer value.
+ */
+export declare function mergeThemes(...layers: Array<Partial<Theme> | undefined | null>): Theme;
+/**
+ * Flattens a theme into `[customPropertyName, value]` pairs, silently dropping any
+ * token whose key or value is unsafe. Safe to call on unvalidated input (e.g. a host
+ * runtime override), which is why it re-checks every entry.
+ */
+export declare function themeToCssVariables(theme: Partial<Theme> | undefined | null): Array<[string, string]>;
+export declare function isTheme(value: unknown): value is Theme;
+//# sourceMappingURL=theme.d.cts.map

package/dist/theme.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.cts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,kBAAkB,kDAAmD,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAK3E,CAAC;AAQH,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,CAO9E;AAED,eAAO,MAAM,mBAAmB,mFAG9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,iDAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,iJAAuD,CAAC;AAExF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE5D,eAAO,MAAM,WAAW;;;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMzE;AAWD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKjG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,KAAK,CActF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,GACvC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkBzB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD"}