@bendyline/squisq 0.1.2 → 1.1.0

package/dist/doc/templates/captionUtils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Template Utilities
+ *
+ * Shared helpers for doc block templates:
+ * - Caption text cleaning
+ * - Common layer construction patterns
+ */
+import type { Layer } from '../../schemas/Doc.js';
+/**
+ * Strip trailing punctuation from a caption string.
+ * Image captions on blocks look cleaner without terminal periods,
+ * semicolons, or other sentence-ending punctuation.
+ */
+export declare function cleanCaption(text: string): string;
+/**
+ * Create a full-screen background shape layer.
+ * Most text-based templates start with this as their first layer.
+ */
+export declare function createBackgroundLayer(id: string, fill: string): Layer;
+//# sourceMappingURL=captionUtils.d.ts.map

package/dist/doc/templates/captionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionUtils.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/captionUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAIlD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAOrE"}

package/dist/doc/templates/captionUtils.js

@@ -0,0 +1,29 @@
+/**
+ * Template Utilities
+ *
+ * Shared helpers for doc block templates:
+ * - Caption text cleaning
+ * - Common layer construction patterns
+ */
+const TRAILING_PUNCT_RE = /[.;:!?]+$/;
+/**
+ * Strip trailing punctuation from a caption string.
+ * Image captions on blocks look cleaner without terminal periods,
+ * semicolons, or other sentence-ending punctuation.
+ */
+export function cleanCaption(text) {
+    return text.replace(TRAILING_PUNCT_RE, '').trim();
+}
+/**
+ * Create a full-screen background shape layer.
+ * Most text-based templates start with this as their first layer.
+ */
+export function createBackgroundLayer(id, fill) {
+    return {
+        type: 'shape',
+        id,
+        content: { shape: 'rect', fill },
+        position: { x: 0, y: 0, width: '100%', height: '100%' },
+    };
+}
+//# sourceMappingURL=captionUtils.js.map

package/dist/doc/templates/captionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionUtils.js","sourceRoot":"","sources":["../../../src/doc/templates/captionUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAU,EAAE,IAAY;IAC5D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,EAAE;QACF,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/dist/doc/templates/comparisonBar.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Comparison Bar Template
+ *
+ * Two horizontal bars showing relative numeric values side by side.
+ * Bar widths are proportional to the values for immediate visual comparison.
+ * Good for population, distance, or measurement comparisons.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import type { Layer } from '../../schemas/Doc.js';
+import type { ComparisonBarInput, TemplateContext } from '../../schemas/BlockTemplates.js';
+export declare function comparisonBar(input: ComparisonBarInput, context: TemplateContext): Layer[];
+//# sourceMappingURL=comparisonBar.d.ts.map

package/dist/doc/templates/comparisonBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisonBar.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/comparisonBar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAI3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,EAAE,CA4H1F"}

package/dist/doc/templates/comparisonBar.js

