@rimelight/cms 0.0.1

package/src/core/types/blocks.ts

@@ -0,0 +1,367 @@
+import type { InlineNode } from "./inline"
+
+export type BlockType =
+  | "SectionBlock"
+  | "ParagraphBlock"
+  | "CalloutBlock"
+  | "ImageBlock"
+  | "ScriptBlock"
+  | "SceneBlock"
+  | "DialogueBlock"
+  | "CodeBlock"
+  | "TableBlock"
+  | "TabsBlock"
+  | "TabItemBlock"
+  | "StepsBlock"
+  | "StepItemBlock"
+  | "CardsBlock"
+  | "CardBlock"
+  | "FileTreeBlock"
+  | (string & {})
+
+export type TimeOfDay = "MORNING" | "NOON" | "AFTERNOON" | "EVENING" | "NIGHT" | "OTHER"
+export type Setting = "INTERIOR" | "EXTERIOR" | "OTHER"
+export type Transition = "CUT_TO" | "CUT_BACK_TO" | "FADE_TO" | "NONE"
+
+export interface ScriptBlockProps {
+  title: string
+  synopsis: string
+  characters: string[]
+  aPlot: string
+  bPlot: string
+  cPlot: string
+  stinger: string
+}
+
+export interface SceneBlockProps {
+  location: string
+  timeOfDay: TimeOfDay
+  setting: Setting
+  transition: Transition
+  description: string
+}
+
+export interface DialogueBlockProps {
+  character: string
+  parenthetical?: string
+  line: string
+}
+
+export interface BaseBlock {
+  /**
+   * Unique UUID v4 identifier
+   */
+  id: string
+  type: BlockType
+
+  /**
+   * Structural Template Lock: If true, this block is a permanent template anchor and can NEVER be
+   * deleted, reordered, or removed.
+   */
+  isTemplated?: boolean
+
+  /**
+   * Property Content Lock: Controls whether block prop content can be edited. - boolean true: ALL
+   * properties of this block are locked from editing. - string[]: Specific property keys locked
+   * from editing (e.g. ["title", "disclaimer"]).
+   */
+  templatedProps?: boolean | string[]
+
+  allowedRoles?: string[]
+  requiredPermission?: string
+  props: Record<string, any>
+  children?: BaseBlock[]
+}
+
+// ─── Typed block prop interfaces ─────────────────────────────────────────────
+
+export type HeadingLevel = 2 | 3 | 4 | 5 | 6
+
+export const MIN_SECTION_HEADING_LEVEL: HeadingLevel = 2
+export const MAX_SECTION_HEADING_LEVEL: HeadingLevel = 6
+export const MAX_SECTION_DEPTH = 4 // Depth 0 -> H2, Depth 4 -> H6
+
+export function calculateHeadingLevel(sectionDepth: number): HeadingLevel {
+  const depth = Math.max(0, Math.floor(sectionDepth || 0))
+  return Math.min(MAX_SECTION_HEADING_LEVEL, depth + MIN_SECTION_HEADING_LEVEL) as HeadingLevel
+}
+
+export type CalloutVariant =
+  | "info"
+  | "success"
+  | "warning"
+  | "error"
+  | "commentary"
+  | "ideation"
+  | "source"
+
+export interface SectionBlockProps {
+  title: string
+  description?: string
+  level?: HeadingLevel
+  mainArticleSlug?: string
+  children: BaseBlock[]
+}
+
+export interface ParagraphBlockProps {
+  /**
+   * Stored as an InlineNode array (structured AST). Fallback: { en: string } or plain string.
+   */
+  text: InlineNode[] | { en: string } | string
+}
+
+export interface CalloutBlockProps {
+  variant: CalloutVariant
+  to?: string
+  target?: string
+  children: BaseBlock[]
+}
+
+export interface ImageBlockProps {
+  src: string
+  alt: string
+  caption?: string
+}
+
+export interface CodeBlockProps {
+  code: string
+  language: string
+  caption?: string
+  title?: string
+  filename?: string
+  showLineNumbers?: boolean
+  highlightLines?: number[]
+}
+
+export interface TableColumnDef {
+  key: string
+  header: string
+  align?: "left" | "center" | "right"
+}
+
+export interface TableBlockProps {
+  columns: TableColumnDef[]
+  rows: Record<string, string>[]
+  caption?: string
+}
+
+export interface TabItemBlockProps {
+  label: string
+  value?: string
+  icon?: string
+  children: BaseBlock[]
+}
+
+export interface TabsBlockProps {
+  defaultValue?: string
+  children: BaseBlock[]
+}
+
+export interface StepItemBlockProps {
+  title: string
+  description?: string
+  children: BaseBlock[]
+}
+
+export interface StepsBlockProps {
+  children: BaseBlock[]
+}
+
+export interface CardBlockProps {
+  title: string
+  description?: string
+  icon?: string
+  href?: string
+  badge?: string
+}
+
+export interface CardsBlockProps {
+  columns?: 1 | 2 | 3 | 4
+  children: BaseBlock[]
+}
+
+export interface FileTreeNode {
+  name: string
+  isDir?: boolean
+  children?: FileTreeNode[]
+  comment?: string
+}
+
+export interface FileTreeBlockProps {
+  tree: FileTreeNode[]
+}
+
+export interface TypedScriptBlockProps extends ScriptBlockProps {
+  children: BaseBlock[]
+}
+
+export interface TypedSceneBlockProps extends SceneBlockProps {
+  children: BaseBlock[]
+}
+
+// ─── Typed block discriminated union ─────────────────────────────────────────
+
+export interface SectionBlock extends BaseBlock {
+  type: "SectionBlock"
+  props: SectionBlockProps
+}
+
+export interface ParagraphBlock extends BaseBlock {
+  type: "ParagraphBlock"
+  props: ParagraphBlockProps
+}
+
+export interface CalloutBlock extends BaseBlock {
+  type: "CalloutBlock"
+  props: CalloutBlockProps
+}
+
+export interface ImageBlock extends BaseBlock {
+  type: "ImageBlock"
+  props: ImageBlockProps
+}
+
+export interface ScriptBlock extends BaseBlock {
+  type: "ScriptBlock"
+  props: TypedScriptBlockProps
+}
+
+export interface SceneBlock extends BaseBlock {
+  type: "SceneBlock"
+  props: TypedSceneBlockProps
+}
+
+export interface DialogueBlock extends BaseBlock {
+  type: "DialogueBlock"
+  props: DialogueBlockProps
+}
+
+export interface CodeBlock extends BaseBlock {
+  type: "CodeBlock"
+  props: CodeBlockProps
+}
+
+export interface TableBlock extends BaseBlock {
+  type: "TableBlock"
+  props: TableBlockProps
+}
+
+export interface TabsBlock extends BaseBlock {
+  type: "TabsBlock"
+  props: TabsBlockProps
+}
+
+export interface TabItemBlock extends BaseBlock {
+  type: "TabItemBlock"
+  props: TabItemBlockProps
+}
+
+export interface StepsBlock extends BaseBlock {
+  type: "StepsBlock"
+  props: StepsBlockProps
+}
+
+export interface StepItemBlock extends BaseBlock {
+  type: "StepItemBlock"
+  props: StepItemBlockProps
+}
+
+export interface CardsBlock extends BaseBlock {
+  type: "CardsBlock"
+  props: CardsBlockProps
+}
+
+export interface CardBlock extends BaseBlock {
+  type: "CardBlock"
+  props: CardBlockProps
+}
+
+export interface FileTreeBlock extends BaseBlock {
+  type: "FileTreeBlock"
+  props: FileTreeBlockProps
+}
+
+export type TypedBlock =
+  | SectionBlock
+  | ParagraphBlock
+  | CalloutBlock
+  | ImageBlock
+  | ScriptBlock
+  | SceneBlock
+  | DialogueBlock
+  | CodeBlock
+  | TableBlock
+  | TabsBlock
+  | TabItemBlock
+  | StepsBlock
+  | StepItemBlock
+  | CardsBlock
+  | CardBlock
+  | FileTreeBlock
+
+export const ALLOWED_CHILDREN_MAP: Record<string, BlockType[]> = {
+  Root: [
+    "SectionBlock",
+    "ParagraphBlock",
+    "CalloutBlock",
+    "ImageBlock",
+    "CodeBlock",
+    "ScriptBlock",
+    "SceneBlock",
+    "DialogueBlock",
+    "TableBlock",
+    "TabsBlock",
+    "StepsBlock",
+    "CardsBlock",
+    "FileTreeBlock"
+  ],
+  SectionBlock: [
+    "SectionBlock",
+    "ParagraphBlock",
+    "CalloutBlock",
+    "ImageBlock",
+    "CodeBlock",
+    "ScriptBlock",
+    "TableBlock",
+    "TabsBlock",
+    "StepsBlock",
+    "CardsBlock",
+    "FileTreeBlock"
+  ],
+  CalloutBlock: [
+    "ParagraphBlock",
+    "CalloutBlock",
+    "ImageBlock",
+    "CodeBlock",
+    "TableBlock",
+    "TabsBlock",
+    "StepsBlock",
+    "CardsBlock",
+    "FileTreeBlock"
+  ],
+  TabsBlock: ["TabItemBlock"],
+  TabItemBlock: [
+    "ParagraphBlock",
+    "CalloutBlock",
+    "ImageBlock",
+    "CodeBlock",
+    "TableBlock",
+    "StepsBlock",
+    "CardsBlock",
+    "FileTreeBlock"
+  ],
+  StepsBlock: ["StepItemBlock"],
+  StepItemBlock: [
+    "ParagraphBlock",
+    "CalloutBlock",
+    "ImageBlock",
+    "CodeBlock",
+    "TableBlock",
+    "TabsBlock",
+    "CardsBlock",
+    "FileTreeBlock"
+  ],
+  CardsBlock: ["CardBlock"],
+  ScriptBlock: ["SceneBlock"],
+  SceneBlock: ["ParagraphBlock", "CalloutBlock", "DialogueBlock"]
+}

