@bendyline/squisq 0.1.2 → 1.1.0

package/dist/schemas/LayoutStrategy.js

@@ -0,0 +1,123 @@
+/**
+ * Layout Strategy
+ *
+ * Provides orientation-specific layout hints for slide templates.
+ * Templates use these hints to position content appropriately for
+ * different aspect ratios (landscape, portrait, square).
+ *
+ * Key adaptations by orientation:
+ * - Portrait: Larger relative text, stacked layouts instead of side-by-side
+ * - Square: Balanced layout with moderate adjustments
+ * - Landscape: Default/reference layout
+ */
+import { calculateFontScale } from './Viewport.js';
+/**
+ * Layout configurations by orientation.
+ */
+const LAYOUT_CONFIGS = {
+    landscape: {
+        primaryY: '35%',
+        secondaryY: '55%',
+        tertiaryY: '75%',
+        titleScale: 1.0,
+        bodyScale: 1.0,
+        columnLeftX: '25%',
+        columnRightX: '75%',
+        columnTopY: '35%',
+        columnBottomY: '65%',
+        stackColumns: false,
+        maxTextWidth: '80%',
+        horizontalPadding: '10%',
+        captionY: '85%',
+        captionScale: 1.0,
+    },
+    portrait: {
+        // Content positioned higher for thumb-reach zone on mobile
+        primaryY: '25%',
+        secondaryY: '42%',
+        tertiaryY: '58%',
+        // Titles scale down for narrower width; body text scales up to fill vertical space
+        titleScale: 0.7,
+        bodyScale: 1.5,
+        // Stacked columns instead of side-by-side
+        columnLeftX: '50%',
+        columnRightX: '50%',
+        columnTopY: '30%',
+        columnBottomY: '55%',
+        stackColumns: true,
+        // Wider relative to viewport to use available space
+        maxTextWidth: '90%',
+        horizontalPadding: '5%',
+        captionY: '75%',
+        captionScale: 0.85,
+    },
+    square: {
+        primaryY: '30%',
+        secondaryY: '50%',
+        tertiaryY: '70%',
+        titleScale: 0.85,
+        bodyScale: 0.9,
+        columnLeftX: '25%',
+        columnRightX: '75%',
+        columnTopY: '35%',
+        columnBottomY: '65%',
+        stackColumns: false,
+        maxTextWidth: '85%',
+        horizontalPadding: '7.5%',
+        captionY: '82%',
+        captionScale: 0.9,
+    },
+};
+/**
+ * Get layout hints for a given orientation.
+ */
+export function getLayoutHints(orientation) {
+    return LAYOUT_CONFIGS[orientation];
+}
+/**
+ * Calculate a scaled font size based on viewport and layout hints.
+ *
+ * @param basePx - Base font size in pixels (designed for 1920x1080)
+ * @param viewport - Target viewport configuration
+ * @param orientation - Viewport orientation
+ * @param isTitle - Whether this is title text (uses titleScale) or body (uses bodyScale)
+ */
+export function scaledFontSize(basePx, viewport, orientation, isTitle = false) {
+    const fontScale = calculateFontScale(viewport);
+    const layout = getLayoutHints(orientation);
+    const typeScale = isTitle ? layout.titleScale : layout.bodyScale;
+    return Math.round(basePx * fontScale * typeScale);
+}
+/**
+ * Get position for two-column layout based on orientation.
+ * Returns { left: {x, y}, right: {x, y} } positions.
+ */
+export function getTwoColumnPositions(orientation) {
+    const layout = getLayoutHints(orientation);
+    if (layout.stackColumns) {
+        // Portrait: stack vertically
+        return {
+            left: { x: '50%', y: layout.columnTopY },
+            right: { x: '50%', y: layout.columnBottomY },
+        };
+    }
+    // Landscape/square: side by side
+    return {
+        left: { x: layout.columnLeftX, y: '50%' },
+        right: { x: layout.columnRightX, y: '50%' },
+    };
+}
+/**
+ * Get safe text bounds for a given orientation.
+ * Returns margins to keep text away from edges.
+ */
+export function getSafeTextBounds(orientation) {
+    const layout = getLayoutHints(orientation);
+    return {
+        left: layout.horizontalPadding,
+        right: layout.horizontalPadding,
+        top: '10%',
+        bottom: '10%',
+    };
+}
+//# sourceMappingURL=LayoutStrategy.js.map

