@keboola/design 13.2.0 → 14.0.0

package/dist/flint.js

@@ -1,40 +1,14 @@
-import { DiagramSkeleton } from "./internal/blocks/DiagramShared/DiagramSkeleton.js";
-import { DiagramSource } from "./DiagramSource-jTwmmi9g.js";
 import { useThemeAttributes } from "./useThemeAttributes-B199Regy.js";
-import { ZoomableSvg } from "./ZoomableSvg-D8sXKpoV.js";
-import { SERIES_TOKENS, createVegaColorResolver, vegaRgb, vegaTheme } from "./vegaTheme-VQMWTlBw.js";
-import { makeResponsive } from "./svgTransforms-Dw2hRA-i.js";
+import { DiagramSkeleton } from "./internal/blocks/DiagramShared/DiagramSkeleton.js";
+import { DiagramSource, makeResponsive } from "./svgTransforms-Hnvev3Vs.js";
+import { ZoomableSvg } from "./ZoomableSvg-Dh1OstPN.js";
+import { SERIES_TOKENS, createVegaColorResolver, tierTwoColour } from "./vegaTokens-Ce07C0DH.js";
+import { vegaTheme } from "./vegaTheme-BrmVoPEz.js";
+import { createSvgCache, diagramCacheKey } from "./svgCache-Dhmbe-7i.js";
 import { useEffect, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/blocks/FlintChart/flintTheme.ts
 /**
-* How the second palette tier (series 6-10) is derived from the core hues.
-*
-* - Each hue moves *away* from its surface: darker on light, lighter on dark.
-*   Darkening on dark would drop contrast from ~6.7:1 to ~3.7:1.
-* - `amount` is the fraction of the distance travelled toward `towards`.
-*/
-const TIER_TWO_SHIFT = {
-	light: {
-		towards: 0,
-		amount: .38
-	},
-	dark: {
-		towards: 255,
-		amount: .35
-	}
-};
-/**
-* Move an `rgb()` string's channels a fraction of the way toward `towards`
-* (0 = black, 255 = white). Returns the input unchanged if it is not that shape.
-*/
-const shiftChannels = (colour, towards, amount) => {
-	const channels = colour.match(/\d+/g);
-	if (!channels || channels.length < 3) return colour;
-	const shifted = channels.slice(0, 3).map((c) => Math.round(Number(c) + (towards - Number(c)) * amount));
-	return vegaRgb(shifted.join(" "));
-};
-/**
 * Put the design system's `--chart-1..5` palette on a Flint input.
 *
 * - Flint resolves series colours during assembly, so they ride `theme_spec`, not `vegaTheme`.
@@ -63,7 +37,7 @@ const withFlintSeriesPalette = (input, scheme, from) => {
 			},
 			series: {
 				categorical,
-				categoricalExtended: [...categorical, ...categorical.map((colour) => shiftChannels(colour, TIER_TWO_SHIFT[scheme].towards, TIER_TWO_SHIFT[scheme].amount))],
+				categoricalExtended: [...categorical, ...categorical.map((colour) => tierTwoColour(colour, scheme))],
 				overflow: token("muted-foreground"),
 				sequential: {
 					stops: [token("accent"), token("chart-1")],
@@ -201,20 +175,11 @@ const getFlintRuntime = () => {
 };
 const RENDER_DEBOUNCE_MS = 300;
 const MAX_SOURCE_CHARS = 2e5;
-const MAX_CACHED_CHARTS = 24;
-const svgCache = /* @__PURE__ */ new Map();
-const cacheSvg = (key, svg) => {
-	if (!svgCache.has(key) && svgCache.size >= MAX_CACHED_CHARTS) {
-		const oldest = svgCache.keys().next();
-		if (!oldest.done) svgCache.delete(oldest.value);
-	}
-	svgCache.set(key, svg);
-};
-const chartCacheKey = (code, themeKey) => `${themeKey}\n${code}`;
+const svgCache = createSvgCache();
 const prevThemeKeyOf = (key) => key.slice(0, key.indexOf("\n"));
 const FlintChart = ({ code, renderActions }) => {
 	const { scheme, cacheKey: themeKey, scope } = useThemeAttributes();
-	const cacheKey = chartCacheKey(code, themeKey);
+	const cacheKey = diagramCacheKey(code, themeKey);
 	const [svg, setSvg] = useState(() => svgCache.get(cacheKey) ?? null);
 	const [renderFailed, setRenderFailed] = useState(false);
 	const [prevKey, setPrevKey] = useState(cacheKey);
@@ -254,7 +219,7 @@ const FlintChart = ({ code, renderActions }) => {
 				if (cancelled) return;
 				const svgOutput = makeResponsive(await renderFlintSvg(runtime, withFlintSeriesPalette(input, scheme, scope), vegaTheme(scheme, scope)));
 				if (cancelled) return;
-				cacheSvg(cacheKey, svgOutput);
+				svgCache.set(cacheKey, svgOutput);
 				setSvg(svgOutput);
 				setRenderFailed(false);
 			}).catch((err) => {

package/dist/flint.js.map

@@ -1 +1 @@
-{"version":3,"file":"flint.js","names":[],"sources":["../src/blocks/FlintChart/flintTheme.ts","../src/blocks/FlintChart/refuseUnsafeSpec.ts","../src/blocks/FlintChart/renderFlintSvg.ts","../src/blocks/FlintChart/FlintChart.tsx"],"sourcesContent":["import type { ChartAssemblyInput } from 'flint-chart';\n\nimport type { ResolvedColorScheme } from '../../components/ThemeProvider/types';\nimport { createVegaColorResolver, SERIES_TOKENS, vegaRgb } from '../../vega/vegaTokens';\n\n/**\n * How the second palette tier (series 6-10) is derived from the core hues.\n *\n * - Each hue moves *away* from its surface: darker on light, lighter on dark.\n *   Darkening on dark would drop contrast from ~6.7:1 to ~3.7:1.\n * - `amount` is the fraction of the distance travelled toward `towards`.\n */\nconst TIER_TWO_SHIFT = {\n  light: { towards: 0, amount: 0.38 },\n  dark: { towards: 255, amount: 0.35 },\n} as const;\n\n/**\n * Move an `rgb()` string's channels a fraction of the way toward `towards`\n * (0 = black, 255 = white). Returns the input unchanged if it is not that shape.\n */\nconst shiftChannels = (colour: string, towards: number, amount: number): string => {\n  const channels = colour.match(/\\d+/g);\n  if (!channels || channels.length < 3) return colour;\n  const shifted = channels\n    .slice(0, 3)\n    .map((c) => Math.round(Number(c) + (towards - Number(c)) * amount));\n  return vegaRgb(shifted.join(' '));\n};\n\n/**\n * Put the design system's `--chart-1..5` palette on a Flint input.\n *\n * - Flint resolves series colours during assembly, so they ride `theme_spec`, not `vegaTheme`.\n * - An author-supplied `theme_spec` is passed through untouched.\n * - A `null` `theme_spec` is replaced like a missing one — flint throws on it.\n */\nexport const withFlintSeriesPalette = (\n  input: ChartAssemblyInput,\n  scheme: ResolvedColorScheme,\n  from?: Element | null,\n): ChartAssemblyInput => {\n  if (input.theme_spec !== undefined && input.theme_spec !== null) return input;\n\n  const token = createVegaColorResolver(scheme, from);\n  const categorical = SERIES_TOKENS.map((name) => token(name));\n\n  return {\n    ...input,\n    theme_spec: {\n      ink: {\n        // `endpointsAgainstSurface` below needs to know what the chart sits on.\n        surface: { canvas: token('card') },\n        // Flint's defaults assume a light canvas, so text and structure come from tokens.\n        text: {\n          primary: token('foreground'),\n          secondary: token('muted-foreground'),\n          muted: token('muted-foreground'),\n          // Ink on a filled (series-coloured) mark.\n          inverse: token('card'),\n        },\n        structure: {\n          axis: token('border'),\n          grid: token('border'),\n          frame: token('border'),\n          rule: token('border'),\n        },\n        series: {\n          categorical,\n          // Past five series flint swaps `categorical` for its theme-blind `tableau10`;\n          // this keeps 6-10 on our hues (`TIER_TWO_SHIFT`).\n          categoricalExtended: [\n            ...categorical,\n            ...categorical.map((colour) =>\n              shiftChannels(colour, TIER_TWO_SHIFT[scheme].towards, TIER_TWO_SHIFT[scheme].amount),\n            ),\n          ],\n          // The tail past even the extended set.\n          overflow: token('muted-foreground'),\n          // For a quantitative `color` field; flint's default starts at black, invisible on dark.\n          sequential: {\n            stops: [token('accent'), token('chart-1')],\n            space: 'lab',\n            endpointsAgainstSurface: true,\n          },\n        },\n      },\n    },\n  };\n};\n","/**\n * The boundary in front of the flint renderer: nothing in a spec may fetch or run.\n *\n * - Checked on the input, before `assembleVegaLite`: compiled Vega carries its own `signals`/`expr`.\n * - Refused on a key's presence, not its value: a relative `data.url` is still a fetch.\n */\n\n/** Keys whose presence anywhere in a spec is refused: each fetches, evaluates or binds a signal. */\nconst REFUSED_KEYS = new Set(['url', 'expr', 'signal', 'signals', 'params']);\n\n/** Suffix of Vega-Lite's other expression properties; matched by shape so new ones are refused. */\nconst EXPRESSION_KEY_SUFFIX = /Expr$/;\n\n/**\n * An own property's value, or `undefined`.\n *\n * - Via a descriptor: inherited keys are ignored and a getter is never called.\n */\nconst ownValue = (node: unknown, key: string): unknown => {\n  if (typeof node !== 'object' || node === null) return undefined;\n\n  return Object.getOwnPropertyDescriptor(node, key)?.value;\n};\n\n/**\n * The chart's rows (`spec.data.values` only), which the walk does not descend into.\n *\n * - Rows are data vega never evaluates, so a column named `url` must not be refused.\n * - Flint takes one top-level dataset, so every other node is spec.\n * - Skipped by identity, not key name: a `values` key elsewhere must not hide a refused key.\n */\nconst inlineRows = (spec: unknown): unknown[] | null => {\n  const values = ownValue(ownValue(spec, 'data'), 'values');\n\n  return Array.isArray(values) ? values : null;\n};\n\n/**\n * The top-level maps flint keys by column name, so their keys are data, not spec.\n *\n * - Only the keys are exempt; each value is walked like any other node.\n * - Matched by identity, as in `inlineRows`: a nested object with the same name gets no exemption.\n */\nconst COLUMN_KEYED_MAPS = ['semantic_types', 'field_display_names'];\n\nconst columnKeyedMaps = (spec: unknown): unknown[] =>\n  COLUMN_KEYED_MAPS.map((key) => ownValue(spec, key)).filter(\n    (map) => typeof map === 'object' && map !== null,\n  );\n\n/** Ceiling on the nodes the walk visits; exceeding it refuses, since the spec went unchecked. */\nconst MAX_SPEC_NODES = 10_000;\n\nconst TOO_LARGE = 'is too large to check';\n\n/**\n * Why this spec may not be rendered, or `null` if it may.\n *\n * - The reason goes to the console; the reader sees `DiagramSource`'s fallback.\n * - Iterative, so deep nesting cannot overflow the stack; nodes are charged on push.\n * - An accessor is refused, not skipped: its value cannot be read without running it.\n */\nexport const findUnsafeSpecKey = (spec: unknown): string | null => {\n  const rows = inlineRows(spec);\n  const columnKeyed = columnKeyedMaps(spec);\n  const stack: unknown[] = [spec];\n  let visited = 1;\n\n  while (stack.length > 0) {\n    const node = stack.pop();\n\n    if (Array.isArray(node)) {\n      visited += node.length;\n      if (visited > MAX_SPEC_NODES) return TOO_LARGE;\n      stack.push(...node);\n      continue;\n    }\n\n    if (typeof node !== 'object' || node === null) continue;\n\n    const keysAreColumnNames = columnKeyed.includes(node);\n\n    // Descriptors: skip inherited keys and never call a getter.\n    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(node))) {\n      if (!keysAreColumnNames && (REFUSED_KEYS.has(key) || EXPRESSION_KEY_SUFFIX.test(key))) {\n        return `carries \\`${key}\\``;\n      }\n      if (!('value' in descriptor)) return `carries an accessor at \\`${key}\\``;\n\n      const { value } = descriptor;\n      if (rows !== null && value === rows) continue;\n\n      visited += 1;\n      if (visited > MAX_SPEC_NODES) return TOO_LARGE;\n      stack.push(value);\n    }\n  }\n\n  return null;\n};\n","import type { ChartAssemblyInput } from 'flint-chart';\nimport type { assembleVegaLite } from 'flint-chart/vegalite';\nimport type * as vega from 'vega';\nimport type * as vegaLite from 'vega-lite';\nimport type { Config, TopLevelSpec } from 'vega-lite';\n\nimport { findUnsafeSpecKey } from './refuseUnsafeSpec';\n\n// The lazily imported modules the pipeline needs; a parameter so tests can pass a fake runtime.\nexport type FlintRuntime = {\n  assembleVegaLite: typeof assembleVegaLite;\n  vega: Pick<typeof vega, 'View' | 'parse'>;\n  vegaLite: Pick<typeof vegaLite, 'compile'>;\n};\n\n/**\n * Compile a Flint `ChartAssemblyInput` to a static SVG string.\n *\n * - The one place unsafe input is refused (`refuseUnsafeSpec.ts`), before anything compiles it.\n * - Flint's `_`-prefixed hint keys are not Vega-Lite schema and are stripped before compiling.\n * - `config` rides the compile options; flint's spec-side config sets no colours to conflict.\n * - Renders headless; `toSVG()` is the only output.\n */\nexport const renderFlintSvg = async (\n  runtime: FlintRuntime,\n  input: ChartAssemblyInput,\n  config: Config,\n): Promise<string> => {\n  const unsafe = findUnsafeSpecKey(input);\n  if (unsafe !== null) {\n    throw new Error(`Refusing to render a flint spec that ${unsafe}`);\n  }\n\n  const assembled: Record<string, unknown> = runtime.assembleVegaLite(input);\n  // `assembleVegaLite` is typed loosely upstream; without the hint keys it is a Vega-Lite spec.\n  const vlSpec = Object.fromEntries(\n    Object.entries(assembled).filter(([key]) => !key.startsWith('_')),\n  ) as unknown as TopLevelSpec;\n  const { spec } = runtime.vegaLite.compile(vlSpec, { config });\n  const view = new runtime.vega.View(runtime.vega.parse(spec), { renderer: 'none' });\n  try {\n    await view.runAsync();\n    return await view.toSVG();\n  } finally {\n    view.finalize();\n  }\n};\n","import { useEffect, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { ChartAssemblyInput } from 'flint-chart';\n\nimport { useThemeAttributes } from '../../components/ThemeProvider/useThemeAttributes';\nimport { ZoomableSvg } from '../../components/ZoomableSvg';\nimport { vegaTheme } from '../../vega/vegaTheme';\nimport { DiagramSkeleton } from '../DiagramShared/DiagramSkeleton';\nimport { DiagramSource } from '../DiagramShared/DiagramSource';\nimport { makeResponsive } from '../DiagramShared/svgTransforms';\n\nimport { withFlintSeriesPalette } from './flintTheme';\nimport type { FlintRuntime } from './renderFlintSvg';\nimport { renderFlintSvg } from './renderFlintSvg';\n\nlet runtimePromise: Promise<FlintRuntime> | null = null;\n\n// Memoized chart-stack import, reset on failure so a chunk-load error can retry.\n// Mirrors `getMermaid()` in `MermaidDiagram`.\nconst getFlintRuntime = (): Promise<FlintRuntime> => {\n  if (!runtimePromise) {\n    runtimePromise = Promise.all([\n      import('flint-chart/vegalite'),\n      import('vega'),\n      import('vega-lite'),\n    ])\n      .then(([flint, vega, vegaLite]) => ({\n        assembleVegaLite: flint.assembleVegaLite,\n        vega,\n        vegaLite,\n      }))\n      .catch((err) => {\n        runtimePromise = null;\n        throw err;\n      });\n  }\n  return runtimePromise;\n};\n\nconst RENDER_DEBOUNCE_MS = 300;\n\n// A streaming fence is unparseable just like a broken one, so unparseable source\n// keeps the skeleton until it has been unchanged this long, then shows as raw source.\nconst PARSE_GRACE_MS = 1500;\n\n// Parse, compile and layout are synchronous, so a larger source would freeze the chat.\n// Far above the prompt's ~50-row inline data cap.\nconst MAX_SOURCE_CHARS = 200_000;\n\n// SVG cache that survives remounts.\n// - Keyed by theme key + code: colours are baked into the markup.\n// - Values are already `makeResponsive`d, so ZoomableSvg's sanitize memo stays stable.\n// - Bounded and evicted oldest-first (`Map` insertion order): entries run to hundreds of KB.\nconst MAX_CACHED_CHARTS = 24;\nconst svgCache = new Map<string, string>();\n\nconst cacheSvg = (key: string, svg: string): void => {\n  // Overwriting an existing key adds no entry, so it must not evict one.\n  if (!svgCache.has(key) && svgCache.size >= MAX_CACHED_CHARTS) {\n    const oldest = svgCache.keys().next();\n    if (!oldest.done) svgCache.delete(oldest.value);\n  }\n  svgCache.set(key, svg);\n};\n\nconst chartCacheKey = (code: string, themeKey: string): string => `${themeKey}\\n${code}`;\n\n// The theme half of a cache key — tells a still-streaming spec from a theme switch.\nconst prevThemeKeyOf = (key: string): string => key.slice(0, key.indexOf('\\n'));\n\ntype Props = {\n  /** Raw source of a ```flint fence: a flint-chart `ChartAssemblyInput` as JSON. */\n  code: string;\n  /** Extra toolbar controls (e.g. `ExportMenu`) for `ZoomableSvg`; receives the sanitized SVG. */\n  renderActions?: (safeSvg: string) => ReactNode;\n};\n\nexport const FlintChart = ({ code, renderActions }: Props) => {\n  // - Re-renders on a scheme or brand change, same contract as MermaidDiagram.\n  // - `scope` is the element tokens are read off (`null` = `<html>`); it is part of `themeKey`.\n  const { scheme, cacheKey: themeKey, scope } = useThemeAttributes();\n  const cacheKey = chartCacheKey(code, themeKey);\n\n  const [svg, setSvg] = useState<string | null>(() => svgCache.get(cacheKey) ?? null);\n  const [renderFailed, setRenderFailed] = useState(false);\n\n  // Reset stale state synchronously on a code or theme change (no one-frame flash):\n  // 1. A cache hit is applied at once.\n  // 2. Same theme, source only grew (still streaming): keep the last chart, no flicker.\n  // 3. Anything else clears — colours are baked in, so a stale chart is wrong.\n  const [prevKey, setPrevKey] = useState(cacheKey);\n  const [prevCode, setPrevCode] = useState(code);\n  if (cacheKey !== prevKey) {\n    const cached = svgCache.get(cacheKey);\n    const sameThemeStillStreaming =\n      themeKey === prevThemeKeyOf(prevKey) && code.startsWith(prevCode);\n    setPrevKey(cacheKey);\n    setPrevCode(code);\n    if (cached) setSvg(cached);\n    else if (!sameThemeStillStreaming) setSvg(null);\n    setRenderFailed(false);\n  }\n\n  useEffect(() => {\n    if (svgCache.has(cacheKey)) return;\n\n    let cancelled = false;\n    let graceTimer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounceTimer = setTimeout(() => {\n      if (code.length > MAX_SOURCE_CHARS) {\n        // Never becomes renderable, so skip the grace period.\n        console.error(\n          `[FlintChart] source exceeds ${MAX_SOURCE_CHARS} characters (${code.length}); not rendering`,\n        );\n        setSvg(null);\n        setRenderFailed(true);\n        return;\n      }\n\n      let input: ChartAssemblyInput;\n      try {\n        input = JSON.parse(code);\n      } catch (err) {\n        // Likely still streaming — fail only if unchanged when the grace period ends.\n        graceTimer = setTimeout(() => {\n          console.debug('[FlintChart] source never became parseable JSON:', err);\n          setSvg(null);\n          setRenderFailed(true);\n        }, PARSE_GRACE_MS - RENDER_DEBOUNCE_MS);\n        return;\n      }\n\n      getFlintRuntime()\n        .then(async (runtime) => {\n          if (cancelled) return;\n          // `scheme` comes from the same read as the cache key, so palette and key agree.\n          const svgOutput = makeResponsive(\n            await renderFlintSvg(\n              runtime,\n              withFlintSeriesPalette(input, scheme, scope),\n              vegaTheme(scheme, scope),\n            ),\n          );\n          if (cancelled) return;\n          cacheSvg(cacheKey, svgOutput);\n          setSvg(svgOutput);\n          setRenderFailed(false);\n        })\n        .catch((err) => {\n          if (cancelled) return;\n          console.error('[FlintChart] render failed:', err);\n          setSvg(null);\n          setRenderFailed(true);\n        });\n    }, RENDER_DEBOUNCE_MS);\n\n    return () => {\n      cancelled = true;\n      clearTimeout(debounceTimer);\n      if (graceTimer) clearTimeout(graceTimer);\n    };\n  }, [cacheKey, code, scheme, scope]);\n\n  if (renderFailed) {\n    return <DiagramSource code={code} />;\n  }\n\n  if (svg) {\n    return (\n      <ZoomableSvg\n        // Keyed by SVG, not `code`: a streaming chart is held, and a remount per chunk\n        // would drop zoom/pan.\n        key={svg}\n        html={svg}\n        copyText={`\\`\\`\\`flint\\n${code}\\n\\`\\`\\``}\n        className=\"tw:my-3\"\n        renderActions={renderActions}\n      />\n    );\n  }\n\n  return <DiagramSkeleton />;\n};\n"],"mappings":"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"}
+{"version":3,"file":"flint.js","names":[],"sources":["../src/blocks/FlintChart/flintTheme.ts","../src/blocks/FlintChart/refuseUnsafeSpec.ts","../src/blocks/FlintChart/renderFlintSvg.ts","../src/blocks/FlintChart/FlintChart.tsx"],"sourcesContent":["import type { ChartAssemblyInput } from 'flint-chart';\n\nimport type { ResolvedColorScheme } from '../../components/ThemeProvider/types';\nimport { createVegaColorResolver, SERIES_TOKENS, tierTwoColour } from '../../vega/vegaTokens';\n\n/**\n * Put the design system's `--chart-1..5` palette on a Flint input.\n *\n * - Flint resolves series colours during assembly, so they ride `theme_spec`, not `vegaTheme`.\n * - An author-supplied `theme_spec` is passed through untouched.\n * - A `null` `theme_spec` is replaced like a missing one — flint throws on it.\n */\nexport const withFlintSeriesPalette = (\n  input: ChartAssemblyInput,\n  scheme: ResolvedColorScheme,\n  from?: Element | null,\n): ChartAssemblyInput => {\n  if (input.theme_spec !== undefined && input.theme_spec !== null) return input;\n\n  const token = createVegaColorResolver(scheme, from);\n  const categorical = SERIES_TOKENS.map((name) => token(name));\n\n  return {\n    ...input,\n    theme_spec: {\n      ink: {\n        // `endpointsAgainstSurface` below needs to know what the chart sits on.\n        surface: { canvas: token('card') },\n        // Flint's defaults assume a light canvas, so text and structure come from tokens.\n        text: {\n          primary: token('foreground'),\n          secondary: token('muted-foreground'),\n          muted: token('muted-foreground'),\n          // Ink on a filled (series-coloured) mark.\n          inverse: token('card'),\n        },\n        structure: {\n          axis: token('border'),\n          grid: token('border'),\n          frame: token('border'),\n          rule: token('border'),\n        },\n        series: {\n          categorical,\n          // Past five series flint swaps `categorical` for its theme-blind `tableau10`;\n          // this keeps 6-10 on our hues (`tierTwoColour`).\n          categoricalExtended: [\n            ...categorical,\n            ...categorical.map((colour) => tierTwoColour(colour, scheme)),\n          ],\n          // The tail past even the extended set.\n          overflow: token('muted-foreground'),\n          // For a quantitative `color` field; flint's default starts at black, invisible on dark.\n          sequential: {\n            stops: [token('accent'), token('chart-1')],\n            space: 'lab',\n            endpointsAgainstSurface: true,\n          },\n        },\n      },\n    },\n  };\n};\n","/**\n * The boundary in front of the flint renderer: nothing in a spec may fetch or run.\n *\n * - Checked on the input, before `assembleVegaLite`: compiled Vega carries its own `signals`/`expr`.\n * - Refused on a key's presence, not its value: a relative `data.url` is still a fetch.\n */\n\n/** Keys whose presence anywhere in a spec is refused: each fetches, evaluates or binds a signal. */\nconst REFUSED_KEYS = new Set(['url', 'expr', 'signal', 'signals', 'params']);\n\n/** Suffix of Vega-Lite's other expression properties; matched by shape so new ones are refused. */\nconst EXPRESSION_KEY_SUFFIX = /Expr$/;\n\n/**\n * An own property's value, or `undefined`.\n *\n * - Via a descriptor: inherited keys are ignored and a getter is never called.\n */\nconst ownValue = (node: unknown, key: string): unknown => {\n  if (typeof node !== 'object' || node === null) return undefined;\n\n  return Object.getOwnPropertyDescriptor(node, key)?.value;\n};\n\n/**\n * The chart's rows (`spec.data.values` only), which the walk does not descend into.\n *\n * - Rows are data vega never evaluates, so a column named `url` must not be refused.\n * - Flint takes one top-level dataset, so every other node is spec.\n * - Skipped by identity, not key name: a `values` key elsewhere must not hide a refused key.\n */\nconst inlineRows = (spec: unknown): unknown[] | null => {\n  const values = ownValue(ownValue(spec, 'data'), 'values');\n\n  return Array.isArray(values) ? values : null;\n};\n\n/**\n * The top-level maps flint keys by column name, so their keys are data, not spec.\n *\n * - Only the keys are exempt; each value is walked like any other node.\n * - Matched by identity, as in `inlineRows`: a nested object with the same name gets no exemption.\n */\nconst COLUMN_KEYED_MAPS = ['semantic_types', 'field_display_names'];\n\nconst columnKeyedMaps = (spec: unknown): unknown[] =>\n  COLUMN_KEYED_MAPS.map((key) => ownValue(spec, key)).filter(\n    (map) => typeof map === 'object' && map !== null,\n  );\n\n/** Ceiling on the nodes the walk visits; exceeding it refuses, since the spec went unchecked. */\nconst MAX_SPEC_NODES = 10_000;\n\nconst TOO_LARGE = 'is too large to check';\n\n/**\n * Why this spec may not be rendered, or `null` if it may.\n *\n * - The reason goes to the console; the reader sees `DiagramSource`'s fallback.\n * - Iterative, so deep nesting cannot overflow the stack; nodes are charged on push.\n * - An accessor is refused, not skipped: its value cannot be read without running it.\n */\nexport const findUnsafeSpecKey = (spec: unknown): string | null => {\n  const rows = inlineRows(spec);\n  const columnKeyed = columnKeyedMaps(spec);\n  const stack: unknown[] = [spec];\n  let visited = 1;\n\n  while (stack.length > 0) {\n    const node = stack.pop();\n\n    if (Array.isArray(node)) {\n      visited += node.length;\n      if (visited > MAX_SPEC_NODES) return TOO_LARGE;\n      stack.push(...node);\n      continue;\n    }\n\n    if (typeof node !== 'object' || node === null) continue;\n\n    const keysAreColumnNames = columnKeyed.includes(node);\n\n    // Descriptors: skip inherited keys and never call a getter.\n    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(node))) {\n      if (!keysAreColumnNames && (REFUSED_KEYS.has(key) || EXPRESSION_KEY_SUFFIX.test(key))) {\n        return `carries \\`${key}\\``;\n      }\n      if (!('value' in descriptor)) return `carries an accessor at \\`${key}\\``;\n\n      const { value } = descriptor;\n      if (rows !== null && value === rows) continue;\n\n      visited += 1;\n      if (visited > MAX_SPEC_NODES) return TOO_LARGE;\n      stack.push(value);\n    }\n  }\n\n  return null;\n};\n","import type { ChartAssemblyInput } from 'flint-chart';\nimport type { assembleVegaLite } from 'flint-chart/vegalite';\nimport type * as vega from 'vega';\nimport type * as vegaLite from 'vega-lite';\nimport type { Config, TopLevelSpec } from 'vega-lite';\n\nimport { findUnsafeSpecKey } from './refuseUnsafeSpec';\n\n// The lazily imported modules the pipeline needs; a parameter so tests can pass a fake runtime.\nexport type FlintRuntime = {\n  assembleVegaLite: typeof assembleVegaLite;\n  vega: Pick<typeof vega, 'View' | 'parse'>;\n  vegaLite: Pick<typeof vegaLite, 'compile'>;\n};\n\n/**\n * Compile a Flint `ChartAssemblyInput` to a static SVG string.\n *\n * - The one place unsafe input is refused (`refuseUnsafeSpec.ts`), before anything compiles it.\n * - Flint's `_`-prefixed hint keys are not Vega-Lite schema and are stripped before compiling.\n * - `config` rides the compile options; flint's spec-side config sets no colours to conflict.\n * - Renders headless; `toSVG()` is the only output.\n */\nexport const renderFlintSvg = async (\n  runtime: FlintRuntime,\n  input: ChartAssemblyInput,\n  config: Config,\n): Promise<string> => {\n  const unsafe = findUnsafeSpecKey(input);\n  if (unsafe !== null) {\n    throw new Error(`Refusing to render a flint spec that ${unsafe}`);\n  }\n\n  const assembled: Record<string, unknown> = runtime.assembleVegaLite(input);\n  // `assembleVegaLite` is typed loosely upstream; without the hint keys it is a Vega-Lite spec.\n  const vlSpec = Object.fromEntries(\n    Object.entries(assembled).filter(([key]) => !key.startsWith('_')),\n  ) as unknown as TopLevelSpec;\n  const { spec } = runtime.vegaLite.compile(vlSpec, { config });\n  const view = new runtime.vega.View(runtime.vega.parse(spec), { renderer: 'none' });\n  try {\n    await view.runAsync();\n    return await view.toSVG();\n  } finally {\n    view.finalize();\n  }\n};\n","import { useEffect, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { ChartAssemblyInput } from 'flint-chart';\n\nimport { useThemeAttributes } from '../../components/ThemeProvider/useThemeAttributes';\nimport { ZoomableSvg } from '../../components/ZoomableSvg';\nimport { vegaTheme } from '../../vega/vegaTheme';\nimport { DiagramSkeleton } from '../DiagramShared/DiagramSkeleton';\nimport { DiagramSource } from '../DiagramShared/DiagramSource';\nimport { createSvgCache, diagramCacheKey } from '../DiagramShared/svgCache';\nimport { makeResponsive } from '../DiagramShared/svgTransforms';\n\nimport { withFlintSeriesPalette } from './flintTheme';\nimport type { FlintRuntime } from './renderFlintSvg';\nimport { renderFlintSvg } from './renderFlintSvg';\n\nlet runtimePromise: Promise<FlintRuntime> | null = null;\n\n// Memoized chart-stack import, reset on failure so a chunk-load error can retry.\n// Mirrors `getMermaid()` in `MermaidDiagram`.\nconst getFlintRuntime = (): Promise<FlintRuntime> => {\n  if (!runtimePromise) {\n    runtimePromise = Promise.all([\n      import('flint-chart/vegalite'),\n      import('vega'),\n      import('vega-lite'),\n    ])\n      .then(([flint, vega, vegaLite]) => ({\n        assembleVegaLite: flint.assembleVegaLite,\n        vega,\n        vegaLite,\n      }))\n      .catch((err) => {\n        runtimePromise = null;\n        throw err;\n      });\n  }\n  return runtimePromise;\n};\n\nconst RENDER_DEBOUNCE_MS = 300;\n\n// A streaming fence is unparseable just like a broken one, so unparseable source\n// keeps the skeleton until it has been unchanged this long, then shows as raw source.\nconst PARSE_GRACE_MS = 1500;\n\n// Parse, compile and layout are synchronous, so a larger source would freeze the chat.\n// Far above the prompt's ~50-row inline data cap.\nconst MAX_SOURCE_CHARS = 200_000;\n\n// Values are already `makeResponsive`d, so ZoomableSvg's sanitize memo stays stable.\nconst svgCache = createSvgCache();\n\n// The theme half of a cache key — tells a still-streaming spec from a theme switch.\nconst prevThemeKeyOf = (key: string): string => key.slice(0, key.indexOf('\\n'));\n\ntype Props = {\n  /** Raw source of a ```flint fence: a flint-chart `ChartAssemblyInput` as JSON. */\n  code: string;\n  /** Extra toolbar controls (e.g. `ExportMenu`) for `ZoomableSvg`; receives the sanitized SVG. */\n  renderActions?: (safeSvg: string) => ReactNode;\n};\n\nexport const FlintChart = ({ code, renderActions }: Props) => {\n  // - Re-renders on a scheme or brand change, same contract as MermaidDiagram.\n  // - `scope` is the element tokens are read off (`null` = `<html>`); it is part of `themeKey`.\n  const { scheme, cacheKey: themeKey, scope } = useThemeAttributes();\n  const cacheKey = diagramCacheKey(code, themeKey);\n\n  const [svg, setSvg] = useState<string | null>(() => svgCache.get(cacheKey) ?? null);\n  const [renderFailed, setRenderFailed] = useState(false);\n\n  // Reset stale state synchronously on a code or theme change (no one-frame flash):\n  // 1. A cache hit is applied at once.\n  // 2. Same theme, source only grew (still streaming): keep the last chart, no flicker.\n  // 3. Anything else clears — colours are baked in, so a stale chart is wrong.\n  const [prevKey, setPrevKey] = useState(cacheKey);\n  const [prevCode, setPrevCode] = useState(code);\n  if (cacheKey !== prevKey) {\n    const cached = svgCache.get(cacheKey);\n    const sameThemeStillStreaming =\n      themeKey === prevThemeKeyOf(prevKey) && code.startsWith(prevCode);\n    setPrevKey(cacheKey);\n    setPrevCode(code);\n    if (cached) setSvg(cached);\n    else if (!sameThemeStillStreaming) setSvg(null);\n    setRenderFailed(false);\n  }\n\n  useEffect(() => {\n    if (svgCache.has(cacheKey)) return;\n\n    let cancelled = false;\n    let graceTimer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounceTimer = setTimeout(() => {\n      if (code.length > MAX_SOURCE_CHARS) {\n        // Never becomes renderable, so skip the grace period.\n        console.error(\n          `[FlintChart] source exceeds ${MAX_SOURCE_CHARS} characters (${code.length}); not rendering`,\n        );\n        setSvg(null);\n        setRenderFailed(true);\n        return;\n      }\n\n      let input: ChartAssemblyInput;\n      try {\n        input = JSON.parse(code);\n      } catch (err) {\n        // Likely still streaming — fail only if unchanged when the grace period ends.\n        graceTimer = setTimeout(() => {\n          console.debug('[FlintChart] source never became parseable JSON:', err);\n          setSvg(null);\n          setRenderFailed(true);\n        }, PARSE_GRACE_MS - RENDER_DEBOUNCE_MS);\n        return;\n      }\n\n      getFlintRuntime()\n        .then(async (runtime) => {\n          if (cancelled) return;\n          // `scheme` comes from the same read as the cache key, so palette and key agree.\n          const svgOutput = makeResponsive(\n            await renderFlintSvg(\n              runtime,\n              withFlintSeriesPalette(input, scheme, scope),\n              vegaTheme(scheme, scope),\n            ),\n          );\n          if (cancelled) return;\n          svgCache.set(cacheKey, svgOutput);\n          setSvg(svgOutput);\n          setRenderFailed(false);\n        })\n        .catch((err) => {\n          if (cancelled) return;\n          console.error('[FlintChart] render failed:', err);\n          setSvg(null);\n          setRenderFailed(true);\n        });\n    }, RENDER_DEBOUNCE_MS);\n\n    return () => {\n      cancelled = true;\n      clearTimeout(debounceTimer);\n      if (graceTimer) clearTimeout(graceTimer);\n    };\n  }, [cacheKey, code, scheme, scope]);\n\n  if (renderFailed) {\n    return <DiagramSource code={code} />;\n  }\n\n  if (svg) {\n    return (\n      <ZoomableSvg\n        // Keyed by SVG, not `code`: a streaming chart is held, and a remount per chunk\n        // would drop zoom/pan.\n        key={svg}\n        html={svg}\n        copyText={`\\`\\`\\`flint\\n${code}\\n\\`\\`\\``}\n        className=\"tw:my-3\"\n        renderActions={renderActions}\n      />\n    );\n  }\n\n  return <DiagramSkeleton />;\n};\n"],"mappings":"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"}

package/dist/highlightCode-D354tCXO.js

@@ -0,0 +1,81 @@
+import { javascriptLanguage, jsxLanguage, tsxLanguage, typescriptLanguage } from "@codemirror/lang-javascript";
+import { jsonLanguage } from "@codemirror/lang-json";
+import { pythonLanguage } from "@codemirror/lang-python";
+import { StandardSQL } from "@codemirror/lang-sql";
+import { StreamLanguage } from "@codemirror/language";
+import { shell } from "@codemirror/legacy-modes/mode/shell";
+import { highlightCode as highlightCode$1, tagHighlighter, tags } from "@lezer/highlight";
+import { yaml } from "@codemirror/legacy-modes/mode/yaml";
+//#region src/blocks/AIKit/highlightCode.ts
+const GRAMMARS = {
+	sql: StandardSQL.language,
+	python: pythonLanguage,
+	javascript: javascriptLanguage,
+	jsx: jsxLanguage,
+	typescript: typescriptLanguage,
+	tsx: tsxLanguage,
+	json: jsonLanguage,
+	shell: StreamLanguage.define(shell),
+	yaml: StreamLanguage.define(yaml)
+};
+/**
+* Syntax tag → token classes.
+*
+* - Semantic tokens only, so a brand recolours code with the rest of the answer.
+* - A sub-tag (`controlKeyword`) falls back to its parent's rule.
+*/
+const highlighter = tagHighlighter([
+	{
+		tag: [
+			tags.keyword,
+			tags.operatorKeyword,
+			tags.modifier
+		],
+		class: "tw:text-primary"
+	},
+	{
+		tag: [
+			tags.string,
+			tags.special(tags.string),
+			tags.regexp
+		],
+		class: "tw:text-success"
+	},
+	{
+		tag: tags.comment,
+		class: "tw:text-muted-foreground tw:italic"
+	},
+	{
+		tag: [
+			tags.number,
+			tags.bool,
+			tags.null,
+			tags.atom
+		],
+		class: "tw:text-info"
+	},
+	{
+		tag: [tags.function(tags.variableName), tags.function(tags.propertyName)],
+		class: "tw:font-semibold"
+	},
+	{
+		tag: [tags.typeName, tags.className],
+		class: "tw:text-info"
+	}
+]);
+/** Splits `code` into runs, each with the classes its syntax earns; line breaks are `\n` runs. */
+const highlightCode = (code, grammar) => {
+	const tokens = [];
+	highlightCode$1(code, GRAMMARS[grammar].parser.parse(code), highlighter, (text, className) => tokens.push({
+		text,
+		className
+	}), () => tokens.push({
+		text: "\n",
+		className: ""
+	}));
+	return tokens;
+};
+//#endregion
+export { highlightCode };
+
+//# sourceMappingURL=highlightCode-D354tCXO.js.map

package/dist/highlightCode-D354tCXO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlightCode-D354tCXO.js","names":[],"sources":["../src/blocks/AIKit/highlightCode.ts"],"sourcesContent":["import {\n  javascriptLanguage,\n  jsxLanguage,\n  tsxLanguage,\n  typescriptLanguage,\n} from '@codemirror/lang-javascript';\nimport { jsonLanguage } from '@codemirror/lang-json';\nimport { pythonLanguage } from '@codemirror/lang-python';\nimport { StandardSQL } from '@codemirror/lang-sql';\nimport type { Language } from '@codemirror/language';\nimport { StreamLanguage } from '@codemirror/language';\nimport { shell } from '@codemirror/legacy-modes/mode/shell';\nimport { yaml } from '@codemirror/legacy-modes/mode/yaml';\nimport { highlightCode as walkHighlights, tagHighlighter, tags } from '@lezer/highlight';\n\nimport type { Highlighter, HighlightToken } from './highlightChunk';\nimport type { HighlightGrammar } from './highlightLanguages';\n\nconst GRAMMARS: Record<HighlightGrammar, Language> = {\n  sql: StandardSQL.language,\n  python: pythonLanguage,\n  javascript: javascriptLanguage,\n  jsx: jsxLanguage,\n  typescript: typescriptLanguage,\n  tsx: tsxLanguage,\n  json: jsonLanguage,\n  shell: StreamLanguage.define(shell),\n  yaml: StreamLanguage.define(yaml),\n};\n\n/**\n * Syntax tag → token classes.\n *\n * - Semantic tokens only, so a brand recolours code with the rest of the answer.\n * - A sub-tag (`controlKeyword`) falls back to its parent's rule.\n */\nconst highlighter = tagHighlighter([\n  { tag: [tags.keyword, tags.operatorKeyword, tags.modifier], class: 'tw:text-primary' },\n  { tag: [tags.string, tags.special(tags.string), tags.regexp], class: 'tw:text-success' },\n  { tag: tags.comment, class: 'tw:text-muted-foreground tw:italic' },\n  { tag: [tags.number, tags.bool, tags.null, tags.atom], class: 'tw:text-info' },\n  {\n    tag: [tags.function(tags.variableName), tags.function(tags.propertyName)],\n    class: 'tw:font-semibold',\n  },\n  { tag: [tags.typeName, tags.className], class: 'tw:text-info' },\n]);\n\n/** Splits `code` into runs, each with the classes its syntax earns; line breaks are `\\n` runs. */\nexport const highlightCode: Highlighter = (code, grammar) => {\n  const tokens: HighlightToken[] = [];\n  walkHighlights(\n    code,\n    GRAMMARS[grammar].parser.parse(code),\n    highlighter,\n    (text, className) => tokens.push({ text, className }),\n    () => tokens.push({ text: '\\n', className: '' }),\n  );\n  return tokens;\n};\n"],"mappings":";;;;;;;;;AAkBA,MAAM,WAA+C;CACnD,KAAK,YAAY;CACjB,QAAQ;CACR,YAAY;CACZ,KAAK;CACL,YAAY;CACZ,KAAK;CACL,MAAM;CACN,OAAO,eAAe,OAAO,KAAK;CAClC,MAAM,eAAe,OAAO,IAAI;AAClC;;;;;;;AAQA,MAAM,cAAc,eAAe;CACjC;EAAE,KAAK;GAAC,KAAK;GAAS,KAAK;GAAiB,KAAK;EAAQ;EAAG,OAAO;CAAkB;CACrF;EAAE,KAAK;GAAC,KAAK;GAAQ,KAAK,QAAQ,KAAK,MAAM;GAAG,KAAK;EAAM;EAAG,OAAO;CAAkB;CACvF;EAAE,KAAK,KAAK;EAAS,OAAO;CAAqC;CACjE;EAAE,KAAK;GAAC,KAAK;GAAQ,KAAK;GAAM,KAAK;GAAM,KAAK;EAAI;EAAG,OAAO;CAAe;CAC7E;EACE,KAAK,CAAC,KAAK,SAAS,KAAK,YAAY,GAAG,KAAK,SAAS,KAAK,YAAY,CAAC;EACxE,OAAO;CACT;CACA;EAAE,KAAK,CAAC,KAAK,UAAU,KAAK,SAAS;EAAG,OAAO;CAAe;AAChE,CAAC;;AAGD,MAAa,iBAA8B,MAAM,YAAY;CAC3D,MAAM,SAA2B,CAAC;CAClC,gBACE,MACA,SAAS,QAAQ,CAAC,OAAO,MAAM,IAAI,GACnC,cACC,MAAM,cAAc,OAAO,KAAK;EAAE;EAAM;CAAU,CAAC,SAC9C,OAAO,KAAK;EAAE,MAAM;EAAM,WAAW;CAAG,CAAC,CACjD;CACA,OAAO;AACT"}