@bendyline/squisq 1.5.2 → 2.0.1

package/dist/story/index.js

@@ -1,279 +0,0 @@
-import {
-  BASE_INPUT_DESCRIPTORS,
-  CONTAINER_TEMPLATES,
-  DEFAULT_LAYOUT,
-  SHAPE_NAMES,
-  TEMPLATE_ALIASES,
-  TEMPLATE_INPUT_DESCRIPTORS,
-  TEMPLATE_METADATA,
-  adjustY,
-  applyRenderStyleToLayers,
-  buildRegistry,
-  coerceTemplateParams,
-  comparisonBar,
-  computeDiagramLayout,
-  computeDrawingLayout,
-  computeLayoutLayers,
-  countBlocks,
-  coverBlock,
-  createAccentLayers,
-  cssFilterForTreatment,
-  dataTable,
-  dateEvent,
-  decodeLayersFromFrontmatter,
-  definitionCard,
-  deriveTemplateInputs,
-  diagramBlock,
-  docToMarkdown,
-  drawingBlock,
-  encodeLayersForFrontmatter,
-  expandCoverBlock,
-  expandDocBlocks,
-  expandPersistentLayers,
-  expandTemplateBlock,
-  extractBlockquoteText,
-  extractBodyPlainText,
-  extractFirstImage,
-  extractImages,
-  extractListItems,
-  extractTableData,
-  extractTableFromContents,
-  factCard,
-  fallbackBlockLayers,
-  findFirstTable,
-  flattenBlocks,
-  flattenRenderableBlocks,
-  fullBleedQuote,
-  getAccentLayout,
-  getAnimationProgress,
-  getAnimationStyle,
-  getAvailableTemplates,
-  getBlockDepth,
-  getDefaultAnimation,
-  getDefaultAnimationDuration,
-  getDocStyleConfig,
-  getLayers,
-  getOverlayOpacity,
-  getPersistentLayersFromTheme,
-  getTemplateHint,
-  getThemeFont,
-  getTransitionClass,
-  hasTemplate,
-  imageWithCaption,
-  isContainerTemplate,
-  isDataFence,
-  isShapeName,
-  layoutBlock,
-  leftFeature,
-  lintTemplateParams,
-  listBlock,
-  mapBlock,
-  markdownToDoc,
-  normalizeShapeKind,
-  parseDataFence,
-  parseYamlSubset,
-  photoGrid,
-  pullQuote,
-  quoteBlock,
-  readCustomTemplatesFromFrontmatter,
-  readCustomThemesFromFrontmatter,
-  replaceDataFence,
-  resolveAudioMapping,
-  resolveColorScheme,
-  resolvePersistentLayers,
-  resolveTemplateName,
-  resolveThemeForDoc,
-  rightFeature,
-  scaleAnimationDuration,
-  scoreTextSimilarity,
-  sectionHeader,
-  shouldUseShadow,
-  statHighlight,
-  templateRegistry,
-  themeWantsAmbientMotion,
-  themedEntrance,
-  themedFontSize,
-  themedImageTreatment,
-  themedScrim,
-  themedSurfaceGradient,
-  titleBlock,
-  twoColumn,
-  validateMarkdownDoc,
-  validateMarkdownSource,
-  videoPullQuote,
-  videoWithCaption,
-  wrapWithPersistentLayers,
-  writeCustomTemplatesToFrontmatter,
-  writeCustomThemesToFrontmatter
-} from "../chunk-5TYS5V3G.js";
-import "../chunk-UY7KGQ5R.js";
-import "../chunk-V543AI2F.js";
-import "../chunk-FVTQSNR7.js";
-import {
-  PATH_SHAPE_KINDS,
-  clipEndpoints,
-  clipPoint,
-  connectorPath,
-  lineStyleDasharray,
-  markerPath,
-  nearestSnapPoint,
-  shapePath,
-  snapEndpoints,
-  snapPoints
-} from "../chunk-LTN6I7QW.js";
-import {
-  DEFAULT_THEME,
-  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
-  FRONTMATTER_CUSTOM_THEMES_KEY,
-  getAvailableThemes,
-  getThemeSummaries,
-  resolveTheme
-} from "../chunk-KKNUBQ6Y.js";
-import {
-  VIEWPORT_PRESETS,
-  createTemplateContext,
-  getLayoutHints,
-  getTwoColumnPositions,
-  getViewport,
-  getViewportOrientation,
-  isTemplateBlock,
-  scaledFontSize2 as scaledFontSize
-} from "../chunk-DLXZMS5K.js";
-import "../chunk-BEQODJWV.js";
-import "../chunk-HWVFJAAH.js";
-import "../chunk-DBS6RIFL.js";
-import "../chunk-QE7TWGVT.js";
-import "../chunk-VWUFZ6ZG.js";
-export {
-  BASE_INPUT_DESCRIPTORS,
-  CONTAINER_TEMPLATES,
-  DEFAULT_LAYOUT,
-  DEFAULT_THEME,
-  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
-  FRONTMATTER_CUSTOM_THEMES_KEY,
-  PATH_SHAPE_KINDS,
-  SHAPE_NAMES,
-  TEMPLATE_ALIASES,
-  TEMPLATE_INPUT_DESCRIPTORS,
-  TEMPLATE_METADATA,
-  VIEWPORT_PRESETS,
-  adjustY,
-  applyRenderStyleToLayers,
-  buildRegistry,
-  clipEndpoints,
-  clipPoint,
-  coerceTemplateParams,
-  comparisonBar,
-  computeDiagramLayout,
-  computeDrawingLayout,
-  computeLayoutLayers,
-  connectorPath,
-  countBlocks,
-  coverBlock,
-  createAccentLayers,
-  createTemplateContext,
-  cssFilterForTreatment,
-  dataTable,
-  dateEvent,
-  decodeLayersFromFrontmatter,
-  definitionCard,
-  deriveTemplateInputs,
-  diagramBlock,
-  docToMarkdown,
-  drawingBlock,
-  encodeLayersForFrontmatter,
-  expandCoverBlock,
-  expandDocBlocks,
-  expandPersistentLayers,
-  expandTemplateBlock,
-  extractBlockquoteText,
-  extractBodyPlainText,
-  extractFirstImage,
-  extractImages,
-  extractListItems,
-  extractTableData,
-  extractTableFromContents,
-  factCard,
-  fallbackBlockLayers,
-  findFirstTable,
-  flattenBlocks,
-  flattenRenderableBlocks,
-  fullBleedQuote,
-  getAccentLayout,
-  getAnimationProgress,
-  getAnimationStyle,
-  getAvailableTemplates,
-  getAvailableThemes,
-  getBlockDepth,
-  getDefaultAnimation,
-  getDefaultAnimationDuration,
-  getDocStyleConfig,
-  getLayers,
-  getLayoutHints,
-  getOverlayOpacity,
-  getPersistentLayersFromTheme,
-  getTemplateHint,
-  getThemeFont,
-  getThemeSummaries,
-  getTransitionClass,
-  getTwoColumnPositions,
-  getViewport,
-  getViewportOrientation,
-  hasTemplate,
-  imageWithCaption,
-  isContainerTemplate,
-  isDataFence,
-  isShapeName,
-  isTemplateBlock,
-  layoutBlock,
-  leftFeature,
-  lineStyleDasharray,
-  lintTemplateParams,
-  listBlock,
-  mapBlock,
-  markdownToDoc,
-  markerPath,
-  nearestSnapPoint,
-  normalizeShapeKind,
-  parseDataFence,
-  parseYamlSubset,
-  photoGrid,
-  pullQuote,
-  quoteBlock,
-  readCustomTemplatesFromFrontmatter,
-  readCustomThemesFromFrontmatter,
-  replaceDataFence,
-  resolveAudioMapping,
-  resolveColorScheme,
-  resolvePersistentLayers,
-  resolveTemplateName,
-  resolveTheme,
-  resolveThemeForDoc,
-  rightFeature,
-  scaleAnimationDuration,
-  scaledFontSize,
-  scoreTextSimilarity,
-  sectionHeader,
-  shapePath,
-  shouldUseShadow,
-  snapEndpoints,
-  snapPoints,
-  statHighlight,
-  templateRegistry,
-  themeWantsAmbientMotion,
-  themedEntrance,
-  themedFontSize,
-  themedImageTreatment,
-  themedScrim,
-  themedSurfaceGradient,
-  titleBlock,
-  twoColumn,
-  validateMarkdownDoc,
-  validateMarkdownSource,
-  videoPullQuote,
-  videoWithCaption,
-  wrapWithPersistentLayers,
-  writeCustomTemplatesToFrontmatter,
-  writeCustomThemesToFrontmatter
-};
-//# sourceMappingURL=index.js.map