package/dist/schemas/LayoutStrategy.js.map

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

package/dist/schemas/MediaProvider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MediaProvider — abstract interface for resolving and managing media assets.
+ *
+ * Components (ImageLayer, VideoLayer, editor preview) use a MediaProvider to
+ * resolve relative media paths to displayable URLs and to manage media storage.
+ *
+ * This decouples the rendering layer from the storage backend:
+ * - In the dev site, a SlotStorage-backed provider serves blob URLs from IndexedDB
+ * - In production, a simple basePath provider constructs CDN URLs
+ * - In tests, a memory-backed provider returns data URIs
+ */
+/**
+ * Metadata about a stored media asset.
+ */
+export interface MediaEntry {
+    /** Filename (e.g., 'hero.jpg') */
+    name: string;
+    /** MIME type (e.g., 'image/jpeg') */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Interface for resolving and managing media assets.
+ *
+ * All methods are async to support IndexedDB and other async storage backends.
+ * The `resolveUrl` method is the primary integration point for rendering
+ * components — it converts a relative media path into a displayable URL.
+ */
+export interface MediaProvider {
+    /**
+     * Resolve a relative media path to a displayable URL.
+     *
+     * Returns a URL that can be used in <img src>, <video src>, etc.
+     * This may be a blob: URL, data: URL, or absolute HTTP URL depending
+     * on the provider implementation.
+     *
+     * @param relativePath - Relative path as stored in the document (e.g., 'hero.jpg')
+     * @returns Displayable URL, or the original path if resolution fails
+     */
+    resolveUrl(relativePath: string): Promise<string>;
+    /**
+     * List all media assets available in this provider's scope.
+     */
+    listMedia(): Promise<MediaEntry[]>;
+    /**
+     * Add a media asset. Returns the relative path to reference in documents.
+     *
+     * @param name - Filename for the asset (e.g., 'photo.jpg')
+     * @param data - Binary content (ArrayBuffer, Blob, or Uint8Array)
+     * @param mimeType - MIME type of the data
+     * @returns The relative path to use in document references
+     */
+    addMedia(name: string, data: ArrayBuffer | Blob | Uint8Array, mimeType: string): Promise<string>;
+    /**
+     * Remove a media asset by its relative path.
+     */
+    removeMedia(relativePath: string): Promise<void>;
+    /**
+     * Dispose of any held resources (e.g., revoke blob URLs).
+     * Call this when the provider is no longer needed.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=MediaProvider.d.ts.map

package/dist/schemas/MediaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaProvider.d.ts","sourceRoot":"","sources":["../../src/schemas/MediaProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjG;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/schemas/MediaProvider.js

@@ -0,0 +1,13 @@
+/**
+ * MediaProvider — abstract interface for resolving and managing media assets.
+ *
+ * Components (ImageLayer, VideoLayer, editor preview) use a MediaProvider to
+ * resolve relative media paths to displayable URLs and to manage media storage.
+ *
+ * This decouples the rendering layer from the storage backend:
+ * - In the dev site, a SlotStorage-backed provider serves blob URLs from IndexedDB
+ * - In production, a simple basePath provider constructs CDN URLs
+ * - In tests, a memory-backed provider returns data URIs
+ */
+export {};
+//# sourceMappingURL=MediaProvider.js.map

package/dist/schemas/MediaProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaProvider.js","sourceRoot":"","sources":["../../src/schemas/MediaProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/schemas/Theme.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Theme System
+ *
+ * A Theme bundles color palette, typography, visual style, render-style
+ * algorithm, and per-block color schemes into one JSON-serializable object.
+ * Builders choose a theme from the built-in library or create a custom one
+ * via `createTheme(base, overrides)`.
+ *
+ * Design principles:
+ * - Fully JSON-serializable (no functions) — storable in config / APIs.
+ * - Doc carries an optional `themeId` pointer; resolution happens at render time.
+ * - `createTheme` deep-merges a base theme with partial overrides.
+ */
+import type { LayoutHints } from './LayoutStrategy.js';
+import type { AnimationType, TransitionType } from './Doc.js';
+import type { PersistentLayerConfig } from './BlockTemplates.js';
+/**
+ * Core color palette for a theme. Every color is a CSS color string.
+ */
+export interface ThemeColorPalette {
+    /** Primary accent color */
+    primary: string;
+    /** Secondary accent color */
+    secondary: string;
+    /** Background color (typically dark) */
+    background: string;
+    /** Lighter background for contrast panels */
+    backgroundLight: string;
+    /** Main text color */
+    text: string;
+    /** Muted/secondary text color */
+    textMuted: string;
+    /** Highlight/emphasis color */
+    highlight: string;
+    /** Warning/alert color */
+    warning: string;
+}
+/**
+ * A named color scheme used by templates for per-block color variation
+ * (e.g., statHighlight or sectionHeader).
+ */
+export interface ThemeColorScheme {
+    /** Background fill */
+    bg: string;
+    /** Primary text tint */
+    text: string;
+    /** Accent / secondary tint */
+    accent: string;
+}
+/**
+ * Typography settings for a theme.
+ */
+export interface ThemeTypography {
+    /** Font family for body / description text */
+    bodyFontFamily: string;
+    /** Font family for titles and headings */
+    titleFontFamily: string;
+    /** Font family for code / monospaced text (optional) */
+    monoFontFamily?: string;
+    /** Multiplier applied to LayoutHints.titleScale (default 1.0) */
+    titleScale?: number;
+    /** Multiplier applied to LayoutHints.bodyScale (default 1.0) */
+    bodyScale?: number;
+    /** Default body line height (default 1.4) */
+    lineHeight?: number;
+    /** Default title line height */
+    titleLineHeight?: number;
+    /** Default title font weight */
+    titleWeight?: 'normal' | 'bold';
+}
+/**
+ * Global visual-style knobs that templates consult.
+ */
+export interface ThemeStyle {
+    /** Default border radius for cards / shapes (px) */
+    borderRadius?: number;
+    /** Whether templates should default to text shadows */
+    textShadow?: boolean;
+    /** Darkness of overlay on image-backed blocks (0–1) */
+    overlayOpacity?: number;
+    /** Multiplier on all animation durations (1.0 = normal, <1 faster, >1 slower) */
+    animationSpeed?: number;
+    /** Default horizontal padding for text (percentage string, e.g. "5%") */
+    blockPadding?: string;
+}
+/**
+ * Render-style algorithm preset. Controls layout tweaks, default animations,
+ * transitions, and per-template behavioral hints.
+ */
+export interface RenderStyle {
+    /** Identifier for this algorithmic approach (e.g. "documentary", "magazine") */
+    name: string;
+    /** Partial overrides merged onto the orientation-based LayoutHints */
+    layoutOverrides?: Partial<LayoutHints>;
+    /** Default entrance animation for text layers */
+    defaultTextAnimation?: AnimationType;
+    /** Default animation for background / image layers */
+    defaultImageAnimation?: AnimationType;
+    /** Whether to apply Ken Burns ambient motion to images by default */
+    ambientMotion?: boolean;
+    /** Default block-to-block transition */
+    defaultTransition?: {
+        type: TransitionType;
+        duration?: number;
+    };
+    /**
+     * Per-template behavioral hints. Keys are template names, values are
+     * string/number/boolean maps that templates can read to vary their output.
+     *
+     * @example
+     * ```
+     * { statHighlight: { entrance: 'dramatic' }, titleBlock: { showAccentLine: false } }
+     * ```
+     */
+    templateHints?: Record<string, Record<string, string | number | boolean>>;
+}
+/**
+ * A complete, JSON-serializable theme definition.
+ */
+export interface Theme {
+    /** Unique identifier (e.g. "documentary") */
+    id: string;
+    /** Human-readable display name */
+    name: string;
+    /** Short description for theme pickers */
+    description?: string;
+    /** Color palette */
+    colors: ThemeColorPalette;
+    /** Typography settings */
+    typography: ThemeTypography;
+    /** Global visual-style knobs */
+    style: ThemeStyle;
+    /** Algorithmic render-style preset */
+    renderStyle: RenderStyle;
+    /**
+     * Named color schemes for per-block color variation.
+     * Templates reference these by name (e.g. "blue", "warm").
+     */
+    colorSchemes: Record<string, ThemeColorScheme>;
+    /** Optional persistent layers baked into the theme */
+    persistentLayers?: PersistentLayerConfig;
+}
+/**
+ * Recursively makes every property optional.
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Create a new theme by deep-merging overrides onto a base theme.
+ * The returned theme gets its own `id` if one is provided in overrides,
+ * otherwise keeps the base theme's `id` suffixed with "-custom".
+ *
+ * @example
+ * ```ts
+ * const myTheme = createTheme(THEMES.documentary, {
+ *   colors: { primary: '#ff0000' },
+ *   typography: { bodyFontFamily: '"Inter", sans-serif' },
+ * });
+ * ```
+ */
+export declare function createTheme(base: Theme, overrides: DeepPartial<Theme>): Theme;
+//# sourceMappingURL=Theme.d.ts.map

package/dist/schemas/Theme.d.ts.map

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

package/dist/schemas/Theme.js

@@ -0,0 +1,62 @@
+/**
+ * Theme System
+ *
+ * A Theme bundles color palette, typography, visual style, render-style
+ * algorithm, and per-block color schemes into one JSON-serializable object.
+ * Builders choose a theme from the built-in library or create a custom one
+ * via `createTheme(base, overrides)`.
+ *
+ * Design principles:
+ * - Fully JSON-serializable (no functions) — storable in config / APIs.
+ * - Doc carries an optional `themeId` pointer; resolution happens at render time.
+ * - `createTheme` deep-merges a base theme with partial overrides.
+ */
+// ============================================
+// Helpers
+// ============================================
+/**
+ * Deep-merge `source` into `target`, returning a new object.
+ * Arrays are replaced wholesale (not concatenated).
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const srcVal = source[key];
+        const tgtVal = target[key];
+        if (srcVal !== null &&
+            srcVal !== undefined &&
+            typeof srcVal === 'object' &&
+            !Array.isArray(srcVal) &&
+            tgtVal !== null &&
+            tgtVal !== undefined &&
+            typeof tgtVal === 'object' &&
+            !Array.isArray(tgtVal)) {
+            result[key] = deepMerge(tgtVal, srcVal);
+        }
+        else if (srcVal !== undefined) {
+            result[key] = srcVal;
+        }
+    }
+    return result;
+}
+/**
+ * Create a new theme by deep-merging overrides onto a base theme.
+ * The returned theme gets its own `id` if one is provided in overrides,
+ * otherwise keeps the base theme's `id` suffixed with "-custom".
+ *
+ * @example
+ * ```ts
+ * const myTheme = createTheme(THEMES.documentary, {
+ *   colors: { primary: '#ff0000' },
+ *   typography: { bodyFontFamily: '"Inter", sans-serif' },
+ * });
+ * ```
+ */
+export function createTheme(base, overrides) {
+    const merged = deepMerge(base, overrides);
+    if (!overrides.id && merged.id === base.id) {
+        merged.id = `${base.id}-custom`;
+    }
+    return merged;
+}
+//# sourceMappingURL=Theme.js.map

package/dist/schemas/Theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Theme.js","sourceRoot":"","sources":["../../src/schemas/Theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsKH,+CAA+C;AAC/C,UAAU;AACV,+CAA+C;AAE/C;;;GAGG;AACH,SAAS,SAAS,CAAoC,MAAS,EAAE,MAAsB;IACrF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAA6B,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,MAAM,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;QACxD,IACE,MAAM,KAAK,IAAI;YACf,MAAM,KAAK,SAAS;YACpB,OAAO,MAAM,KAAK,QAAQ;YAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,MAAM,KAAK,IAAI;YACf,MAAM,KAAK,SAAS;YACpB,OAAO,MAAM,KAAK,QAAQ;YAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACtB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,MAAiC,EACjC,MAA8C,CAC/C,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,IAAW,EAAE,SAA6B;IACpE,MAAM,MAAM,GAAG,SAAS,CACtB,IAA0C,EAC1C,SAAiD,CAC9B,CAAC;IACtB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,SAAS,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schemas/Types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core geographic types shared across squisq.
+ */
+export interface Coordinates {
+    lat: number;
+    lng: number;
+}
+export interface BoundingBox {
+    north: number;
+    south: number;
+    east: number;
+    west: number;
+}
+//# sourceMappingURL=Types.d.ts.map

package/dist/schemas/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../src/schemas/Types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/schemas/Types.js

@@ -0,0 +1,5 @@
+/**
+ * Core geographic types shared across squisq.
+ */
+export {};
+//# sourceMappingURL=Types.js.map

package/dist/schemas/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../src/schemas/Types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/schemas/Viewport.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Viewport Configuration
+ *
+ * Defines viewport dimensions for doc rendering across different aspect ratios.
+ * Templates use this configuration to adapt their layouts appropriately.
+ *
+ * Supported aspect ratios:
+ * - landscape (16:9) - Default, standard video/presentation format
+ * - portrait (9:16) - Vertical video, mobile stories
+ * - square (1:1) - Social media posts
+ * - standard (4:3) - Legacy presentation format
+ */
+/**
+ * Viewport configuration for doc rendering.
+ */
+export interface ViewportConfig {
+    /** Canonical width in virtual pixels */
+    width: number;
+    /** Canonical height in virtual pixels */
+    height: number;
+    /** Human-readable name for debugging/display */
+    name: string;
+}
+/**
+ * Standard viewport presets for common aspect ratios.
+ */
+export declare const VIEWPORT_PRESETS: {
+    /** 16:9 landscape (default, 1080p) */
+    readonly landscape: {
+        readonly width: 1920;
+        readonly height: 1080;
+        readonly name: "16:9 Landscape";
+    };
+    /** 9:16 portrait (vertical video, stories) */
+    readonly portrait: {
+        readonly width: 1080;
+        readonly height: 1920;
+        readonly name: "9:16 Portrait";
+    };
+    /** 1:1 square (social media) */
+    readonly square: {
+        readonly width: 1080;
+        readonly height: 1080;
+        readonly name: "1:1 Square";
+    };
+    /** 4:3 standard (legacy) */
+    readonly standard: {
+        readonly width: 1440;
+        readonly height: 1080;
+        readonly name: "4:3 Standard";
+    };
+};
+/**
+ * Viewport preset name.
+ */
+export type ViewportPreset = keyof typeof VIEWPORT_PRESETS;
+/**
+ * Viewport orientation derived from aspect ratio.
+ */
+export type ViewportOrientation = 'landscape' | 'portrait' | 'square';
+/**
+ * Get a viewport configuration from a preset name or return the config if already a ViewportConfig.
+ */
+export declare function getViewport(viewport: ViewportPreset | ViewportConfig): ViewportConfig;
+export declare function calculateFontScale(viewport: ViewportConfig): number;
+/**
+ * Determine if viewport is landscape, portrait, or square.
+ */
+export declare function getViewportOrientation(viewport: ViewportConfig): ViewportOrientation;
+/**
+ * Get aspect ratio as a string (e.g., "16:9", "9:16", "1:1").
+ */
+export declare function getAspectRatioString(viewport: ViewportConfig): string;
+//# sourceMappingURL=Viewport.d.ts.map

package/dist/schemas/Viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Viewport.d.ts","sourceRoot":"","sources":["../../src/schemas/Viewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,sCAAsC;;;;;;IAEtC,8CAA8C;;;;;;IAE9C,gCAAgC;;;;;;IAEhC,4BAA4B;;;;;;CAEpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,GAAG,cAAc,CAKrF;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,mBAAmB,CAKpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAIrE"}

package/dist/schemas/Viewport.js

@@ -0,0 +1,63 @@
+/**
+ * Viewport Configuration
+ *
+ * Defines viewport dimensions for doc rendering across different aspect ratios.
+ * Templates use this configuration to adapt their layouts appropriately.
+ *
+ * Supported aspect ratios:
+ * - landscape (16:9) - Default, standard video/presentation format
+ * - portrait (9:16) - Vertical video, mobile stories
+ * - square (1:1) - Social media posts
+ * - standard (4:3) - Legacy presentation format
+ */
+/**
+ * Standard viewport presets for common aspect ratios.
+ */
+export const VIEWPORT_PRESETS = {
+    /** 16:9 landscape (default, 1080p) */
+    landscape: { width: 1920, height: 1080, name: '16:9 Landscape' },
+    /** 9:16 portrait (vertical video, stories) */
+    portrait: { width: 1080, height: 1920, name: '9:16 Portrait' },
+    /** 1:1 square (social media) */
+    square: { width: 1080, height: 1080, name: '1:1 Square' },
+    /** 4:3 standard (legacy) */
+    standard: { width: 1440, height: 1080, name: '4:3 Standard' },
+};
+/**
+ * Get a viewport configuration from a preset name or return the config if already a ViewportConfig.
+ */
+export function getViewport(viewport) {
+    if (typeof viewport === 'string') {
+        return VIEWPORT_PRESETS[viewport];
+    }
+    return viewport;
+}
+/**
+ * Calculate font scale factor for a viewport.
+ * Based on diagonal pixels relative to 1080p landscape reference.
+ * This ensures text remains readable across different viewport sizes.
+ */
+const REFERENCE_DIAGONAL = Math.sqrt(1920 * 1920 + 1080 * 1080); // ~2203
+export function calculateFontScale(viewport) {
+    const currentDiagonal = Math.sqrt(viewport.width * viewport.width + viewport.height * viewport.height);
+    return currentDiagonal / REFERENCE_DIAGONAL;
+}
+/**
+ * Determine if viewport is landscape, portrait, or square.
+ */
+export function getViewportOrientation(viewport) {
+    const ratio = viewport.width / viewport.height;
+    // Allow small tolerance for "square" classification
+    if (Math.abs(ratio - 1) < 0.05)
+        return 'square';
+    return ratio > 1 ? 'landscape' : 'portrait';
+}
+/**
+ * Get aspect ratio as a string (e.g., "16:9", "9:16", "1:1").
+ */
+export function getAspectRatioString(viewport) {
+    const gcd = (a, b) => (b === 0 ? a : gcd(b, a % b));
+    const divisor = gcd(viewport.width, viewport.height);
+    return `${viewport.width / divisor}:${viewport.height / divisor}`;
+}
+//# sourceMappingURL=Viewport.js.map

package/dist/schemas/Viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Viewport.js","sourceRoot":"","sources":["../../src/schemas/Viewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sCAAsC;IACtC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAChE,8CAA8C;IAC9C,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE;IAC9D,gCAAgC;IAChC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;IACzD,4BAA4B;IAC5B,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE;CACrD,CAAC;AAYX;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyC;IACnE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ;AAEzE,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CACpE,CAAC;IACF,OAAO,eAAe,GAAG,kBAAkB,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/C,oDAAoD;IACpD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IAChD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC3D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;AACpE,CAAC"}