@bendyline/squisq 1.3.0 → 1.4.1

package/dist/schemas/LayoutStrategy.d.ts

@@ -1,84 +0,0 @@
-/**
- * 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 type { ViewportOrientation, ViewportConfig } from './Viewport.js';
-/**
- * Layout hints for template positioning based on orientation.
- */
-export interface LayoutHints {
-    /** Primary content Y position (percentage string, e.g., "35%") */
-    primaryY: string;
-    /** Secondary content Y position (percentage string) */
-    secondaryY: string;
-    /** Tertiary/detail Y position (percentage string) */
-    tertiaryY: string;
-    /** Title font size multiplier (relative to base) */
-    titleScale: number;
-    /** Body text font size multiplier (relative to base) */
-    bodyScale: number;
-    /** Two-column: left X position (percentage string) */
-    columnLeftX: string;
-    /** Two-column: right X position (percentage string) */
-    columnRightX: string;
-    /** Two-column in portrait: top Y position for stacked layout */
-    columnTopY: string;
-    /** Two-column in portrait: bottom Y position for stacked layout */
-    columnBottomY: string;
-    /** Whether two-column should stack vertically */
-    stackColumns: boolean;
-    /** Max text width (percentage string) for wrapping */
-    maxTextWidth: string;
-    /** Horizontal padding from edges (percentage string) */
-    horizontalPadding: string;
-    /** Caption position Y for imageWithCaption (percentage string) */
-    captionY: string;
-    /** Caption font size multiplier */
-    captionScale: number;
-}
-/**
- * Get layout hints for a given orientation.
- */
-export declare function getLayoutHints(orientation: ViewportOrientation): LayoutHints;
-/**
- * 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 declare function scaledFontSize(basePx: number, viewport: ViewportConfig, orientation: ViewportOrientation, isTitle?: boolean): number;
-/**
- * Get position for two-column layout based on orientation.
- * Returns { left: {x, y}, right: {x, y} } positions.
- */
-export declare function getTwoColumnPositions(orientation: ViewportOrientation): {
-    left: {
-        x: string;
-        y: string;
-    };
-    right: {
-        x: string;
-        y: string;
-    };
-};
-/**
- * Get safe text bounds for a given orientation.
- * Returns margins to keep text away from edges.
- */
-export declare function getSafeTextBounds(orientation: ViewportOrientation): {
-    left: string;
-    right: string;
-    top: string;
-    bottom: string;
-};
-//# sourceMappingURL=LayoutStrategy.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"LayoutStrategy.d.ts","sourceRoot":"","sources":["../../src/schemas/LayoutStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AA4DD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,mBAAmB,GAAG,WAAW,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,mBAAmB,EAChC,OAAO,GAAE,OAAe,GACvB,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,mBAAmB,GAAG;IACvE,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAgBA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,GAAG;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA"}

package/dist/schemas/LayoutStrategy.js

@@ -1,123 +0,0 @@
-/**
- * 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

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

package/dist/schemas/MediaProvider.d.ts

@@ -1,65 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,13 +0,0 @@
-/**
- * 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

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

package/dist/schemas/Theme.d.ts

@@ -1,194 +0,0 @@
-/**
- * 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;
-/**
- * A Surface Scheme is the light/dark axis, orthogonal to the editorial
- * identity of a Theme. A Theme chooses voice (serif vs sans, muted vs
- * bold, documentary vs magazine); a SurfaceScheme chooses what the paper
- * looks like. Any theme can render on either surface.
- *
- * When a SurfaceScheme is applied to a Theme (via `applySurface`), these
- * fields override the corresponding entries in `ThemeColorPalette` —
- * everything else (primary, highlight, warning, etc.) stays as the theme
- * defined it.
- */
-export interface SurfaceScheme {
-    /** Identifier — 'light', 'dark', or a custom id. */
-    id: string;
-    background: string;
-    backgroundLight: string;
-    text: string;
-    textMuted: string;
-}
-/** Near-white paper with dark text — standard light mode. */
-export declare const LIGHT_SURFACE: SurfaceScheme;
-/** Dark charcoal paper with light text — standard dark mode. */
-export declare const DARK_SURFACE: SurfaceScheme;
-/**
- * Overlay a SurfaceScheme's surface colors onto a Theme's palette,
- * leaving everything else (primary, highlight, warning, typography,
- * style, renderStyle, colorSchemes) untouched. Returns a new Theme;
- * callers that want to preserve the original's id should set it
- * explicitly in the overrides.
- */
-export declare function applySurface(theme: Theme, surface: SurfaceScheme): Theme;
-//# sourceMappingURL=Theme.d.ts.map

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

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

package/dist/schemas/Theme.js

@@ -1,97 +0,0 @@
-/**
- * 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;
-}
-/** Near-white paper with dark text — standard light mode. */
-export const LIGHT_SURFACE = {
-    id: 'light',
-    background: '#ffffff',
-    backgroundLight: '#f5f5f5',
-    text: '#1a1a1a',
-    textMuted: '#666666',
-};
-/** Dark charcoal paper with light text — standard dark mode. */
-export const DARK_SURFACE = {
-    id: 'dark',
-    background: '#1a202c',
-    backgroundLight: '#2d3748',
-    text: '#f0f0f0',
-    textMuted: '#a0aec0',
-};
-/**
- * Overlay a SurfaceScheme's surface colors onto a Theme's palette,
- * leaving everything else (primary, highlight, warning, typography,
- * style, renderStyle, colorSchemes) untouched. Returns a new Theme;
- * callers that want to preserve the original's id should set it
- * explicitly in the overrides.
- */
-export function applySurface(theme, surface) {
-    return {
-        ...theme,
-        colors: {
-            ...theme.colors,
-            background: surface.background,
-            backgroundLight: surface.backgroundLight,
-            text: surface.text,
-            textMuted: surface.textMuted,
-        },
-    };
-}
-//# sourceMappingURL=Theme.js.map

package/dist/schemas/Theme.js.map

@@ -1 +0,0 @@
-{"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;AA0BD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,EAAE,OAAO;IACX,UAAU,EAAE,SAAS;IACrB,eAAe,EAAE,SAAS;IAC1B,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,EAAE,EAAE,MAAM;IACV,UAAU,EAAE,SAAS;IACrB,eAAe,EAAE,SAAS;IAC1B,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAsB;IAC/D,OAAO;QACL,GAAG,KAAK;QACR,MAAM,EAAE;YACN,GAAG,KAAK,CAAC,MAAM;YACf,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B;KACF,CAAC;AACJ,CAAC"}

package/dist/schemas/Types.d.ts

@@ -1,14 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

package/dist/schemas/Types.js.map

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