@@ -0,0 +1,127 @@
+/**
+ * Comparison Bar Template
+ *
+ * Two horizontal bars showing relative numeric values side by side.
+ * Bar widths are proportional to the values for immediate visual comparison.
+ * Good for population, distance, or measurement comparisons.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import { scaledFontSize } from '../../schemas/BlockTemplates.js';
+import { resolveColorScheme } from '../utils/themeUtils.js';
+export function comparisonBar(input, context) {
+    const { leftLabel, leftValue, rightLabel, rightValue, unit, colorScheme = 'blue' } = input;
+    const { theme } = context;
+    const colors = resolveColorScheme(context, colorScheme);
+    const labelFontSize = scaledFontSize(28, context, false);
+    const valueFontSize = scaledFontSize(48, context, true);
+    // Calculate proportional bar widths (max bar = 65% of viewport width)
+    const maxValue = Math.max(leftValue, rightValue, 1);
+    const maxBarWidth = 65;
+    const leftBarWidth = (leftValue / maxValue) * maxBarWidth;
+    const rightBarWidth = (rightValue / maxValue) * maxBarWidth;
+    // Bar positioning
+    const barStartX = 15;
+    const barHeight = 6; // % of viewport height
+    const topBarY = 36;
+    const bottomBarY = 58;
+    // Format values for display
+    const formatValue = (v) => {
+        if (v >= 1000000)
+            return `${(v / 1000000).toFixed(1)}M`;
+        if (v >= 1000)
+            return `${(v / 1000).toFixed(v >= 10000 ? 0 : 1)}K`;
+        return v.toLocaleString();
+    };
+    const leftDisplay = unit ? `${formatValue(leftValue)} ${unit}` : formatValue(leftValue);
+    const rightDisplay = unit ? `${formatValue(rightValue)} ${unit}` : formatValue(rightValue);
+    return [
+        // Background
+        {
+            type: 'shape',
+            id: 'bg',
+            content: {
+                shape: 'rect',
+                fill: `linear-gradient(180deg, ${theme.colors.background} 0%, #0f1520 100%)`,
+            },
+            position: { x: 0, y: 0, width: '100%', height: '100%' },
+        },
+        // Top bar label
+        {
+            type: 'text',
+            id: 'left-label',
+            content: {
+                text: leftLabel,
+                style: { fontSize: labelFontSize, color: theme.colors.textMuted },
+            },
+            position: { x: `${barStartX}%`, y: `${topBarY - 8}%` },
+        },
+        // Top bar value
+        {
+            type: 'text',
+            id: 'left-value',
+            content: {
+                text: leftDisplay,
+                style: { fontSize: valueFontSize, fontWeight: 'bold', color: colors.text },
+            },
+            position: { x: `${barStartX + leftBarWidth + 2}%`, y: `${topBarY - 1}%` },
+            animation: { type: 'fadeIn', duration: 0.8, delay: 0.3 },
+        },
+        // Top bar
+        {
+            type: 'shape',
+            id: 'left-bar',
+            content: {
+                shape: 'rect',
+                fill: colors.text,
+                borderRadius: 4,
+            },
+            position: {
+                x: `${barStartX}%`,
+                y: `${topBarY}%`,
+                width: `${leftBarWidth}%`,
+                height: `${barHeight}%`,
+            },
+            animation: { type: 'fadeIn', duration: 1 },
+        },
+        // Bottom bar label
+        {
+            type: 'text',
+            id: 'right-label',
+            content: {
+                text: rightLabel,
+                style: { fontSize: labelFontSize, color: theme.colors.textMuted },
+            },
+            position: { x: `${barStartX}%`, y: `${bottomBarY - 8}%` },
+        },
+        // Bottom bar value
+        {
+            type: 'text',
+            id: 'right-value',
+            content: {
+                text: rightDisplay,
+                style: { fontSize: valueFontSize, fontWeight: 'bold', color: colors.accent },
+            },
+            position: { x: `${barStartX + rightBarWidth + 2}%`, y: `${bottomBarY - 1}%` },
+            animation: { type: 'fadeIn', duration: 0.8, delay: 0.6 },
+        },
+        // Bottom bar
+        {
+            type: 'shape',
+            id: 'right-bar',
+            content: {
+                shape: 'rect',
+                fill: colors.accent,
+                borderRadius: 4,
+            },
+            position: {
+                x: `${barStartX}%`,
+                y: `${bottomBarY}%`,
+                width: `${rightBarWidth}%`,
+                height: `${barHeight}%`,
+            },
+            animation: { type: 'fadeIn', duration: 1, delay: 0.3 },
+        },
+    ];
+}
+//# sourceMappingURL=comparisonBar.js.map

package/dist/doc/templates/comparisonBar.js.map

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

package/dist/doc/templates/coverBlock.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cover Block Template
+ *
+ * Full-screen hero image with title overlay, shown before playback starts.
+ * This is the "poster for the doc, displaying the
+ * article's hero image with elegant title treatment.
+ *
+ * Features:
+ * - Full-screen hero image with Ken Burns ambient motion
+ * - Gradient overlay for text readability
+ * - Large centered title with optional subtitle
+ * - No animation delays (shown at rest, not during playback)
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import type { Layer } from '../../schemas/Doc.js';
+import type { TemplateContext } from '../../schemas/BlockTemplates.js';
+import type { StartBlockConfig } from '../../schemas/Doc.js';
+/**
+ * Input for coverBlock template - matches StartBlockConfig
+ */
+export interface CoverBlockInput {
+    /** Path to hero image */
+    heroSrc: string;
+    /** Alt text for the hero image */
+    heroAlt?: string;
+    /** Title to display over the hero */
+    title: string;
+    /** Optional subtitle */
+    subtitle?: string;
+    /** Ambient motion for the hero image */
+    ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';
+    /** Photo credit / artist name */
+    heroCredit?: string;
+    /** License identifier */
+    heroLicense?: string;
+}
+/**
+ * Generate cover block layers from StartBlockConfig.
+ */
+export declare function coverBlock(input: CoverBlockInput, context: TemplateContext): Layer[];
+/**
+ * Convert StartBlockConfig to CoverBlockInput.
+ */
+export declare function startBlockToCoverInput(config: StartBlockConfig): CoverBlockInput;
+/**
+ * Expand a StartBlockConfig into a renderable Block.
+ * This is used by the player to render the cover block at rest.
+ */
+export declare function expandCoverBlock(config: StartBlockConfig, context: TemplateContext): Layer[];
+//# sourceMappingURL=coverBlock.d.ts.map

