@nakafa/aksara-contracts 0.27.0

package/dist/projection/spec.d.ts

@@ -0,0 +1,503 @@
+import { Schema } from "effect";
+/** Complete projection vocabulary backed by implemented content families. */
+export declare const ContentProjectionSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly articleRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly articleSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleSlug">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly category: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleCategory">;
+    readonly categoryRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly categoryTitle: Schema.Trimmed;
+    readonly kind: Schema.Literal<"article">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly official: Schema.Boolean;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly references: Schema.$Array<Schema.Struct<{
+        readonly authors: Schema.String;
+        readonly citation: Schema.optional<Schema.String>;
+        readonly details: Schema.optional<Schema.String>;
+        readonly publication: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+        readonly url: Schema.optional<Schema.String>;
+        readonly year: Schema.Finite;
+    }>>;
+    readonly sitemap: Schema.Literal<true>;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly materialKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialKey">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sectionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialSection">;
+    readonly kind: Schema.Literal<"subject-lesson">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly subject: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sitemap: Schema.Literal<true>;
+    readonly topicTitle: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly pageKey: Schema.brand<Schema.String, "@NakafaAI/AksaraPageKey">;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly kind: Schema.Literal<"public-page">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly description: Schema.Trimmed;
+        readonly title: Schema.Trimmed;
+    }>;
+    readonly sitemap: Schema.Literal<true>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly pageKey: Schema.brand<Schema.String, "@NakafaAI/AksaraPageKey">;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly kind: Schema.Literal<"public-page">;
+    readonly metadata: Schema.Struct<{
+        readonly description: Schema.Trimmed;
+        readonly lastModified: Schema.String;
+        readonly title: Schema.Trimmed;
+    }>;
+    readonly sitemap: Schema.Literal<true>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+}>]>, Schema.Union<readonly [Schema.Struct<{
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly peerContentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly questionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionKey">;
+    readonly questionNumber: Schema.Finite;
+    readonly setKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionSetKey">;
+    readonly bodyKind: Schema.Literal<"question">;
+    readonly blueprint: Schema.optionalKey<Schema.Struct<{
+        readonly cognitiveLevel: Schema.String;
+        readonly contentDomain: Schema.String;
+        readonly topic: Schema.String;
+    }>>;
+    readonly kind: Schema.Literal<"question-body">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly title: Schema.String;
+    }>;
+    readonly stimulusKey: Schema.optionalKey<Schema.String>;
+    readonly response: Schema.Union<readonly [Schema.Struct<{
+        readonly categories: Schema.$Array<Schema.Struct<{
+            readonly categoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+        }>>;
+        readonly kind: Schema.Literal<"category">;
+        readonly statements: Schema.$Array<Schema.Struct<{
+            readonly correctCategoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+            readonly statementKey: Schema.String;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"multiple-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"single-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>]>;
+}>, Schema.Struct<{
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly peerContentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly questionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionKey">;
+    readonly questionNumber: Schema.Finite;
+    readonly setKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionSetKey">;
+    readonly bodyKind: Schema.Literal<"answer">;
+    readonly blueprint: Schema.optionalKey<Schema.Struct<{
+        readonly cognitiveLevel: Schema.String;
+        readonly contentDomain: Schema.String;
+        readonly topic: Schema.String;
+    }>>;
+    readonly kind: Schema.Literal<"question-body">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly title: Schema.String;
+    }>;
+    readonly stimulusKey: Schema.optionalKey<Schema.String>;
+}>]>]>;
+export type ContentProjection = typeof ContentProjectionSchema.Type;
+/** Current projection vocabulary accepted for newly staged content. */
+export declare const CurrentContentProjectionSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly articleRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly articleSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleSlug">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly category: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleCategory">;
+    readonly categoryRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly categoryTitle: Schema.Trimmed;
+    readonly kind: Schema.Literal<"article">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly official: Schema.Boolean;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly references: Schema.$Array<Schema.Struct<{
+        readonly authors: Schema.String;
+        readonly citation: Schema.optional<Schema.String>;
+        readonly details: Schema.optional<Schema.String>;
+        readonly publication: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+        readonly url: Schema.optional<Schema.String>;
+        readonly year: Schema.Finite;
+    }>>;
+    readonly sitemap: Schema.Literal<true>;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly materialKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialKey">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sectionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialSection">;
+    readonly kind: Schema.Literal<"subject-lesson">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly subject: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sitemap: Schema.Literal<true>;
+    readonly topicTitle: Schema.String;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly pageKey: Schema.brand<Schema.String, "@NakafaAI/AksaraPageKey">;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly kind: Schema.Literal<"public-page">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly description: Schema.Trimmed;
+        readonly title: Schema.Trimmed;
+    }>;
+    readonly sitemap: Schema.Literal<true>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly peerContentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly questionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionKey">;
+    readonly questionNumber: Schema.Finite;
+    readonly setKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionSetKey">;
+    readonly bodyKind: Schema.Literal<"question">;
+    readonly blueprint: Schema.optionalKey<Schema.Struct<{
+        readonly cognitiveLevel: Schema.String;
+        readonly contentDomain: Schema.String;
+        readonly topic: Schema.String;
+    }>>;
+    readonly kind: Schema.Literal<"question-body">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly title: Schema.String;
+    }>;
+    readonly stimulusKey: Schema.optionalKey<Schema.String>;
+    readonly response: Schema.Union<readonly [Schema.Struct<{
+        readonly categories: Schema.$Array<Schema.Struct<{
+            readonly categoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+        }>>;
+        readonly kind: Schema.Literal<"category">;
+        readonly statements: Schema.$Array<Schema.Struct<{
+            readonly correctCategoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+            readonly statementKey: Schema.String;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"multiple-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"single-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>]>;
+}>, Schema.Struct<{
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly peerContentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly questionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionKey">;
+    readonly questionNumber: Schema.Finite;
+    readonly setKey: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionSetKey">;
+    readonly bodyKind: Schema.Literal<"answer">;
+    readonly blueprint: Schema.optionalKey<Schema.Struct<{
+        readonly cognitiveLevel: Schema.String;
+        readonly contentDomain: Schema.String;
+        readonly topic: Schema.String;
+    }>>;
+    readonly kind: Schema.Literal<"question-body">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly title: Schema.String;
+    }>;
+    readonly stimulusKey: Schema.optionalKey<Schema.String>;
+}>]>]>;
+export type CurrentContentProjection = typeof CurrentContentProjectionSchema.Type;
+/** Public-route projections accepted by Nakafa's path-based runtime seam. */
+export declare const RoutedContentProjectionSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly articleRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly articleSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleSlug">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly category: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleCategory">;
+    readonly categoryRouteSlug: Schema.brand<Schema.String, "@NakafaAI/AksaraArticleRouteSlug">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly categoryTitle: Schema.Trimmed;
+    readonly kind: Schema.Literal<"article">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly official: Schema.Boolean;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly references: Schema.$Array<Schema.Struct<{
+        readonly authors: Schema.String;
+        readonly citation: Schema.optional<Schema.String>;
+        readonly details: Schema.optional<Schema.String>;
+        readonly publication: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+        readonly url: Schema.optional<Schema.String>;
+        readonly year: Schema.Finite;
+    }>>;
+    readonly sitemap: Schema.Literal<true>;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly materialKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialKey">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sectionKey: Schema.brand<Schema.String, "@NakafaAI/AksaraMaterialSection">;
+    readonly kind: Schema.Literal<"subject-lesson">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly authors: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly subject: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>;
+    readonly parentPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly sitemap: Schema.Literal<true>;
+    readonly topicTitle: Schema.String;
+}>, Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly pageKey: Schema.brand<Schema.String, "@NakafaAI/AksaraPageKey">;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly kind: Schema.Literal<"public-page">;
+    readonly metadata: Schema.Struct<{
+        readonly dateModified: Schema.optionalKey<Schema.String>;
+        readonly datePublished: Schema.String;
+        readonly description: Schema.Trimmed;
+        readonly title: Schema.Trimmed;
+    }>;
+    readonly sitemap: Schema.Literal<true>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly artifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly contentKey: Schema.brand<Schema.String, "@NakafaAI/AksaraContentKey">;
+    readonly pageKey: Schema.brand<Schema.String, "@NakafaAI/AksaraPageKey">;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly kind: Schema.Literal<"public-page">;
+    readonly metadata: Schema.Struct<{
+        readonly description: Schema.Trimmed;
+        readonly lastModified: Schema.String;
+        readonly title: Schema.Trimmed;
+    }>;
+    readonly sitemap: Schema.Literal<true>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+}>]>]>;
+export type RoutedContentProjection = typeof RoutedContentProjectionSchema.Type;
+/** Returns the release family that owns one discriminated projection. */
+export declare function familyForProjection(projection: ContentProjection): "article" | "material" | "page" | "question";
+/** Returns public route ownership only for route-bearing projections. */
+export declare function projectionPublicPath(projection: ContentProjection): (string & import("effect/Brand").Brand<"@NakafaAI/AksaraPublicPath">) | undefined;
+/** Returns the exact compiled artifact locale owned by one projection. */
+export declare function projectionArtifactLocale(projection: ContentProjection): ("de" | "en" | "id") & import("effect/Brand").Brand<"@NakafaAI/AksaraArtifactLocale">;
+/** Serializes one projection through its exhaustive family-owned canonicalizer. */
+export declare function canonicalizeContentProjection(projection: ContentProjection): string;

