@bendyline/squisq-react 0.1.3 → 1.0.1

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Doc Player Control Types
+ *
+ * Shared type definitions for doc player controls across different
+ * layout modes (overlay, sidebar, bottom). These interfaces allow
+ * control components to be decoupled from the core DocPlayer.
+ *
+ * Related Files:
+ * - DocPlayer.tsx — Core player component
+ * - DocProgressBar.tsx — Extracted progress bar
+ * - DocControlsOverlay.tsx — Overlay controls (default)
+ * - DocControlsSidebar.tsx — Vertical sidebar controls
+ * - DocControlsBottom.tsx — Horizontal bottom strip controls
+ */
+import type { Block } from '@bendyline/squisq/schemas';
+/** Layout mode for doc player controls */
+export type ControlsLayout = 'overlay' | 'sidebar' | 'bottom';
+/**
+ * Display mode for DocPlayer.
+ *
+ * - `'video'` — Traditional video-style playback with play/pause, scrub bar,
+ *   and time-based auto-advance. Default mode.
+ * - `'slideshow'` — PowerPoint-style presentation with prev/next navigation.
+ *   Blocks are treated as static slides that only change on user click.
+ *   No auto-advance, no scrub bar.
+ * - `'linear'` — Long-scrolling document view. Renders the full markdown as
+ *   readable HTML with template-annotated sections shown as inline SVG cards.
+ *   No audio, no timeline, no controls — just a scrollable page.
+ */
+export type DisplayMode = 'video' | 'slideshow' | 'linear';
+/** Slide navigation actions for slideshow display mode */
+export interface SlideNavActions {
+    /** Navigate to the next slide */
+    nextSlide: () => void;
+    /** Navigate to the previous slide */
+    prevSlide: () => void;
+    /** Navigate to a specific slide by index (0-based) */
+    goToSlide: (index: number) => void;
+}
+/** Playback state exposed to external control components */
+export interface PlaybackState {
+    isPlaying: boolean;
+    currentTime: number;
+    totalDuration: number;
+    currentBlockIndex: number;
+    totalBlocks: number;
+    docProgress: number;
+    hasCaptions: boolean;
+    captionsEnabled: boolean;
+    isFullscreen?: boolean;
+    /** Current audio segment index (0-based) */
+    currentSegmentIndex: number;
+    /** Current audio segment name (e.g., 'intro', 'history') */
+    currentSegmentName: string | null;
+    /** Current block data (for extracting image info, etc.) */
+    currentBlock: Block | null;
+}
+/** Playback actions exposed to external control components */
+export interface PlaybackActions {
+    toggle: () => void;
+    restart: () => void;
+    seekTo: (time: number) => void;
+    setCaptionsEnabled: (enabled: boolean) => void;
+    toggleFullscreen?: () => void;
+}
+/** Block marker data for the progress bar */
+export interface BlockMarker {
+    block: Block;
+    index: number;
+    position: number;
+    title: string;
+    /** True if this block is the first in a new audio segment (section boundary) */
+    isSectionStart: boolean;
+}
+/** Block metadata returned by SquisqRenderAPI.getBlocks() */
+export interface RenderBlockInfo {
+    id: string;
+    template: string;
+    startTime: number;
+    duration: number;
+}
+/** Audio segment info returned by SquisqRenderAPI.getAudioSegments() */
+export interface RenderAudioSegmentInfo {
+    src: string;
+    name: string;
+    duration: number;
+    startTime: number;
+}
+/** Caption phrase info returned by SquisqRenderAPI.getCaptions() */
+export interface RenderCaptionInfo {
+    text: string;
+    startTime: number;
+    endTime: number;
+}
+/** Chapter marker returned by SquisqRenderAPI.getChapters() */
+export interface RenderChapterInfo {
+    title: string;
+    startTime: number;
+    duration: number;
+}
+/**
+ * API surface exposed on `window` in render mode and debug mode.
+ * Used by Playwright for video export and by ?debug=true for testing.
+ *
+ * @example
+ * ```ts
+ * // In Playwright:
+ * const w = window as unknown as SquisqWindow;
+ * await w.seekTo!(5.0);
+ * const blocks = w.getBlocks!();
+ * ```
+ */
+export interface SquisqRenderAPI {
+    seekTo: (time: number) => Promise<void>;
+    getDuration: () => number;
+    getBlocks: () => RenderBlockInfo[];
+    getAudioSegments: () => RenderAudioSegmentInfo[];
+    getCaptions: () => RenderCaptionInfo[];
+    getChapters: () => RenderChapterInfo[];
+    showCover: () => Promise<void>;
+    hideCover: () => Promise<void>;
+    hasCoverBlock: () => boolean;
+}
+/**
+ * Window augmented with optional SquisqRenderAPI properties.
+ * Each property is optional because they're only present in render/debug mode.
+ */
+export type SquisqWindow = Window & typeof globalThis & Partial<SquisqRenderAPI>;
+/** Format time in seconds to MM:SS string */
+export declare function formatTime(seconds: number): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2DAA2D;IAC3D,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,cAAc,EAAE,OAAO,CAAC;CACzB;AAMD,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,eAAe,EAAE,CAAC;IACnC,gBAAgB,EAAE,MAAM,sBAAsB,EAAE,CAAC;IACjD,WAAW,EAAE,MAAM,iBAAiB,EAAE,CAAC;IACvC,WAAW,EAAE,MAAM,iBAAiB,EAAE,CAAC;IACvC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEjF,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * Doc Player Control Types
+ *
+ * Shared type definitions for doc player controls across different
+ * layout modes (overlay, sidebar, bottom). These interfaces allow
+ * control components to be decoupled from the core DocPlayer.
+ *
+ * Related Files:
+ * - DocPlayer.tsx — Core player component
+ * - DocProgressBar.tsx — Extracted progress bar
+ * - DocControlsOverlay.tsx — Overlay controls (default)
+ * - DocControlsSidebar.tsx — Vertical sidebar controls
+ * - DocControlsBottom.tsx — Horizontal bottom strip controls
+ */
+/** Format time in seconds to MM:SS string */
+export function formatTime(seconds) {
+    const mins = Math.floor(seconds / 60);
+    const secs = Math.floor(seconds % 60);
+    return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqIH,6CAA6C;AAC7C,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/utils/animationUtils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Animation Utilities (React)
+ *
+ * Re-exports the shared animation utilities for use in the React package.
+ * All animation logic is in shared/doc/utils.
+ */
+export { getAnimationStyle, getDefaultAnimationDuration, getTransitionClass, getAnimationProgress, } from '@bendyline/squisq/doc';
+//# sourceMappingURL=animationUtils.d.ts.map

package/dist/utils/animationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationUtils.d.ts","sourceRoot":"","sources":["../../src/utils/animationUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/utils/animationUtils.js

@@ -0,0 +1,8 @@
+/**
+ * Animation Utilities (React)
+ *
+ * Re-exports the shared animation utilities for use in the React package.
+ * All animation logic is in shared/doc/utils.
+ */
+export { getAnimationStyle, getDefaultAnimationDuration, getTransitionClass, getAnimationProgress, } from '@bendyline/squisq/doc';
+//# sourceMappingURL=animationUtils.js.map

package/dist/utils/animationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationUtils.js","sourceRoot":"","sources":["../../src/utils/animationUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/utils/layerUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared utilities for layer components.
+ *
+ * Resolves position values and anchor offsets used by all layer types.
+ */
+/**
+ * Resolve a position value (number or percentage string) to pixels.
+ */
+export declare function resolveValue(value: number | string, dimension: number): number;
+/**
+ * Get offset based on anchor point.
+ */
+export declare function getAnchorOffset(anchor: string | undefined, width: number, height: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=layerUtils.d.ts.map

package/dist/utils/layerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerUtils.d.ts","sourceRoot":"","sources":["../../src/utils/layerUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAc1B"}

package/dist/utils/layerUtils.js

@@ -0,0 +1,37 @@
+/**
+ * Shared utilities for layer components.
+ *
+ * Resolves position values and anchor offsets used by all layer types.
+ */
+/**
+ * Resolve a position value (number or percentage string) to pixels.
+ */
+export function resolveValue(value, dimension) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (value.endsWith('%')) {
+        const percent = parseFloat(value);
+        return (percent / 100) * dimension;
+    }
+    return parseFloat(value);
+}
+/**
+ * Get offset based on anchor point.
+ */
+export function getAnchorOffset(anchor, width, height) {
+    switch (anchor) {
+        case 'center':
+            return { x: -width / 2, y: -height / 2 };
+        case 'top-right':
+            return { x: -width, y: 0 };
+        case 'bottom-left':
+            return { x: 0, y: -height };
+        case 'bottom-right':
+            return { x: -width, y: -height };
+        case 'top-left':
+        default:
+            return { x: 0, y: 0 };
+    }
+}
+//# sourceMappingURL=layerUtils.js.map

package/dist/utils/layerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerUtils.js","sourceRoot":"","sources":["../../src/utils/layerUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAsB,EAAE,SAAiB;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IACrC,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,KAAa,EACb,MAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,WAAW;YACd,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7B,KAAK,aAAa;YAChB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9B,KAAK,cAAc;YACjB,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QACnC,KAAK,UAAU,CAAC;QAChB;YACE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/utils/mapTileUtils.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Map Tile Utilities
+ *
+ * Functions for fetching and composing map tiles from free/open-source providers.
+ * Converts lat/lng to tile coordinates and composites multiple tiles into a
+ * single image for SVG embedding.
+ *
+ * Supported Providers (all free with attribution):
+ * - terrain: OpenTopoMap (CC-BY-SA)
+ * - road: OpenStreetMap (ODbL)
+ * - satellite: ESRI World Imagery (free with attribution)
+ * - toner: Stadia/Stamen Toner (free tier)
+ * - watercolor: Stadia/Stamen Watercolor (free tier)
+ *
+ * See docs/MAP_TILES.md for full provider details and terms.
+ */
+import type { MapTileStyle, MapMarker } from '@bendyline/squisq/schemas';
+/**
+ * Tile provider configuration.
+ */
+export interface TileProvider {
+    /** URL template with {z}, {x}, {y} placeholders */
+    url: string;
+    /** Attribution text (required for display) */
+    attribution: string;
+    /** Maximum zoom level */
+    maxZoom: number;
+    /** Tile size in pixels (default: 256) */
+    tileSize?: number;
+}
+/**
+ * Free tile providers for each map style.
+ * All require attribution to be displayed.
+ */
+export declare const TILE_PROVIDERS: Record<MapTileStyle, TileProvider>;
+/**
+ * Convert latitude/longitude to tile coordinates at a given zoom level.
+ * Uses Web Mercator projection (EPSG:3857).
+ */
+export declare function latLngToTile(lat: number, lng: number, zoom: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert tile coordinates back to lat/lng (top-left corner of tile).
+ */
+export declare function tileToLatLng(x: number, y: number, zoom: number): {
+    lat: number;
+    lng: number;
+};
+/**
+ * Get the pixel offset within a tile for a given lat/lng.
+ */
+export declare function getPixelOffset(lat: number, lng: number, zoom: number, tileSize?: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Calculate which tiles are needed to cover a viewport centered on lat/lng.
+ */
+export declare function getTilesForViewport(centerLat: number, centerLng: number, zoom: number, viewportWidth: number, viewportHeight: number, tileSize?: number): Array<{
+    x: number;
+    y: number;
+    screenX: number;
+    screenY: number;
+}>;
+/**
+ * Build a tile URL from the provider template.
+ */
+export declare function buildTileUrl(provider: TileProvider, x: number, y: number, z: number): string;
+/**
+ * Options for composing a map image.
+ */
+export interface ComposeMapOptions {
+    /** Center coordinates */
+    center: {
+        lat: number;
+        lng: number;
+    };
+    /** Zoom level */
+    zoom: number;
+    /** Map tile style */
+    style: MapTileStyle;
+    /** Output width in pixels */
+    width: number;
+    /** Output height in pixels */
+    height: number;
+    /** Optional markers to render */
+    markers?: MapMarker[];
+    /** Show attribution (default: true) */
+    showAttribution?: boolean;
+}
+/**
+ * Compose map tiles into a single data URL image.
+ *
+ * This is the main function for generating map images for blocks.
+ * It fetches all needed tiles, composites them on a canvas, and
+ * returns a data URL that can be used in an SVG <image> element.
+ */
+export declare function composeMapImage(options: ComposeMapOptions): Promise<string>;
+/**
+ * Get attribution text for a map style.
+ */
+export declare function getAttribution(style: MapTileStyle): string;
+//# sourceMappingURL=mapTileUtils.d.ts.map

package/dist/utils/mapTileUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapTileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mapTileUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CA0B7D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAM7F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAM7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAY,GACrB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAY,GACrB,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5F;AAeD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CjF;AA8HD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE1D"}

package/dist/utils/mapTileUtils.js

@@ -0,0 +1,268 @@
+/**
+ * Map Tile Utilities
+ *
+ * Functions for fetching and composing map tiles from free/open-source providers.
+ * Converts lat/lng to tile coordinates and composites multiple tiles into a
+ * single image for SVG embedding.
+ *
+ * Supported Providers (all free with attribution):
+ * - terrain: OpenTopoMap (CC-BY-SA)
+ * - road: OpenStreetMap (ODbL)
+ * - satellite: ESRI World Imagery (free with attribution)
+ * - toner: Stadia/Stamen Toner (free tier)
+ * - watercolor: Stadia/Stamen Watercolor (free tier)
+ *
+ * See docs/MAP_TILES.md for full provider details and terms.
+ */
+/**
+ * Free tile providers for each map style.
+ * All require attribution to be displayed.
+ */
+export const TILE_PROVIDERS = {
+    terrain: {
+        url: 'https://tile.opentopomap.org/{z}/{x}/{y}.png',
+        attribution: 'Map: OpenTopoMap (CC-BY-SA)',
+        maxZoom: 17,
+    },
+    road: {
+        url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+        attribution: '© OpenStreetMap contributors',
+        maxZoom: 19,
+    },
+    satellite: {
+        url: 'https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}',
+        attribution: 'Imagery: Esri, Maxar, Earthstar',
+        maxZoom: 18,
+    },
+    toner: {
+        url: 'https://tiles.stadiamaps.com/tiles/stamen_toner/{z}/{x}/{y}.png',
+        attribution: 'Map: Stadia Maps, Stamen Design',
+        maxZoom: 20,
+    },
+    watercolor: {
+        url: 'https://tiles.stadiamaps.com/tiles/stamen_watercolor/{z}/{x}/{y}.jpg',
+        attribution: 'Map: Stadia Maps, Stamen Design',
+        maxZoom: 16,
+    },
+};
+/**
+ * Convert latitude/longitude to tile coordinates at a given zoom level.
+ * Uses Web Mercator projection (EPSG:3857).
+ */
+export function latLngToTile(lat, lng, zoom) {
+    const n = Math.pow(2, zoom);
+    const x = Math.floor(((lng + 180) / 360) * n);
+    const latRad = (lat * Math.PI) / 180;
+    const y = Math.floor(((1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2) * n);
+    return { x, y };
+}
+/**
+ * Convert tile coordinates back to lat/lng (top-left corner of tile).
+ */
+export function tileToLatLng(x, y, zoom) {
+    const n = Math.pow(2, zoom);
+    const lng = (x / n) * 360 - 180;
+    const latRad = Math.atan(Math.sinh(Math.PI * (1 - (2 * y) / n)));
+    const lat = (latRad * 180) / Math.PI;
+    return { lat, lng };
+}
+/**
+ * Get the pixel offset within a tile for a given lat/lng.
+ */
+export function getPixelOffset(lat, lng, zoom, tileSize = 256) {
+    const n = Math.pow(2, zoom);
+    const xTile = ((lng + 180) / 360) * n;
+    const latRad = (lat * Math.PI) / 180;
+    const yTile = ((1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2) * n;
+    return {
+        x: (xTile - Math.floor(xTile)) * tileSize,
+        y: (yTile - Math.floor(yTile)) * tileSize,
+    };
+}
+/**
+ * Calculate which tiles are needed to cover a viewport centered on lat/lng.
+ */
+export function getTilesForViewport(centerLat, centerLng, zoom, viewportWidth, viewportHeight, tileSize = 256) {
+    const centerTile = latLngToTile(centerLat, centerLng, zoom);
+    const pixelOffset = getPixelOffset(centerLat, centerLng, zoom, tileSize);
+    // How many tiles we need in each direction
+    const tilesX = Math.ceil(viewportWidth / tileSize) + 1;
+    const tilesY = Math.ceil(viewportHeight / tileSize) + 1;
+    // Start tile offset
+    const startX = centerTile.x - Math.floor(tilesX / 2);
+    const startY = centerTile.y - Math.floor(tilesY / 2);
+    // Screen position of the center tile
+    const centerScreenX = viewportWidth / 2 - pixelOffset.x;
+    const centerScreenY = viewportHeight / 2 - pixelOffset.y;
+    const tiles = [];
+    for (let dy = 0; dy < tilesY; dy++) {
+        for (let dx = 0; dx < tilesX; dx++) {
+            const tileX = startX + dx;
+            const tileY = startY + dy;
+            const screenX = centerScreenX + (tileX - centerTile.x) * tileSize;
+            const screenY = centerScreenY + (tileY - centerTile.y) * tileSize;
+            tiles.push({ x: tileX, y: tileY, screenX, screenY });
+        }
+    }
+    return tiles;
+}
+/**
+ * Build a tile URL from the provider template.
+ */
+export function buildTileUrl(provider, x, y, z) {
+    return provider.url.replace('{z}', String(z)).replace('{x}', String(x)).replace('{y}', String(y));
+}
+/**
+ * Fetch a single tile image as an HTMLImageElement.
+ */
+async function fetchTileImage(url) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.crossOrigin = 'anonymous';
+        img.onload = () => resolve(img);
+        img.onerror = () => reject(new Error(`Failed to load tile: ${url}`));
+        img.src = url;
+    });
+}
+/**
+ * Compose map tiles into a single data URL image.
+ *
+ * This is the main function for generating map images for blocks.
+ * It fetches all needed tiles, composites them on a canvas, and
+ * returns a data URL that can be used in an SVG <image> element.
+ */
+export async function composeMapImage(options) {
+    const { center, zoom, style, width, height, markers = [], showAttribution = true } = options;
+    const provider = TILE_PROVIDERS[style];
+    const tileSize = provider.tileSize || 256;
+    const clampedZoom = Math.min(zoom, provider.maxZoom);
+    // Create canvas
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext('2d');
+    if (!ctx)
+        throw new Error('Failed to get canvas context');
+    // Fill with a neutral background in case tiles fail to load
+    ctx.fillStyle = style === 'toner' ? '#ffffff' : '#e5e7eb';
+    ctx.fillRect(0, 0, width, height);
+    // Get tiles needed
+    const tiles = getTilesForViewport(center.lat, center.lng, clampedZoom, width, height, tileSize);
+    // Fetch and draw tiles
+    const tilePromises = tiles.map(async (tile) => {
+        const url = buildTileUrl(provider, tile.x, tile.y, clampedZoom);
+        try {
+            const img = await fetchTileImage(url);
+            ctx.drawImage(img, tile.screenX, tile.screenY, tileSize, tileSize);
+        }
+        catch (err) {
+            // Tile failed to load - leave background color
+            console.warn(`Tile load failed: ${url}`, err);
+        }
+    });
+    await Promise.all(tilePromises);
+    // Draw markers
+    for (const marker of markers) {
+        drawMarker(ctx, marker, center, clampedZoom, width, height, tileSize);
+    }
+    // Draw attribution
+    if (showAttribution) {
+        drawAttribution(ctx, provider.attribution, width, height);
+    }
+    return canvas.toDataURL('image/png');
+}
+/**
+ * Draw a marker on the canvas.
+ */
+function drawMarker(ctx, marker, center, zoom, width, height, tileSize) {
+    // Calculate screen position of marker relative to center
+    const centerTile = latLngToTile(center.lat, center.lng, zoom);
+    const markerTile = latLngToTile(marker.lat, marker.lng, zoom);
+    const centerOffset = getPixelOffset(center.lat, center.lng, zoom, tileSize);
+    const markerOffset = getPixelOffset(marker.lat, marker.lng, zoom, tileSize);
+    const dx = (markerTile.x - centerTile.x) * tileSize + (markerOffset.x - centerOffset.x);
+    const dy = (markerTile.y - centerTile.y) * tileSize + (markerOffset.y - centerOffset.y);
+    const screenX = width / 2 + dx;
+    const screenY = height / 2 + dy;
+    // Draw marker
+    const color = marker.color || '#ef4444';
+    const icon = marker.icon || 'pin';
+    ctx.save();
+    if (icon === 'pin') {
+        // Draw pin shape
+        ctx.fillStyle = color;
+        ctx.beginPath();
+        ctx.arc(screenX, screenY - 12, 8, Math.PI, 0, false);
+        ctx.lineTo(screenX, screenY);
+        ctx.closePath();
+        ctx.fill();
+        // White dot in center
+        ctx.fillStyle = '#ffffff';
+        ctx.beginPath();
+        ctx.arc(screenX, screenY - 12, 3, 0, Math.PI * 2);
+        ctx.fill();
+    }
+    else if (icon === 'circle') {
+        ctx.fillStyle = color;
+        ctx.beginPath();
+        ctx.arc(screenX, screenY, 8, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.strokeStyle = '#ffffff';
+        ctx.lineWidth = 2;
+        ctx.stroke();
+    }
+    else if (icon === 'star') {
+        ctx.fillStyle = color;
+        drawStar(ctx, screenX, screenY, 5, 10, 5);
+        ctx.fill();
+    }
+    // Draw label if present
+    if (marker.label) {
+        ctx.fillStyle = '#1f2937';
+        ctx.font = 'bold 12px system-ui, sans-serif';
+        ctx.textAlign = 'center';
+        ctx.fillText(marker.label, screenX, screenY + 20);
+    }
+    ctx.restore();
+}
+/**
+ * Draw a star shape.
+ */
+function drawStar(ctx, cx, cy, spikes, outerRadius, innerRadius) {
+    let rot = (Math.PI / 2) * 3;
+    const step = Math.PI / spikes;
+    ctx.beginPath();
+    ctx.moveTo(cx, cy - outerRadius);
+    for (let i = 0; i < spikes; i++) {
+        ctx.lineTo(cx + Math.cos(rot) * outerRadius, cy + Math.sin(rot) * outerRadius);
+        rot += step;
+        ctx.lineTo(cx + Math.cos(rot) * innerRadius, cy + Math.sin(rot) * innerRadius);
+        rot += step;
+    }
+    ctx.lineTo(cx, cy - outerRadius);
+    ctx.closePath();
+}
+/**
+ * Draw attribution text on the canvas.
+ */
+function drawAttribution(ctx, text, width, height) {
+    ctx.save();
+    // Semi-transparent background
+    ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
+    const padding = 4;
+    ctx.font = '10px system-ui, sans-serif';
+    const textWidth = ctx.measureText(text).width;
+    ctx.fillRect(width - textWidth - padding * 2 - 4, height - 16, textWidth + padding * 2, 14);
+    // Text
+    ctx.fillStyle = '#374151';
+    ctx.textAlign = 'right';
+    ctx.fillText(text, width - padding - 4, height - 5);
+    ctx.restore();
+}
+/**
+ * Get attribution text for a map style.
+ */
+export function getAttribution(style) {
+    return TILE_PROVIDERS[style].attribution;
+}
+//# sourceMappingURL=mapTileUtils.js.map

package/dist/utils/mapTileUtils.js.map

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