package/dist/doc/templates/coverBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverBlock.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/coverBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9D,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,EAAE,CAsFpF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAUhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,EAAE,CAG5F"}

package/dist/doc/templates/coverBlock.js

@@ -0,0 +1,125 @@
+/**
+ * Cover Block Template
+ *
+ * Full-screen hero image with title overlay, shown before playback starts.
+ * This is the "poster for the doc, displaying the
+ * article's hero image with elegant title treatment.
+ *
+ * Features:
+ * - Full-screen hero image with Ken Burns ambient motion
+ * - Gradient overlay for text readability
+ * - Large centered title with optional subtitle
+ * - No animation delays (shown at rest, not during playback)
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import { scaledFontSize } from '../../schemas/BlockTemplates.js';
+import { mapAmbientMotion } from './accentImage.js';
+/**
+ * Generate cover block layers from StartBlockConfig.
+ */
+export function coverBlock(input, context) {
+    const { heroSrc, heroAlt, title, subtitle, ambientMotion, heroCredit, heroLicense } = input;
+    const { theme, layout } = context;
+    // Scale font sizes for viewport - use larger sizes for the cover
+    const titleFontSize = scaledFontSize(96, context, true);
+    const subtitleFontSize = scaledFontSize(36, context, false);
+    // Determine Ken Burns animation
+    const imageAnimation = mapAmbientMotion(ambientMotion);
+    const layers = [
+        // Full-screen hero image
+        {
+            type: 'image',
+            id: 'cover-hero',
+            content: {
+                src: heroSrc,
+                alt: heroAlt || title,
+                fit: 'cover',
+                credit: heroCredit,
+                license: heroLicense,
+            },
+            position: { x: 0, y: 0, width: '100%', height: '100%' },
+            animation: imageAnimation,
+        },
+        // Gradient overlay for text readability - from bottom
+        {
+            type: 'shape',
+            id: 'cover-gradient',
+            content: {
+                shape: 'rect',
+                fill: 'linear-gradient(0deg, rgba(0,0,0,0.8) 0%, rgba(0,0,0,0.4) 40%, rgba(0,0,0,0.1) 70%, transparent 100%)',
+            },
+            position: { x: 0, y: 0, width: '100%', height: '100%' },
+        },
+        // Title - positioned lower in the frame to work with hero composition
+        {
+            type: 'text',
+            id: 'cover-title',
+            content: {
+                text: title,
+                style: {
+                    fontSize: titleFontSize,
+                    fontWeight: 'bold',
+                    color: theme.colors.text,
+                    textAlign: 'center',
+                    shadow: true,
+                },
+            },
+            position: {
+                x: '50%',
+                y: subtitle ? '70%' : '75%',
+                anchor: 'center',
+                width: layout.maxTextWidth,
+            },
+            // No animation delay - shown immediately at rest
+            animation: { type: 'fadeIn', duration: 0.8 },
+        },
+    ];
+    // Add subtitle if provided
+    if (subtitle) {
+        layers.push({
+            type: 'text',
+            id: 'cover-subtitle',
+            content: {
+                text: subtitle,
+                style: {
+                    fontSize: subtitleFontSize,
+                    color: theme.colors.textMuted,
+                    textAlign: 'center',
+                    lineHeight: 1.5,
+                },
+            },
+            position: {
+                x: '50%',
+                y: '82%',
+                anchor: 'center',
+                width: layout.maxTextWidth,
+            },
+            animation: { type: 'fadeIn', duration: 0.8, delay: 0.2 },
+        });
+    }
+    return layers;
+}
+/**
+ * Convert StartBlockConfig to CoverBlockInput.
+ */
+export function startBlockToCoverInput(config) {
+    return {
+        heroSrc: config.heroSrc,
+        heroAlt: config.heroAlt,
+        title: config.title,
+        subtitle: config.subtitle,
+        ambientMotion: config.ambientMotion,
+        heroCredit: config.heroCredit,
+        heroLicense: config.heroLicense,
+    };
+}
+/**
+ * Expand a StartBlockConfig into a renderable Block.
+ * This is used by the player to render the cover block at rest.
+ */
+export function expandCoverBlock(config, context) {
+    const input = startBlockToCoverInput(config);
+    return coverBlock(input, context);
+}
+//# sourceMappingURL=coverBlock.js.map

package/dist/doc/templates/coverBlock.js.map

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

package/dist/doc/templates/dateEvent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Date Event Template
+ *
+ * Timeline-style slide with prominent date and description.
+ * Supports different moods: neutral, somber, celebratory.
+ * Adapts font sizes and positioning for different viewports.
+ *
+ * Supports optional accent images that appear as tasteful side/bottom strips.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import type { Layer } from '../../schemas/Doc.js';
+import type { DateEventInput, TemplateContext } from '../../schemas/BlockTemplates.js';
+export declare function dateEvent(input: DateEventInput, context: TemplateContext): Layer[];
+//# sourceMappingURL=dateEvent.d.ts.map