package/src/core/types/inline.ts

@@ -0,0 +1,23 @@
+export type InlineNodeType = "text" | "page_mention" | "user_mention" | "link" | "emoji"
+
+export interface TextInlineNode {
+  type: "text"
+  text: string
+  marks?: Array<"bold" | "italic" | "underline" | "strikethrough" | "code">
+}
+
+export interface PageMentionNode {
+  type: "page_mention"
+  pageId: string
+  pageSlug: string
+  displayTitle?: string
+}
+
+export interface LinkInlineNode {
+  type: "link"
+  url: string
+  children: TextInlineNode[]
+  openInNewTab?: boolean
+}
+
+export type InlineNode = TextInlineNode | PageMentionNode | LinkInlineNode

package/src/core/types/pages.ts

@@ -0,0 +1,36 @@
+import type { BaseBlock } from "./blocks"
+
+export type Localized<T = string> = Record<string, T>
+
+export type PageType = "wiki" | "article" | "doc" | "announcement" | "landing" | (string & {})
+
+export interface RegisterPageTypes {
+  wiki: Record<string, any>
+  article: Record<string, any>
+  doc: Record<string, any>
+  announcement: Record<string, any>
+  landing: Record<string, any>
+  [key: string]: Record<string, any>
+}
+
+export interface PageMetadata {
+  id: string
+  slug: string
+  type: PageType
+  templateId?: string | null
+  templateVersion?: number
+  title: Localized
+  description?: Localized
+  tags?: Localized[]
+  authorIds?: string[]
+  publishedVersionId?: string | null
+  postedAt?: Date | null
+  createdAt?: Date
+  updatedAt?: Date
+  deletedAt?: Date | null
+}
+
+export interface PageContent<P = Record<string, any>> {
+  blocks: BaseBlock[]
+  properties: P
+}

