@bettercms-ai/types 1.5.0

package/README.md

@@ -0,0 +1,18 @@
+# @bettercms-ai/types
+
+Pure TypeScript type definitions for BetterCMS.
+
+## Installation
+
+```bash
+npm install @bettercms-ai/types --registry=https://npm.pkg.github.com/
+```
+
+## Usage
+
+```typescript
+import type { Workspace, Page, ContentBlock } from "@bettercms-ai/types"
+```
+
+## License
+Private - bettercms.ai

package/dist/index.d.ts

@@ -0,0 +1,652 @@
+/**
+ * Workspace — a top-level container for a CMS project/tenant.
+ * Each workspace has its own content, pages, and API keys.
+ */
+interface Workspace {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string;
+    domain?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Page — a published content page within a workspace.
+ */
+interface Page {
+    id: string;
+    workspaceId: string;
+    slug: string;
+    title: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    isPublished: boolean;
+    publishedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * ContentBlock — a discriminated union of all CMS block types.
+ * Each block has a `type` discriminator and a `props` object
+ * whose shape matches the block type.
+ */
+type SpaceToken = "none" | "xs" | "sm" | "md" | "lg" | "xl";
+type ColorToken = "none" | "white" | "black" | "muted" | "mutedBg" | "primary" | "accent";
+type AlignToken = "left" | "center" | "right";
+type FontSizeToken = "sm" | "base" | "lg" | "xl" | "2xl";
+type WeightToken = "normal" | "medium" | "semibold" | "bold";
+type RadiusToken = "none" | "sm" | "md" | "lg" | "full";
+interface BlockStyle {
+    paddingY?: SpaceToken;
+    paddingX?: SpaceToken;
+    marginTop?: SpaceToken;
+    marginBottom?: SpaceToken;
+    background?: ColorToken;
+    textColor?: ColorToken;
+    align?: AlignToken;
+    fontSize?: FontSizeToken;
+    weight?: WeightToken;
+    radius?: RadiusToken;
+}
+interface HeadingProps {
+    text: string;
+    level?: 1 | 2 | 3;
+}
+interface HeadingBlock {
+    type: "heading";
+    id: string;
+    style?: BlockStyle;
+    props: HeadingProps;
+}
+interface TextProps {
+    html: string;
+}
+interface TextBlock {
+    type: "text";
+    id: string;
+    style?: BlockStyle;
+    props: TextProps;
+}
+interface ImageProps {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+    caption?: string;
+}
+interface ImageBlock {
+    type: "image";
+    id: string;
+    style?: BlockStyle;
+    props: ImageProps;
+}
+interface ButtonProps {
+    text: string;
+    href: string;
+    variant?: "primary" | "secondary";
+}
+interface ButtonBlock {
+    type: "button";
+    id: string;
+    style?: BlockStyle;
+    props: ButtonProps;
+}
+interface SpacerProps {
+    height: number;
+}
+interface SpacerBlock {
+    type: "spacer";
+    id: string;
+    style?: BlockStyle;
+    props: SpacerProps;
+}
+interface ColumnsProps {
+    columns: ContentBlock[][];
+    gap?: number;
+}
+interface ColumnsBlock {
+    type: "columns";
+    id: string;
+    style?: BlockStyle;
+    props: ColumnsProps;
+}
+interface VideoProps {
+    url: string;
+    poster?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+}
+interface VideoBlock {
+    type: "video";
+    id: string;
+    style?: BlockStyle;
+    props: VideoProps;
+}
+interface FormProps {
+    formId: string;
+}
+interface FormBlock {
+    type: "form";
+    id: string;
+    style?: BlockStyle;
+    props: FormProps;
+}
+interface SectionProps {
+    children: ContentBlock[];
+    background?: string;
+    paddingY?: number;
+    maxWidth?: number;
+}
+interface SectionBlock {
+    type: "section";
+    id: string;
+    style?: BlockStyle;
+    props: SectionProps;
+}
+interface NavLink {
+    label: string;
+    href: string;
+}
+interface NavbarProps {
+    logo?: {
+        src: string;
+        alt: string;
+        href?: string;
+    };
+    links: NavLink[];
+    cta?: {
+        text: string;
+        href: string;
+    };
+}
+interface NavbarBlock {
+    type: "navbar";
+    id: string;
+    style?: BlockStyle;
+    props: NavbarProps;
+}
+interface FooterColumn {
+    heading?: string;
+    links: NavLink[];
+}
+interface FooterProps {
+    columns: FooterColumn[];
+    copyright?: string;
+}
+interface FooterBlock {
+    type: "footer";
+    id: string;
+    style?: BlockStyle;
+    props: FooterProps;
+}
+interface SlideItem {
+    id: string;
+    children: ContentBlock[];
+}
+interface SliderProps {
+    slides: SlideItem[];
+    autoplay?: boolean;
+    interval?: number;
+    loop?: boolean;
+}
+interface SliderBlock {
+    type: "slider";
+    id: string;
+    style?: BlockStyle;
+    props: SliderProps;
+}
+interface TabItem {
+    id: string;
+    label: string;
+    children: ContentBlock[];
+}
+interface TabsProps {
+    tabs: TabItem[];
+}
+interface TabsBlock {
+    type: "tabs";
+    id: string;
+    style?: BlockStyle;
+    props: TabsProps;
+}
+interface ComponentProps {
+    componentId: string;
+    overrides?: Record<string, unknown>;
+}
+interface ComponentBlock {
+    type: "component";
+    id: string;
+    style?: BlockStyle;
+    props: ComponentProps;
+}
+type ContentBlock = HeadingBlock | TextBlock | ImageBlock | ButtonBlock | SpacerBlock | ColumnsBlock | VideoBlock | FormBlock | SectionBlock | NavbarBlock | FooterBlock | SliderBlock | TabsBlock | ComponentBlock;
+/** Literal union of all block type discriminators. */
+type BlockType = ContentBlock["type"];
+/**
+ * Type guard — narrows an unknown block to `ContentBlock`.
+ *
+ * @example
+ * const block = maybeBlock as unknown;
+ * if (isBlock(block)) {
+ *   // block is ContentBlock here
+ * }
+ */
+declare function isBlock(value: unknown): value is ContentBlock;
+/**
+ * Extract the `type` discriminator from a block, or `null` if not a block.
+ *
+ * @example
+ * const block = { type: "heading", id: "1", props: { text: "Hi" } };
+ * getBlockType(block); // "heading"
+ * getBlockType({ not: "a block" }); // null
+ */
+declare function getBlockType(value: unknown): BlockType | null;
+
+/**
+ * FLO-264 — bounded block-style tokens → CSS. Framework-agnostic (returns a plain
+ * declaration object, no React types) so every renderer shares ONE mapping: the
+ * headless @betttercms/next adapter, @betttercms/ui, and (string form) the hosted
+ * render-page.ts. Unknown tokens are dropped — closed set, no arbitrary CSS.
+ */
+
+/** A CSS declaration object (key → value) usable as a React `style` prop, or undefined when empty. */
+declare function blockStyleToCss(style: BlockStyle | undefined): Record<string, string | number> | undefined;
+
+/**
+ * Component — a reusable, Webflow-style block tree (a "symbol").
+ *
+ * A component is authored once and placed across pages via `component` blocks
+ * (see `ComponentBlock` in `./block.ts`). Its definition lives in `blockJson`;
+ * `props` declares a flat allowlist of values an instance may override.
+ */
+
+/** The category a component belongs to (drives library grouping + icons). */
+type ComponentCategory = "navbar" | "footer" | "button" | "section" | "slider" | "tabs" | "form" | "custom";
+/**
+ * A single overridable field on a component. `target` points at the block + JSON
+ * path inside `blockJson` the override writes to (e.g. blockId "cta", path
+ * "props.text"). Keeping overrides a declared allowlist (not arbitrary nested
+ * rewrites) keeps instance data small and the contract explicit.
+ */
+interface ComponentPropDef {
+    key: string;
+    label: string;
+    target: {
+        blockId: string;
+        path: string;
+    };
+    type: "text" | "richtext" | "image" | "url" | "boolean";
+    defaultValue?: unknown;
+}
+interface Component {
+    id: string;
+    workspaceId: string;
+    projectId?: string | null;
+    name: string;
+    slug: string;
+    category: ComponentCategory;
+    description?: string | null;
+    blockJson: ContentBlock[];
+    props: ComponentPropDef[];
+    thumbnail?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Public/delivery projection — the fields a renderer needs to resolve instances. */
+interface DeliveryComponent {
+    id: string;
+    name: string;
+    slug: string;
+    category: ComponentCategory;
+    blockJson: ContentBlock[];
+    props: ComponentPropDef[];
+}
+
+/**
+ * ContentEntry — a single unit of content, representing the
+ * published layout of a page: a collection of ordered blocks
+ * with their resolved props.
+ */
+
+interface ContentEntry {
+    slug: string;
+    title: string;
+    blocks: ContentBlock[];
+    updatedAt: string;
+}
+
+/**
+ * ContentModel — the structured content model (schema) for a workspace.
+ * Defines which content fields are available for authors to fill in.
+ */
+interface ContentModel {
+    id: string;
+    workspaceId: string;
+    name: string;
+    description?: string;
+    fields: ContentModelField[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Canonical field types. Nesting lives on `array` via `config.zones`
+ * (see {@link ArrayZoneConfig}): `group`/`repeater` are accepted as legacy input
+ * by the API but normalized to `array` + zones on write, so stored/delivered
+ * content never contains them.
+ */
+type ContentModelFieldType = "text" | "richtext" | "image" | "boolean" | "number" | "select" | "reference" | "multi-reference" | "array" | "date" | "datetime";
+/**
+ * Nested-content config for an `array` field. A zone holds ordinary fields, and a
+ * zone field may itself be an `array` with its own zones, so nesting is recursive
+ * to any depth.
+ *   - `nonRepeatable` — a single fixed block of fields (former `group`).
+ *   - `repeatable`    — a repeating list of field-objects (former `repeater`).
+ * Mutually exclusive with the primitive form (`config.itemType`).
+ */
+interface ArrayZoneConfig {
+    nonRepeatable?: ContentModelField[];
+    repeatable?: {
+        fields: ContentModelField[];
+        minItems?: number;
+        maxItems?: number;
+    };
+}
+/** Per-type config for a field (the typed shape behind the loose `config` bag). */
+interface FieldConfig {
+    /** primitive array: list of scalars */
+    itemType?: "text" | "number" | "date";
+    /** nested array: zoned fields (recursive) */
+    zones?: ArrayZoneConfig;
+    /** reference / multi-reference */
+    contentModelId?: string;
+    min?: number;
+    max?: number;
+    /** date / datetime */
+    includeTime?: boolean;
+    [key: string]: unknown;
+}
+interface ContentModelField {
+    key: string;
+    label: string;
+    type: ContentModelFieldType;
+    required?: boolean;
+    defaultValue?: unknown;
+    options?: string[];
+    /** Per-type config. For `array`: either `itemType` (primitive) or `zones` (nested). */
+    config?: FieldConfig | null;
+}
+/**
+ * A field inside an array zone — identical to a top-level {@link ContentModelField}.
+ * Kept as a named alias so consumers can express "zone field" intent; recursion
+ * (an array zone field with its own `config.zones`) is supported.
+ */
+type ZoneField = ContentModelField;
+
+/**
+ * MediaAsset — a file uploaded to the CMS media library.
+ */
+interface MediaAsset {
+    id: string;
+    workspaceId: string;
+    filename: string;
+    originalFilename: string;
+    mimeType: string;
+    size: number;
+    url: string;
+    thumbnailUrl?: string;
+    width?: number;
+    height?: number;
+    altText?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Delivery API response shapes — the read surface consumed by framework
+ * SDKs (@bettercms-ai/sdk core client, @bettercms-ai/astro, @bettercms-ai/next).
+ */
+
+/** Which content lane to read from. */
+type Perspective = "published" | "drafts";
+/** A single content entry as returned by the Delivery API. */
+interface DeliveryEntry<T = Record<string, unknown>> {
+    id: string;
+    slug: string;
+    status: "draft" | "published";
+    publishedAt: string | null;
+    updatedAt: string | null;
+    data: T;
+    /** Hydrated reference fields, present when `depth >= 1`. */
+    _hydration?: Record<string, DeliveryEntry | DeliveryEntry[]>;
+    _meta?: {
+        modelSlug: string;
+        depth: number;
+        cached?: boolean;
+        preview?: boolean;
+    };
+}
+/**
+ * Per-page rich SEO blob (OG / Twitter / canonical / JSON-LD), stored on the page
+ * row and surfaced verbatim by the Delivery API. Merged page-over-site by
+ * `resolveSeo` (`@bettercms-ai/sdk`). `schema` is raw JSON-LD (one node or a @graph array).
+ */
+interface PageMetaJson {
+    canonical?: string;
+    og?: {
+        title?: string;
+        description?: string;
+        image?: string;
+        type?: string;
+    };
+    twitter?: {
+        card?: string;
+        title?: string;
+        description?: string;
+        image?: string;
+    };
+    schema?: Record<string, unknown> | Array<Record<string, unknown>>;
+}
+/**
+ * Site-level SEO defaults a headless consumer passes to `resolveSeo`/`buildMetadata`
+ * so per-page meta layers over project-wide fallbacks (mirrors the server renderer's
+ * `mergeSeoMeta`). All fields optional — supply whatever your project configures.
+ */
+interface SiteSeoDefaults {
+    metaTitle?: string;
+    metaDescription?: string;
+    ogImage?: string | null;
+    twitterHandle?: string | null;
+    og?: {
+        image?: string;
+        type?: string;
+    };
+    twitter?: {
+        card?: string;
+    };
+    /** Site-wide JSON-LD emitted alongside the page's own `schema`. */
+    siteSchema?: Record<string, unknown> | Array<Record<string, unknown>>;
+}
+/** A published page with its rendered block tree. */
+interface DeliveryPage {
+    slug: string;
+    title: string;
+    metaTitle: string | null;
+    metaDescription: string | null;
+    /** Rich SEO (OG / Twitter / canonical / JSON-LD). Always present; `null` when unset. */
+    metaJson: PageMetaJson | null;
+    blocks: ContentBlock[];
+    updatedAt: string | null;
+    publishedAt: string | null;
+}
+/** Generic paginated list envelope (the `data` of a list response). */
+interface DeliveryList<T> {
+    items: T[];
+    page: number;
+    perPage: number;
+    totalItems: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+
+/**
+ * Form — a CMS form that renders on a page and accepts submissions.
+ */
+interface Form {
+    id: string;
+    workspaceId: string;
+    name: string;
+    fields: FormField[];
+    submitLabel?: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface FormField {
+    key: string;
+    label: string;
+    type: "text" | "email" | "textarea" | "select" | "checkbox";
+    placeholder?: string;
+    required?: boolean;
+    options?: string[];
+}
+/**
+ * FormSubmission — a single form submission submitted by a visitor.
+ */
+interface FormSubmission {
+    id: string;
+    formId: string;
+    workspaceId: string;
+    data: Record<string, string | boolean | string[]>;
+    submittedAt: string;
+    ipAddress?: string;
+    userAgent?: string;
+}
+
+/**
+ * Redirect — a server-side redirect managed in the CMS.
+ */
+interface Redirect {
+    id: string;
+    workspaceId: string;
+    source: string;
+    destination: string;
+    type: 301 | 302 | 307 | 308;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * ApiKey — an API key scoped to a workspace, used for
+ * authenticating against the Delivery API.
+ */
+interface ApiKey {
+    id: string;
+    workspaceId: string;
+    projectId?: string;
+    name: string;
+    keyPrefix: string;
+    permissions: ApiKeyPermission[];
+    tokenType: ApiKeyTokenType;
+    description?: string;
+    expiresAt?: string;
+    rateLimit?: number;
+    isActive: boolean;
+    lastUsedAt?: string;
+    createdAt: string;
+}
+type ApiKeyPermission = "content:read" | "content:read:draft" | "content:write" | "form:read" | "form:submit" | "artifact:write";
+type ApiKeyTokenType = "full_access" | "read_only" | "preview";
+
+/**
+ * Auth types for BetterCMS SDK.
+ */
+/** User returned by BetterAuth. */
+interface AuthUser {
+    id: string;
+    email: string;
+    name: string;
+    emailVerified: boolean | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Session returned by BetterAuth. */
+interface AuthSession {
+    id: string;
+    userId: string;
+    token: string;
+    expiresAt: string;
+    ipAddress: string | null;
+    userAgent: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Sign-up request payload. */
+interface SignUpInput {
+    email: string;
+    password: string;
+    name: string;
+}
+/** Sign-in request payload. */
+interface SignInInput {
+    email: string;
+    password: string;
+}
+/** Auth response from sign-up / sign-in endpoints. */
+interface AuthResponse {
+    user: AuthUser;
+    session: AuthSession;
+    token: string;
+}
+
+/**
+ * Common API response types shared across the Delivery and Admin APIs.
+ */
+
+type BetterCMSErrorCode = "CONTENT_NOT_FOUND" | "UNAUTHORIZED" | "FORBIDDEN" | "RATE_LIMITED" | "INTERNAL_ERROR" | "VALIDATION_ERROR" | "NETWORK_ERROR" | "ADMIN_NOT_IMPLEMENTED" | "AUTH_ERROR" | "EMAIL_IN_USE";
+interface ApiError {
+    message: string;
+    code: BetterCMSErrorCode;
+    details?: unknown;
+}
+interface PaginatedResult<T> {
+    items: T[];
+    page: number;
+    perPage: number;
+    totalItems: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+interface Content {
+    slug: string;
+    entry: ContentEntry;
+    publishedAt: string;
+}
+interface ContentResponse {
+    data: Content;
+}
+interface ContentPageResult {
+    data: PaginatedResult<Content>;
+}
+/**
+ * Recursively applies `readonly` to all nested properties of T.
+ * API responses that should never be mutated can use this.
+ */
+type DeepReadonly<T> = T extends Function ? T : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+/**
+ * Compile-time type equality assertion.
+ * Use in type tests: `type _ = AssertEqual<A, B>` — compiler errors if they differ.
+ */
+type AssertEqual<L, R> = [L] extends [R] ? ([R] extends [L] ? true : false) : false;
+
+export { type AlignToken, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, type BetterCMSErrorCode, type BlockStyle, type BlockType, type ButtonBlock, type ButtonProps, type ColorToken, type ColumnsBlock, type ColumnsProps, type Component, type ComponentBlock, type ComponentCategory, type ComponentPropDef, type ComponentProps, type Content, type ContentBlock, type ContentEntry, type ContentModel, type ContentModelField, type ContentModelFieldType, type ContentPageResult, type ContentResponse, type DeepReadonly, type DeliveryComponent, type DeliveryEntry, type DeliveryList, type DeliveryPage, type FieldConfig, type FontSizeToken, type FooterBlock, type FooterColumn, type FooterProps, type Form, type FormBlock, type FormField, type FormProps, type FormSubmission, type HeadingBlock, type HeadingProps, type ImageBlock, type ImageProps, type MediaAsset, type NavLink, type NavbarBlock, type NavbarProps, type Page, type PageMetaJson, type PaginatedResult, type Perspective, type RadiusToken, type Redirect, type SectionBlock, type SectionProps, type SignInInput, type SignUpInput, type SiteSeoDefaults, type SlideItem, type SliderBlock, type SliderProps, type SpaceToken, type SpacerBlock, type SpacerProps, type TabItem, type TabsBlock, type TabsProps, type TextBlock, type TextProps, type VideoBlock, type VideoProps, type WeightToken, type Workspace, type ZoneField, blockStyleToCss, getBlockType, isBlock };

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/block.ts
+function isBlock(value) {
+  return typeof value === "object" && value !== null && "type" in value && typeof value["type"] === "string";
+}
+function getBlockType(value) {
+  if (isBlock(value)) return value.type;
+  return null;
+}
+
+// src/blockStyle.ts
+var SPACE_PX = { none: "0", xs: "4px", sm: "8px", md: "16px", lg: "32px", xl: "64px" };
+var FONT_SIZE_REM = { sm: "0.875rem", base: "1rem", lg: "1.25rem", xl: "1.5rem", "2xl": "2rem" };
+var WEIGHT = { normal: 400, medium: 500, semibold: 600, bold: 700 };
+var RADIUS_PX = { none: "0", sm: "4px", md: "8px", lg: "16px", full: "9999px" };
+var COLOR_HEX = { white: "#ffffff", black: "#111111", muted: "#6b7280", mutedBg: "#f3f4f6", primary: "#111111", accent: "#4f46e5" };
+function blockStyleToCss(style) {
+  if (!style || typeof style !== "object") return void 0;
+  const s = style;
+  const css = {};
+  if (s.paddingY && SPACE_PX[s.paddingY] != null) {
+    css.paddingTop = SPACE_PX[s.paddingY];
+    css.paddingBottom = SPACE_PX[s.paddingY];
+  }
+  if (s.paddingX && SPACE_PX[s.paddingX] != null) {
+    css.paddingLeft = SPACE_PX[s.paddingX];
+    css.paddingRight = SPACE_PX[s.paddingX];
+  }
+  if (s.marginTop && SPACE_PX[s.marginTop] != null) css.marginTop = SPACE_PX[s.marginTop];
+  if (s.marginBottom && SPACE_PX[s.marginBottom] != null) css.marginBottom = SPACE_PX[s.marginBottom];
+  if (s.background && COLOR_HEX[s.background]) css.background = COLOR_HEX[s.background];
+  if (s.textColor && COLOR_HEX[s.textColor]) css.color = COLOR_HEX[s.textColor];
+  if (s.align === "left" || s.align === "center" || s.align === "right") css.textAlign = s.align;
+  if (s.fontSize && FONT_SIZE_REM[s.fontSize]) css.fontSize = FONT_SIZE_REM[s.fontSize];
+  if (s.weight && WEIGHT[s.weight] != null) css.fontWeight = WEIGHT[s.weight];
+  if (s.radius && RADIUS_PX[s.radius] != null) css.borderRadius = RADIUS_PX[s.radius];
+  return Object.keys(css).length ? css : void 0;
+}
+export {
+  blockStyleToCss,
+  getBlockType,
+  isBlock
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/block.ts","../src/blockStyle.ts"],"sourcesContent":["/**\n * ContentBlock — a discriminated union of all CMS block types.\n * Each block has a `type` discriminator and a `props` object\n * whose shape matches the block type.\n */\n\n// ── Block style (FLO-264) ──────────────────────────────────────────────────────\n// A uniform, BOUNDED set of design tokens any block may carry (sibling to `props`).\n// Tokens map to fixed CSS values in the renderer (`styleTokensToCss`) so styling\n// reaches the live site WITHOUT arbitrary CSS. Additive + fully optional.\n\nexport type SpaceToken = \"none\" | \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\nexport type ColorToken = \"none\" | \"white\" | \"black\" | \"muted\" | \"mutedBg\" | \"primary\" | \"accent\";\nexport type AlignToken = \"left\" | \"center\" | \"right\";\nexport type FontSizeToken = \"sm\" | \"base\" | \"lg\" | \"xl\" | \"2xl\";\nexport type WeightToken = \"normal\" | \"medium\" | \"semibold\" | \"bold\";\nexport type RadiusToken = \"none\" | \"sm\" | \"md\" | \"lg\" | \"full\";\n\nexport interface BlockStyle {\n  paddingY?: SpaceToken;\n  paddingX?: SpaceToken;\n  marginTop?: SpaceToken;\n  marginBottom?: SpaceToken;\n  background?: ColorToken;\n  textColor?: ColorToken;\n  align?: AlignToken;\n  fontSize?: FontSizeToken;\n  weight?: WeightToken;\n  radius?: RadiusToken;\n}\n\n// ── Heading ──────────────────────────────────────────────────────────────────\n\nexport interface HeadingProps {\n  text: string;\n  level?: 1 | 2 | 3;\n}\n\nexport interface HeadingBlock {\n  type: \"heading\";\n  id: string;\n  style?: BlockStyle;\n  props: HeadingProps;\n}\n\n// ── Text ─────────────────────────────────────────────────────────────────────\n\nexport interface TextProps {\n  html: string;\n}\n\nexport interface TextBlock {\n  type: \"text\";\n  id: string;\n  style?: BlockStyle;\n  props: TextProps;\n}\n\n// ── Image ────────────────────────────────────────────────────────────────────\n\nexport interface ImageProps {\n  src: string;\n  alt: string;\n  width?: number;\n  height?: number;\n  caption?: string;\n}\n\nexport interface ImageBlock {\n  type: \"image\";\n  id: string;\n  style?: BlockStyle;\n  props: ImageProps;\n}\n\n// ── Button ───────────────────────────────────────────────────────────────────\n\nexport interface ButtonProps {\n  text: string;\n  href: string;\n  variant?: \"primary\" | \"secondary\";\n}\n\nexport interface ButtonBlock {\n  type: \"button\";\n  id: string;\n  style?: BlockStyle;\n  props: ButtonProps;\n}\n\n// ── Spacer ───────────────────────────────────────────────────────────────────\n\nexport interface SpacerProps {\n  height: number; // in px\n}\n\nexport interface SpacerBlock {\n  type: \"spacer\";\n  id: string;\n  style?: BlockStyle;\n  props: SpacerProps;\n}\n\n// ── Columns ───────────────────────────────────────────────────────────────────\n\nexport interface ColumnsProps {\n  columns: ContentBlock[][]; // array of column slots, each slot is an array of blocks\n  gap?: number; // in px\n}\n\nexport interface ColumnsBlock {\n  type: \"columns\";\n  id: string;\n  style?: BlockStyle;\n  props: ColumnsProps;\n}\n\n// ── Video ────────────────────────────────────────────────────────────────────\n\nexport interface VideoProps {\n  url: string;\n  poster?: string;\n  autoplay?: boolean;\n  loop?: boolean;\n}\n\nexport interface VideoBlock {\n  type: \"video\";\n  id: string;\n  style?: BlockStyle;\n  props: VideoProps;\n}\n\n// ── Form ─────────────────────────────────────────────────────────────────────\n\nexport interface FormProps {\n  formId: string; // references forms.id (a nanoid). Resolved against delivered forms at render time.\n}\n\nexport interface FormBlock {\n  type: \"form\";\n  id: string;\n  style?: BlockStyle;\n  props: FormProps;\n}\n\n// ── Section (recursive container) ──────────────────────────────────────────────\n\nexport interface SectionProps {\n  children: ContentBlock[];\n  background?: string;\n  paddingY?: number; // in px\n  maxWidth?: number; // in px\n}\n\nexport interface SectionBlock {\n  type: \"section\";\n  id: string;\n  style?: BlockStyle;\n  props: SectionProps;\n}\n\n// ── Navbar ─────────────────────────────────────────────────────────────────────\n\nexport interface NavLink {\n  label: string;\n  href: string;\n}\n\nexport interface NavbarProps {\n  logo?: { src: string; alt: string; href?: string };\n  links: NavLink[];\n  cta?: { text: string; href: string };\n}\n\nexport interface NavbarBlock {\n  type: \"navbar\";\n  id: string;\n  style?: BlockStyle;\n  props: NavbarProps;\n}\n\n// ── Footer ─────────────────────────────────────────────────────────────────────\n\nexport interface FooterColumn {\n  heading?: string;\n  links: NavLink[];\n}\n\nexport interface FooterProps {\n  columns: FooterColumn[];\n  copyright?: string;\n}\n\nexport interface FooterBlock {\n  type: \"footer\";\n  id: string;\n  style?: BlockStyle;\n  props: FooterProps;\n}\n\n// ── Slider / Carousel (recursive container, client-hydrated) ────────────────────\n\nexport interface SlideItem {\n  id: string;\n  children: ContentBlock[];\n}\n\nexport interface SliderProps {\n  slides: SlideItem[];\n  autoplay?: boolean;\n  interval?: number; // in ms\n  loop?: boolean;\n}\n\nexport interface SliderBlock {\n  type: \"slider\";\n  id: string;\n  style?: BlockStyle;\n  props: SliderProps;\n}\n\n// ── Tabs (recursive container, client-hydrated) ─────────────────────────────────\n\nexport interface TabItem {\n  id: string;\n  label: string;\n  children: ContentBlock[];\n}\n\nexport interface TabsProps {\n  tabs: TabItem[];\n}\n\nexport interface TabsBlock {\n  type: \"tabs\";\n  id: string;\n  style?: BlockStyle;\n  props: TabsProps;\n}\n\n// ── Component instance (Webflow-style reusable symbol) ──────────────────────────\n// References a reusable component by id. `overrides` maps a component prop key\n// (declared in the component's `props[]` allowlist) to a value, applied to the\n// component's block tree at render time. Resolved against delivered components.\n\nexport interface ComponentProps {\n  componentId: string;\n  overrides?: Record<string, unknown>;\n}\n\nexport interface ComponentBlock {\n  type: \"component\";\n  id: string;\n  style?: BlockStyle;\n  props: ComponentProps;\n}\n\n// ── Union ─────────────────────────────────────────────────────────────────────\n\nexport type ContentBlock =\n  | HeadingBlock\n  | TextBlock\n  | ImageBlock\n  | ButtonBlock\n  | SpacerBlock\n  | ColumnsBlock\n  | VideoBlock\n  | FormBlock\n  | SectionBlock\n  | NavbarBlock\n  | FooterBlock\n  | SliderBlock\n  | TabsBlock\n  | ComponentBlock;\n\n/** Literal union of all block type discriminators. */\nexport type BlockType = ContentBlock[\"type\"];\n\n/**\n * Type guard — narrows an unknown block to `ContentBlock`.\n *\n * @example\n * const block = maybeBlock as unknown;\n * if (isBlock(block)) {\n *   // block is ContentBlock here\n * }\n */\nexport function isBlock(value: unknown): value is ContentBlock {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    typeof (value as Record<string, unknown>)[\"type\"] === \"string\"\n  );\n}\n\n/**\n * Extract the `type` discriminator from a block, or `null` if not a block.\n *\n * @example\n * const block = { type: \"heading\", id: \"1\", props: { text: \"Hi\" } };\n * getBlockType(block); // \"heading\"\n * getBlockType({ not: \"a block\" }); // null\n */\nexport function getBlockType(value: unknown): BlockType | null {\n  if (isBlock(value)) return value.type;\n  return null;\n}\n","/**\n * FLO-264 — bounded block-style tokens → CSS. Framework-agnostic (returns a plain\n * declaration object, no React types) so every renderer shares ONE mapping: the\n * headless @betttercms/next adapter, @betttercms/ui, and (string form) the hosted\n * render-page.ts. Unknown tokens are dropped — closed set, no arbitrary CSS.\n */\nimport type { BlockStyle } from \"./block.js\";\n\nconst SPACE_PX: Record<string, string> = { none: \"0\", xs: \"4px\", sm: \"8px\", md: \"16px\", lg: \"32px\", xl: \"64px\" };\nconst FONT_SIZE_REM: Record<string, string> = { sm: \"0.875rem\", base: \"1rem\", lg: \"1.25rem\", xl: \"1.5rem\", \"2xl\": \"2rem\" };\nconst WEIGHT: Record<string, number> = { normal: 400, medium: 500, semibold: 600, bold: 700 };\nconst RADIUS_PX: Record<string, string> = { none: \"0\", sm: \"4px\", md: \"8px\", lg: \"16px\", full: \"9999px\" };\nconst COLOR_HEX: Record<string, string> = { white: \"#ffffff\", black: \"#111111\", muted: \"#6b7280\", mutedBg: \"#f3f4f6\", primary: \"#111111\", accent: \"#4f46e5\" };\n\n/** A CSS declaration object (key → value) usable as a React `style` prop, or undefined when empty. */\nexport function blockStyleToCss(style: BlockStyle | undefined): Record<string, string | number> | undefined {\n  if (!style || typeof style !== \"object\") return undefined;\n  const s = style as Record<string, string>;\n  const css: Record<string, string | number> = {};\n  if (s.paddingY && SPACE_PX[s.paddingY] != null) { css.paddingTop = SPACE_PX[s.paddingY]!; css.paddingBottom = SPACE_PX[s.paddingY]!; }\n  if (s.paddingX && SPACE_PX[s.paddingX] != null) { css.paddingLeft = SPACE_PX[s.paddingX]!; css.paddingRight = SPACE_PX[s.paddingX]!; }\n  if (s.marginTop && SPACE_PX[s.marginTop] != null) css.marginTop = SPACE_PX[s.marginTop]!;\n  if (s.marginBottom && SPACE_PX[s.marginBottom] != null) css.marginBottom = SPACE_PX[s.marginBottom]!;\n  if (s.background && COLOR_HEX[s.background]) css.background = COLOR_HEX[s.background]!;\n  if (s.textColor && COLOR_HEX[s.textColor]) css.color = COLOR_HEX[s.textColor]!;\n  if (s.align === \"left\" || s.align === \"center\" || s.align === \"right\") css.textAlign = s.align;\n  if (s.fontSize && FONT_SIZE_REM[s.fontSize]) css.fontSize = FONT_SIZE_REM[s.fontSize]!;\n  if (s.weight && WEIGHT[s.weight] != null) css.fontWeight = WEIGHT[s.weight]!;\n  if (s.radius && RADIUS_PX[s.radius] != null) css.borderRadius = RADIUS_PX[s.radius]!;\n  return Object.keys(css).length ? css : undefined;\n}\n"],"mappings":";AAgSO,SAAS,QAAQ,OAAuC;AAC7D,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAQ,MAAkC,MAAM,MAAM;AAE1D;AAUO,SAAS,aAAa,OAAkC;AAC7D,MAAI,QAAQ,KAAK,EAAG,QAAO,MAAM;AACjC,SAAO;AACT;;;AC5SA,IAAM,WAAmC,EAAE,MAAM,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,IAAI,OAAO;AAC/G,IAAM,gBAAwC,EAAE,IAAI,YAAY,MAAM,QAAQ,IAAI,WAAW,IAAI,UAAU,OAAO,OAAO;AACzH,IAAM,SAAiC,EAAE,QAAQ,KAAK,QAAQ,KAAK,UAAU,KAAK,MAAM,IAAI;AAC5F,IAAM,YAAoC,EAAE,MAAM,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,QAAQ,MAAM,SAAS;AACxG,IAAM,YAAoC,EAAE,OAAO,WAAW,OAAO,WAAW,OAAO,WAAW,SAAS,WAAW,SAAS,WAAW,QAAQ,UAAU;AAGrJ,SAAS,gBAAgB,OAA4E;AAC1G,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,IAAI;AACV,QAAM,MAAuC,CAAC;AAC9C,MAAI,EAAE,YAAY,SAAS,EAAE,QAAQ,KAAK,MAAM;AAAE,QAAI,aAAa,SAAS,EAAE,QAAQ;AAAI,QAAI,gBAAgB,SAAS,EAAE,QAAQ;AAAA,EAAI;AACrI,MAAI,EAAE,YAAY,SAAS,EAAE,QAAQ,KAAK,MAAM;AAAE,QAAI,cAAc,SAAS,EAAE,QAAQ;AAAI,QAAI,eAAe,SAAS,EAAE,QAAQ;AAAA,EAAI;AACrI,MAAI,EAAE,aAAa,SAAS,EAAE,SAAS,KAAK,KAAM,KAAI,YAAY,SAAS,EAAE,SAAS;AACtF,MAAI,EAAE,gBAAgB,SAAS,EAAE,YAAY,KAAK,KAAM,KAAI,eAAe,SAAS,EAAE,YAAY;AAClG,MAAI,EAAE,cAAc,UAAU,EAAE,UAAU,EAAG,KAAI,aAAa,UAAU,EAAE,UAAU;AACpF,MAAI,EAAE,aAAa,UAAU,EAAE,SAAS,EAAG,KAAI,QAAQ,UAAU,EAAE,SAAS;AAC5E,MAAI,EAAE,UAAU,UAAU,EAAE,UAAU,YAAY,EAAE,UAAU,QAAS,KAAI,YAAY,EAAE;AACzF,MAAI,EAAE,YAAY,cAAc,EAAE,QAAQ,EAAG,KAAI,WAAW,cAAc,EAAE,QAAQ;AACpF,MAAI,EAAE,UAAU,OAAO,EAAE,MAAM,KAAK,KAAM,KAAI,aAAa,OAAO,EAAE,MAAM;AAC1E,MAAI,EAAE,UAAU,UAAU,EAAE,MAAM,KAAK,KAAM,KAAI,eAAe,UAAU,EAAE,MAAM;AAClF,SAAO,OAAO,KAAK,GAAG,EAAE,SAAS,MAAM;AACzC;","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@bettercms-ai/types",
+  "version": "1.5.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsup",
+    "prepack": "tsup"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}