package/src/doc/getLayers.ts

@@ -1,195 +0,0 @@
-/**
- * getLayers — Compute visual layers for a block on demand.
- *
- * This is the preferred way to obtain renderable layers for a block.
- * Instead of storing pre-computed layers on the Block object, call
- * `getLayers(block, context)` to derive them from the block's template
- * name, content, and the current render context (theme, viewport, etc.).
- *
- * For raw blocks that already carry a `layers` array, those layers are
- * returned directly (with optional persistent layer injection).
- *
- * @example
- * ```ts
- * import { getLayers } from '@bendyline/squisq/doc';
- *
- * const layers = getLayers(block, {
- *   theme: DEFAULT_THEME,
- *   viewport: VIEWPORT_PRESETS.landscape,
- *   blockIndex: 0,
- *   totalBlocks: 10,
- * });
- * ```
- */
-
-import type { Block, Layer } from '../schemas/Doc.js';
-import type {
-  TemplateBlock,
-  TemplateContext,
-  PersistentLayerConfig,
-  DocBlock,
-} from '../schemas/BlockTemplates.js';
-import type { Theme } from '../schemas/Theme.js';
-import type { ViewportConfig } from '../schemas/Viewport.js';
-import { VIEWPORT_PRESETS } from '../schemas/Viewport.js';
-import { createTemplateContext, isTemplateBlock } from '../schemas/BlockTemplates.js';
-import { DEFAULT_THEME } from '../schemas/themeLibrary.js';
-import { templateRegistry, resolveTemplateName } from './templates/index.js';
-import { coerceTemplateParams } from './templates/inputDescriptors.js';
-import { expandPersistentLayers, wrapWithPersistentLayers } from './templates/persistentLayers.js';
-import { applyRenderStyleToLayers } from './utils/applyRenderStyle.js';
-import { fallbackBlockLayers } from './templates/fallbackBlock.js';
-
-// ============================================
-// RenderContext
-// ============================================
-
-/**
- * Context needed to compute layers for a block.
- *
- * Captures the visual rendering parameters: theme colors, viewport
- * configuration, persistent layers, and the block's position within
- * the doc (for template functions that vary output by index).
- */
-export interface RenderContext {
-  /** Theme for template rendering. Defaults to DEFAULT_THEME (documentary). */
-  theme?: Theme;
-
-  /** Target viewport configuration. Defaults to 16:9 landscape. */
-  viewport?: ViewportConfig;
-
-  /** Persistent layers injected behind and/or on top of all block content. */
-  persistentLayers?: PersistentLayerConfig;
-
-  /** 0-based index of this block in the sequence. Defaults to 0. */
-  blockIndex?: number;
-
-  /** Total number of blocks in the doc. Defaults to 1. */
-  totalBlocks?: number;
-}
-
-// ============================================
-// getLayers
-// ============================================
-
-/**
- * Compute the visual layers for a block.
- *
- * Resolution order:
- * 1. If the block already has a non-empty `layers` array, use it (raw block).
- * 2. If the block has a `template` name that exists in the registry,
- *    call the template function to generate layers.
- * 3. Otherwise return an empty array.
- *
- * Persistent layers (bottom/top) from the render context are injected
- * around the result unless the block opts out via `useBottomLayer: false`
- * or `useTopLayer: false`.
- *
- * @param block   A Block or TemplateBlock to render.
- * @param context Render context (theme, viewport, persistent layers, position).
- * @returns The computed Layer[] for the block, ready for BlockRenderer.
- */
-export function getLayers(block: DocBlock, context: RenderContext = {}): Layer[] {
-  const theme = context.theme ?? DEFAULT_THEME;
-  const viewport = context.viewport ?? VIEWPORT_PRESETS.landscape;
-  const blockIndex = context.blockIndex ?? 0;
-  const totalBlocks = context.totalBlocks ?? 1;
-
-  // 1. Raw block path: block already has pre-computed layers
-  const existingLayers = (block as Block).layers;
-  if (existingLayers && existingLayers.length > 0 && !isTemplateBlock(block)) {
-    return injectPersistentLayers(existingLayers, block, context);
-  }
-
-  // 2. Template path: look up and call the template function.
-  //
-  // Resolve through TEMPLATE_ALIASES so legacy ids (`titleBlock`,
-  // `quoteBlock`, `mapBlock`, `listBlock`) hit the registry by their
-  // canonical short names. Without this the block-section path renders
-  // an empty SVG card: `hasTemplate()` accepts the alias (so
-  // `isAnnotatedBlock` returns true and the card wrapper renders), but
-  // a raw `block.template in templateRegistry` check below misses it
-  // and the layer list comes back empty.
-  if (isTemplateBlock(block)) {
-    const resolved = resolveTemplateName(block.template);
-    const templateCtx = createTemplateContext(theme, blockIndex, totalBlocks, viewport);
-    if (resolved in templateRegistry) {
-      const templateName = resolved as keyof typeof templateRegistry;
-      // Aggregate templates (e.g. `diagram`) consume the block's children.
-      const maybeChildren = (block as Block).children;
-      if (maybeChildren && maybeChildren.length > 0) {
-        templateCtx.children = maybeChildren;
-      }
-      // Effective template input: the block's own fields, then structured
-      // body data (```json data fences, GFM tables), then `{[…]}` string
-      // overrides — the same merge order buildPreviewDoc uses. Inline overrides
-      // are coerced to their typed shape (`center="47.6,-122.3"` → `{lat,lng}`,
-      // `zoom=9` → `9`) so pure-inline annotations render without any change to
-      // the template functions. `block.templateOverrides` itself stays raw
-      // strings for lossless round-tripping — only this ephemeral input is coerced.
-      const { templateData, templateOverrides } = block as Block;
-      const input =
-        templateData || templateOverrides
-          ? ({
-              ...block,
-              ...templateData,
-              ...coerceTemplateParams(block.template, templateOverrides ?? {}).input,
-            } as TemplateBlock)
-          : block;
-      let layers: Layer[];
-      try {
-        // Each registry entry accepts its specific TemplateBlock variant; the
-        // discriminated union guarantees the shapes match at runtime.
-        const templateFn = templateRegistry[templateName] as (
-          input: TemplateBlock,
-          ctx: TemplateContext,
-        ) => Layer[];
-        layers = templateFn(input, templateCtx);
-        if (!Array.isArray(layers)) {
-          console.warn(`Template ${templateName} did not return an array, got:`, typeof layers);
-          layers = fallbackBlockLayers(block, templateCtx, `Template "${block.template}" failed`);
-        }
-      } catch (err: unknown) {
-        console.warn(`Error expanding template ${templateName}:`, err);
-        layers = fallbackBlockLayers(block, templateCtx, `Template "${block.template}" failed`);
-      }
-
-      // Theme motion defaults apply to template-generated layers only
-      // (mirrors expandDocBlocks — the two paths must agree).
-      layers = applyRenderStyleToLayers(layers, block as Block, theme);
-
-      return injectPersistentLayers(layers, block, context);
-    }
-
-    // Unknown template — graceful-degradation guarantee: render the
-    // block's heading + body text as a plain card with a visible notice
-    // instead of a blank slide.
-    return injectPersistentLayers(
-      fallbackBlockLayers(block, templateCtx, `Unknown template "${block.template}"`),
-      block,
-      context,
-    );
-  }
-
-  // 3. Fallback: no layers and no template requested
-  return injectPersistentLayers([], block, context);
-}
-
-// ============================================
-// Internal helpers
-// ============================================
-
-/**
- * Inject persistent bottom/top layers around the block's own layers,
- * respecting per-block opt-out flags.
- */
-function injectPersistentLayers(layers: Layer[], block: DocBlock, context: RenderContext): Layer[] {
-  const { persistentLayers } = context;
-  if (!persistentLayers) return layers;
-
-  const theme = context.theme ?? DEFAULT_THEME;
-  const bottomLayers = expandPersistentLayers(persistentLayers.bottomLayers, theme);
-  const topLayers = expandPersistentLayers(persistentLayers.topLayers, theme);
-
-  return wrapWithPersistentLayers(layers, block as TemplateBlock, bottomLayers, topLayers);
-}