package/dist/doc/templates/dateEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateEvent.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/dateEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAUvF,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,EAAE,CAkGlF"}

package/dist/doc/templates/dateEvent.js

@@ -0,0 +1,110 @@
+/**
+ * Date Event Template
+ *
+ * Timeline-style slide with prominent date and description.
+ * Supports different moods: neutral, somber, celebratory.
+ * Adapts font sizes and positioning for different viewports.
+ *
+ * Supports optional accent images that appear as tasteful side/bottom strips.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import { scaledFontSize } from '../../schemas/BlockTemplates.js';
+import { createAccentLayers, getAccentLayout, adjustY, DEFAULT_LAYOUT } from './accentImage.js';
+const MOOD_COLORS = {
+    neutral: { bg: '#1a202c', date: '#63b3ed', text: '#ffffff' },
+    somber: { bg: '#1a1a2e', date: '#e53e3e', text: '#a0aec0' },
+    celebratory: { bg: '#1a365d', date: '#68d391', text: '#ffffff' },
+};
+export function dateEvent(input, context) {
+    const { date, description, footer, mood = 'neutral', accentImage } = input;
+    const { theme } = context;
+    const colors = MOOD_COLORS[mood];
+    // Get layout adjustments if accent image is present
+    const accentLayout = accentImage ? getAccentLayout(accentImage.position) : DEFAULT_LAYOUT;
+    // Scale font sizes — date is the hero element
+    const dateFontSize = scaledFontSize(96, context, true);
+    const descFontSize = scaledFontSize(30, context, false);
+    const footerFontSize = scaledFontSize(26, context, false);
+    const layers = [
+        // Background — unique diagonal gradient to differentiate from other dark templates
+        {
+            type: 'shape',
+            id: 'bg',
+            content: {
+                shape: 'rect',
+                fill: `linear-gradient(135deg, ${colors.bg} 0%, #0d1117 100%)`,
+            },
+            position: { x: 0, y: 0, width: '100%', height: '100%' },
+        },
+    ];
+    // Add accent image layers (behind text, after background)
+    if (accentImage) {
+        layers.push(...createAccentLayers(accentImage, input.id));
+    }
+    // Date — hero element, much larger
+    layers.push({
+        type: 'text',
+        id: 'date',
+        content: {
+            text: date,
+            style: {
+                fontSize: dateFontSize,
+                fontWeight: 'bold',
+                color: colors.date,
+                shadow: !!accentImage,
+            },
+        },
+        position: {
+            x: accentLayout.textCenterX,
+            y: adjustY('35%', accentLayout),
+            anchor: 'center',
+        },
+        animation: { type: 'fadeIn', duration: 1.5 },
+    });
+    // Description - constrained width for proper text wrapping
+    layers.push({
+        type: 'text',
+        id: 'description',
+        content: {
+            text: description,
+            style: {
+                fontSize: descFontSize,
+                color: colors.text,
+                textAlign: 'center',
+                lineHeight: 1.8,
+                shadow: !!accentImage,
+            },
+        },
+        position: {
+            x: accentLayout.textCenterX,
+            y: adjustY('58%', accentLayout),
+            width: accentLayout.textWidth,
+            anchor: 'center',
+        },
+        animation: { type: 'fadeIn', duration: 2, delay: 1 },
+    });
+    // Add footer if provided
+    if (footer) {
+        layers.push({
+            type: 'text',
+            id: 'footer',
+            content: {
+                text: footer,
+                style: {
+                    fontSize: footerFontSize,
+                    color: theme.colors.textMuted,
+                    shadow: !!accentImage,
+                },
+            },
+            position: {
+                x: accentLayout.textCenterX,
+                y: adjustY('82%', accentLayout),
+                anchor: 'center',
+            },
+            animation: { type: 'fadeIn', duration: 1, delay: 3 },
+        });
+    }
+    return layers;
+}
+//# sourceMappingURL=dateEvent.js.map

package/dist/doc/templates/dateEvent.js.map

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

package/dist/doc/templates/definitionCard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Definition Card Template
+ *
+ * Dictionary-style slide with a large term and its definition.
+ * Good for explaining local words, place names, or cultural concepts.
+ * Supports optional accent images.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import type { Layer } from '../../schemas/Doc.js';
+import type { DefinitionCardInput, TemplateContext } from '../../schemas/BlockTemplates.js';
+export declare function definitionCard(input: DefinitionCardInput, context: TemplateContext): Layer[];
+//# sourceMappingURL=definitionCard.d.ts.map

package/dist/doc/templates/definitionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitionCard.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/definitionCard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAM5F,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,EAAE,CA+G5F"}