package/src/core/types/templates.ts

@@ -0,0 +1,32 @@
+import type { BaseBlock } from "./blocks"
+import type { Localized, PageType } from "./pages"
+
+export interface TemplateApprovalRules {
+  minApprovals?: number
+  allowSelfApproval?: boolean
+  requiredRolesForApproval?: string[]
+}
+
+export interface TemplateRolePermissions {
+  whoCanCreate?: string[]
+  whoCanEdit?: string[]
+  whoCanReview?: string[]
+  whoCanView?: string[]
+}
+
+export interface PageTemplate {
+  id: string
+  slug: string
+  title: Localized
+  description?: Localized
+  pageType: PageType
+  version: number
+  allowedRoles: string[]
+  rolePermissions?: TemplateRolePermissions
+  requiredPermission?: string | null
+  approvalRules: TemplateApprovalRules
+  defaultProperties: Record<string, any>
+  initialBlocks: BaseBlock[]
+  createdAt?: Date
+  updatedAt?: Date
+}

package/src/core/types/versioning.ts

@@ -0,0 +1,44 @@
+import type { BaseBlock } from "./blocks"
+import type { Localized, PageType } from "./pages"
+
+export type PageVersionStatus = "pending" | "approved" | "rejected" | "published"
+
+export interface PageVersion {
+  id: string
+  pageId: string
+  versionNumber: number
+  status: PageVersionStatus
+  slug: string
+  type: PageType
+  title: Localized
+  description?: Localized
+  tags?: Localized[]
+  authorIds?: string[]
+  content: {
+    blocks: BaseBlock[]
+    properties: Record<string, any>
+  }
+  createdBy: string
+  approvedBy: string[]
+  approvedAt?: Date | null
+  changeSummary?: string | null
+  createdAt?: Date
+}
+
+export interface PageVersionComment {
+  id: string
+  versionId: string
+  userId: string
+  userRole: string
+  content: string
+  blockId?: string | null
+  createdAt?: Date
+}
+
+export interface PageVersionApproval {
+  id: string
+  versionId: string
+  userId: string
+  userRole: string
+  approvedAt?: Date
+}