package/dist/projection/spec.js

@@ -0,0 +1,56 @@
+import { Match, Schema } from "effect";
+import { ArticleProjectionSchema, canonicalizeArticleProjection, } from "#contracts/projection/article";
+import { canonicalizeMaterialProjection, MaterialLessonProjectionSchema, } from "#contracts/projection/material";
+import { canonicalizePublicPageProjection, PublicPageProjectionSchema, ReadablePublicPageProjectionSchema, } from "#contracts/projection/page";
+import { canonicalizeQuestionProjection, QuestionBodyProjectionSchema, } from "#contracts/projection/question";
+/** Complete projection vocabulary backed by implemented content families. */
+export const ContentProjectionSchema = Schema.Union([
+    ArticleProjectionSchema,
+    MaterialLessonProjectionSchema,
+    ReadablePublicPageProjectionSchema,
+    QuestionBodyProjectionSchema,
+]);
+/** Current projection vocabulary accepted for newly staged content. */
+export const CurrentContentProjectionSchema = Schema.Union([
+    ArticleProjectionSchema,
+    MaterialLessonProjectionSchema,
+    PublicPageProjectionSchema,
+    QuestionBodyProjectionSchema,
+]);
+/** Public-route projections accepted by Nakafa's path-based runtime seam. */
+export const RoutedContentProjectionSchema = Schema.Union([
+    ArticleProjectionSchema,
+    MaterialLessonProjectionSchema,
+    ReadablePublicPageProjectionSchema,
+]);
+const matchProjectionFamily = Match.type().pipe(Match.discriminatorsExhaustive("kind")({
+    article: () => "article",
+    "public-page": () => "page",
+    "question-body": () => "question",
+    "subject-lesson": () => "material",
+}));
+/** Returns the release family that owns one discriminated projection. */
+export function familyForProjection(projection) {
+    return matchProjectionFamily(projection);
+}
+/** Returns public route ownership only for route-bearing projections. */
+export function projectionPublicPath(projection) {
+    if (projection.kind === "question-body") {
+        return;
+    }
+    return projection.publicPath;
+}
+/** Returns the exact compiled artifact locale owned by one projection. */
+export function projectionArtifactLocale(projection) {
+    return projection.artifactLocale;
+}
+const matchCanonicalProjection = Match.type().pipe(Match.discriminatorsExhaustive("kind")({
+    article: canonicalizeArticleProjection,
+    "public-page": canonicalizePublicPageProjection,
+    "question-body": canonicalizeQuestionProjection,
+    "subject-lesson": canonicalizeMaterialProjection,
+}));
+/** Serializes one projection through its exhaustive family-owned canonicalizer. */
+export function canonicalizeContentProjection(projection) {
+    return matchCanonicalProjection(projection);
+}