package/src/core/validator.ts

@@ -0,0 +1,28 @@
+import type { BaseBlock } from "./types/blocks"
+
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
+
+export function isValidUUID(uuid: string): boolean {
+  return UUID_REGEX.test(uuid)
+}
+
+export function validateBlockAST(blocks: BaseBlock[]): { valid: boolean; errors: string[] } {
+  const errors: string[] = []
+
+  function checkBlocks(nodes: BaseBlock[]) {
+    for (const b of nodes) {
+      if (!b.id || typeof b.id !== "string" || !isValidUUID(b.id)) {
+        errors.push(`Block of type '${b.type}' has invalid UUID identifier: '${b.id}'`)
+      }
+      if (!b.type || typeof b.type !== "string") {
+        errors.push(`Block missing valid 'type' field`)
+      }
+      if (b.children && Array.isArray(b.children)) {
+        checkBlocks(b.children)
+      }
+    }
+  }
+
+  checkBlocks(blocks)
+  return { valid: errors.length === 0, errors }
+}

package/src/env.d.ts

@@ -0,0 +1,4 @@
+declare module "*.astro" {
+  const component: any
+  export default component
+}

package/src/index.ts

@@ -0,0 +1,47 @@
+// Core Types
+export * from "./core/types/blocks.ts"
+export * from "./core/types/inline.ts"
+export * from "./core/types/pages.ts"
+export * from "./core/types/templates.ts"
+export * from "./core/types/versioning.ts"
+export * from "./core/page-definitions.ts"
+
+// Re-export specific types for convenience
+export type {
+  TimeOfDay,
+  Setting,
+  Transition,
+  ScriptBlockProps,
+  SceneBlockProps,
+  DialogueBlockProps
+} from "./core/types/blocks.ts"
+
+// Core Services & Registries
+export * from "./core/registry.ts"
+export * from "./core/validator.ts"
+export * from "./core/template-sync.ts"
+
+// Auth & Security Guards
+export * from "./auth/permissions.ts"
+export * from "./auth/filter-blocks.ts"
+export * from "./auth/editor-guards.ts"
+export * from "./auth/filter-templates.ts"
+
+// Edge Cache & Search
+export * from "./cache/purge.ts"
+export * from "./search/query.ts"
+export * from "./search/sync.ts"
+
+// Database Schemas & Migration
+export * from "./schema/index.ts"
+export * from "./migration.ts"
+
+// Markdown Serialization & Parsing
+export * from "./markdown/index.ts"
+
+// Astro Components
+export { default as PageRenderer } from "./astro/PageRenderer.astro"
+export { default as BlockRenderer } from "./astro/BlockRenderer.astro"
+
+// Toast API
+export * from "./client/toast.ts"

package/src/markdown/index.ts

@@ -0,0 +1,2 @@
+export * from "./serializer.ts"
+export * from "./parser.ts"