@sixb/core 0.1.20 → 0.1.22

package/dist/artifacts/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What a client needs to show an artifact the way publishing read it: the kinds and what each
+ * holds, the slugs its headings get, its theme, a sheet's workbook and CSV, the limits a version
+ * keeps within, the `artifact:` addresses that point into it, and the messages a viewer and a
+ * deck's frame exchange, versioned as `sixb-frame/1`. Browser-safe: no storage, no Bun APIs.
+ */
+export { type ArtifactAddress, type CellRange, formatArtifactAddress, isArtifactAddress, parseArtifactAddress, parseSheetPart, type SheetPart, } from "./address";
+export { CANVAS_FILE, type Canvas, type CanvasArrow, type CanvasBoard, type CanvasEmbed, type CanvasEnd, type CanvasItem, type CanvasNote, type CanvasSection, type CanvasShape, type CanvasShapeItem, type CanvasText, type CanvasTextSize, parseCanvas, } from "./canvas";
+export { CsvParseError, type CsvTable, formatCsv, parseCsv } from "./csv";
+export { checkFormula, columnFormulaType, evaluateComputedColumns, FORMULA_ERRORS, FormulaCycleError, type FormulaErrorCode, type FormulaNode, type FormulaOperator, type FormulaType, formulaDependencies, formulaFitsColumn, formulaReferences, parseFormula, renameColumnReferences, } from "./formula";
+export { type DeckMode, FRAME_PROTOCOL, FRAME_THEME_TOKENS, type FrameCall, type FrameCallResult, type FrameEmbed, type FrameEvent, type FrameRequest, type FrameResponse, type FrameStart, frameStartHash, parseFrameCall, parseFrameEvent, } from "./frames/protocol";
+export { ARTIFACT_KINDS, type ArtifactKind } from "./kinds";
+export { ARTIFACT_LIMITS, ARTIFACT_STATE_LIMITS } from "./limits";
+export { type LiveSheetColumn, type LiveSheetLayout, type LiveSheetRow, type LiveSheetTable, liveSheetColumns, liveSheetTable, } from "./live-sheet";
+export { type ArtifactOutline, type CanvasOutline, type CanvasOutlineItem, createHeadingSlugger, type DocumentHeading, type DocumentOutline, type FileOutline, type SheetOutline, type SheetSummary, type SlidesOutline, } from "./outline";
+export { type ArtifactFacetsQueryResult, type ArtifactObjectsQueryResult, type ArtifactQueryProperty, type ArtifactQueryPropertyType, type ArtifactQueryResult, type ArtifactQuerySchema, artifactQueryName, } from "./queries";
+export { type ArtifactAddressTarget, type ResolvedArtifactPart, resolveArtifactAddress, } from "./resolve";
+export { checkSheet } from "./sheet-rules";
+export { ARTIFACT_THEME_FILE, type ArtifactTheme, parseArtifactTheme } from "./theme";
+export { ARTIFACT_TONES, type ArtifactTone } from "./tones";
+export { type LiveSheetColumnSource, type LiveSheetSource, NUMERIC_COLUMN_TYPES, parseSheetDate, parseSheetNumber, parseWorkbook, SHEET_COLUMN_TYPES, SHEET_HIGHLIGHTS, SHEET_TOTALS, type SheetChartAggregate, type SheetChartType, type SheetColumnFormat, type SheetColumnType, type SheetHighlight, type SheetTotal, sheetFilePath, WORKBOOK_FILE, type Workbook, type WorkbookChart, type WorkbookSheet, } from "./workbook";
+//# sourceMappingURL=index.d.ts.map

package/dist/artifacts/index.d.ts.map

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

package/dist/artifacts/index.js

@@ -0,0 +1,247 @@
+// @bun
+import {
+  isArtifactAddress2,
+  parseArtifactAddress2,
+  formatArtifactAddress2,
+  parseSheetPart2
+} from "../chunk-3fqxbn31.js";
+import {
+  ARTIFACT_LIMITS2,
+  ARTIFACT_STATE_LIMITS2
+} from "../chunk-hz5d43gn.js";
+import {
+  ARTIFACT_THEME_FILE2,
+  ARTIFACT_THEME_TOKENS,
+  parseArtifactTheme2,
+  isArtifactQueryName,
+  artifactQueryName2,
+  resolveArtifactAddress2,
+  ARTIFACT_TONES2,
+  CANVAS_FILE2,
+  parseCanvas2,
+  createHeadingSlugger2,
+  CsvParseError2,
+  parseCsv2,
+  formatCsv2,
+  parseFormula2,
+  formulaDependencies2,
+  formulaReferences2,
+  renameColumnReferences2,
+  WORKBOOK_FILE2,
+  SHEET_COLUMN_TYPES2,
+  NUMERIC_COLUMN_TYPES2,
+  SHEET_HIGHLIGHTS2,
+  SHEET_TOTALS2,
+  sheetFilePath2,
+  parseWorkbook2,
+  parseSheetNumber2,
+  parseSheetDate2,
+  checkFormula2,
+  FORMULA_ERRORS2,
+  columnFormulaType2,
+  formulaFitsColumn2,
+  FormulaCycleError2,
+  evaluateComputedColumns2,
+  liveSheetColumns2,
+  liveSheetTable2,
+  checkSheet2
+} from "../chunk-waqk73p1.js";
+import {
+  ARTIFACT_KINDS2
+} from "../chunk-d7vyc7k6.js";
+// src/artifacts/frames/protocol.ts
+var FRAME_PROTOCOL = "sixb-frame/1";
+function frameStartHash(start) {
+  const params = [];
+  if (start.slide !== undefined && start.slide > 1)
+    params.push(`sixb-slide=${Math.round(start.slide)}`);
+  if (start.fill)
+    params.push("sixb-fill");
+  return params.length > 0 ? `#${params.join("&")}` : "";
+}
+function parseFrameCall(data) {
+  if (!isRecord(data) || data.protocol !== FRAME_PROTOCOL || !isRecord(data.params))
+    return null;
+  if (!Number.isSafeInteger(data.call) || Number(data.call) < 0)
+    return null;
+  const call = Number(data.call);
+  const { params } = data;
+  const key = params.key;
+  const keyed = isStateKey(key);
+  switch (data.method) {
+    case "state.get":
+    case "state.delete":
+      return keyed ? { protocol: FRAME_PROTOCOL, call, method: data.method, params: { key } } : null;
+    case "state.set": {
+      if (!keyed || !("value" in params))
+        return null;
+      const json = jsonText(params.value);
+      if (json === undefined || utf8Bytes(json) > ARTIFACT_STATE_LIMITS2.maxValueBytes)
+        return null;
+      return {
+        protocol: FRAME_PROTOCOL,
+        call,
+        method: "state.set",
+        params: { key, value: params.value }
+      };
+    }
+    case "state.keys":
+      return { protocol: FRAME_PROTOCOL, call, method: "state.keys", params: {} };
+    case "query.run": {
+      const { name } = params;
+      if (typeof name !== "string" || !isArtifactQueryName(name))
+        return null;
+      return { protocol: FRAME_PROTOCOL, call, method: "query.run", params: { name } };
+    }
+    default:
+      return null;
+  }
+}
+function isStateKey(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= ARTIFACT_STATE_LIMITS2.maxKeyLength && !/\p{Cc}/u.test(value) && value !== "." && value !== "..";
+}
+function jsonText(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return;
+  }
+}
+function utf8Bytes(text) {
+  return new TextEncoder().encode(text).byteLength;
+}
+var DECK_KEYS = [
+  "ArrowLeft",
+  "ArrowRight",
+  "ArrowUp",
+  "ArrowDown",
+  "PageUp",
+  "PageDown",
+  "Home",
+  "End",
+  " ",
+  "Escape"
+];
+var FRAME_THEME_TOKENS = ARTIFACT_THEME_TOKENS;
+function parseFrameEvent(data) {
+  if (!isRecord(data) || data.protocol !== FRAME_PROTOCOL || !isRecord(data.params))
+    return null;
+  const { params } = data;
+  switch (data.event) {
+    case "ready":
+      if (params.slides === undefined)
+        return event("ready", {});
+      return isCount(params.slides) ? event("ready", { slides: params.slides }) : null;
+    case "select":
+      return isCount(params.slide) && params.slide > 0 ? event("select", { slide: params.slide }) : null;
+    case "key":
+      return typeof params.key === "string" && DECK_KEYS.includes(params.key) ? event("key", { key: params.key }) : null;
+    case "open":
+      return isAddress(params.address) ? event("open", { address: params.address }) : null;
+    case "link":
+      return isWebAddress(params.url) ? event("link", { url: params.url }) : null;
+    case "embeds": {
+      const { embeds } = params;
+      if (!Array.isArray(embeds) || embeds.length > ARTIFACT_LIMITS2.maxReferences)
+        return null;
+      const parsed = [];
+      const ids = new Set;
+      for (const embed of embeds) {
+        if (!isRecord(embed) || !isAddress(embed.address) || !isRecord(embed.rect))
+          return null;
+        if (!isCount(embed.id) || ids.has(embed.id))
+          return null;
+        ids.add(embed.id);
+        const { x, y, width, height } = embed.rect;
+        if (![x, y, width, height, embed.scale].every(Number.isFinite))
+          return null;
+        if (Number(width) < 0 || Number(height) < 0 || Number(embed.scale) <= 0)
+          return null;
+        parsed.push({
+          id: embed.id,
+          address: embed.address,
+          rect: { x: Number(x), y: Number(y), width: Number(width), height: Number(height) },
+          scale: Number(embed.scale)
+        });
+      }
+      return event("embeds", { embeds: parsed });
+    }
+    case "size":
+      return Number.isFinite(params.height) && Number(params.height) >= 0 ? event("size", { height: Math.min(Number(params.height), MAX_HEIGHT) }) : null;
+    default:
+      return null;
+  }
+}
+var MAX_HEIGHT = 1e5;
+function event(name, params) {
+  return { protocol: FRAME_PROTOCOL, event: name, params };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isCount(value) {
+  return Number.isSafeInteger(value) && Number(value) >= 0;
+}
+function isAddress(value) {
+  return typeof value === "string" && value.length <= 2048;
+}
+var MAX_URL_LENGTH = 8192;
+function isWebAddress(value) {
+  if (typeof value !== "string" || value.length > MAX_URL_LENGTH)
+    return false;
+  try {
+    const { protocol } = new URL(value);
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+export {
+  ARTIFACT_KINDS2 as ARTIFACT_KINDS,
+  ARTIFACT_LIMITS2 as ARTIFACT_LIMITS,
+  ARTIFACT_STATE_LIMITS2 as ARTIFACT_STATE_LIMITS,
+  ARTIFACT_THEME_FILE2 as ARTIFACT_THEME_FILE,
+  ARTIFACT_TONES2 as ARTIFACT_TONES,
+  CANVAS_FILE2 as CANVAS_FILE,
+  CsvParseError2 as CsvParseError,
+  FORMULA_ERRORS2 as FORMULA_ERRORS,
+  FRAME_PROTOCOL,
+  FRAME_THEME_TOKENS,
+  FormulaCycleError2 as FormulaCycleError,
+  NUMERIC_COLUMN_TYPES2 as NUMERIC_COLUMN_TYPES,
+  SHEET_COLUMN_TYPES2 as SHEET_COLUMN_TYPES,
+  SHEET_HIGHLIGHTS2 as SHEET_HIGHLIGHTS,
+  SHEET_TOTALS2 as SHEET_TOTALS,
+  WORKBOOK_FILE2 as WORKBOOK_FILE,
+  artifactQueryName2 as artifactQueryName,
+  checkFormula2 as checkFormula,
+  checkSheet2 as checkSheet,
+  columnFormulaType2 as columnFormulaType,
+  createHeadingSlugger2 as createHeadingSlugger,
+  evaluateComputedColumns2 as evaluateComputedColumns,
+  formatArtifactAddress2 as formatArtifactAddress,
+  formatCsv2 as formatCsv,
+  formulaDependencies2 as formulaDependencies,
+  formulaFitsColumn2 as formulaFitsColumn,
+  formulaReferences2 as formulaReferences,
+  frameStartHash,
+  isArtifactAddress2 as isArtifactAddress,
+  liveSheetColumns2 as liveSheetColumns,
+  liveSheetTable2 as liveSheetTable,
+  parseArtifactAddress2 as parseArtifactAddress,
+  parseArtifactTheme2 as parseArtifactTheme,
+  parseCanvas2 as parseCanvas,
+  parseCsv2 as parseCsv,
+  parseFormula2 as parseFormula,
+  parseFrameCall,
+  parseFrameEvent,
+  parseSheetDate2 as parseSheetDate,
+  parseSheetNumber2 as parseSheetNumber,
+  parseSheetPart2 as parseSheetPart,
+  parseWorkbook2 as parseWorkbook,
+  renameColumnReferences2 as renameColumnReferences,
+  resolveArtifactAddress2 as resolveArtifactAddress,
+  sheetFilePath2 as sheetFilePath
+};
+
+//# debugId=AA3028BCE82011C864756E2164756E21

package/dist/artifacts/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/artifacts/frames/protocol.ts"],
+  "sourcesContent": [
+    "import { ARTIFACT_LIMITS, ARTIFACT_STATE_LIMITS } from \"../limits\"\nimport { isArtifactQueryName } from \"../queries\"\nimport { ARTIFACT_THEME_TOKENS } from \"../theme\"\n\n/**\n * Messages between the app and an artifact in its sandboxed frame: a deck, or a page. The app\n * asks; the frame answers each request by its id, and tells the app what happened inside it as\n * events. Later abilities are new methods and events, not a new protocol.\n */\nexport const FRAME_PROTOCOL = \"sixb-frame/1\"\n\n/**\n * A deck shows one slide scaled to fit on its stage, every slide in a grid, or one slide filling\n * the page to present it.\n */\nexport type DeckMode = \"slide\" | \"overview\" | \"present\"\n\n/**\n * How a frame opens, set in its URL so the first paint is right: at a slide, and with `fill`, that\n * slide alone filling the frame with no stage around it, as a thumbnail or an embed shows it.\n */\nexport interface FrameStart {\n  readonly slide?: number\n  readonly fill?: boolean\n}\n\n/** The fragment that carries a frame's start: `#sixb-slide=3&sixb-fill`. */\nexport function frameStartHash(start: FrameStart): string {\n  const params: string[] = []\n  if (start.slide !== undefined && start.slide > 1)\n    params.push(`sixb-slide=${Math.round(start.slide)}`)\n  if (start.fill) params.push(\"sixb-fill\")\n  return params.length > 0 ? `#${params.join(\"&\")}` : \"\"\n}\n\n/** What the app asks of the frame. */\nexport type FrameRequest =\n  | FrameRequestOf<\n      \"theme\",\n      { readonly tokens: Readonly<Record<string, string>>; readonly dark: boolean }\n    >\n  | FrameRequestOf<\"goto\", { readonly slide: number }>\n  | FrameRequestOf<\"mode\", { readonly mode: DeckMode }>\n  /** Scrolls a page by a wheel turned over what the app draws on it. */\n  | FrameRequestOf<\"scroll\", { readonly x: number; readonly y: number }>\n  /** Loads the entry again, as a page whose data was reset starts over. */\n  | FrameRequestOf<\"reload\", Record<string, never>>\n  /**\n   * A query the page read has new rows: the objects it reads changed. The page reads them with\n   * `sixb.query(name)` again; the app sends it only for the queries that frame has read.\n   */\n  | FrameRequestOf<\"query.changed\", { readonly name: string }>\n\ninterface FrameRequestOf<Method extends string, Params> {\n  readonly protocol: typeof FRAME_PROTOCOL\n  readonly id: number\n  readonly method: Method\n  readonly params: Params\n}\n\n/** The frame's answer to one request. */\nexport interface FrameResponse {\n  readonly protocol: typeof FRAME_PROTOCOL\n  readonly id: number\n  readonly error?: string\n}\n\n/** What happened inside the frame. */\nexport type FrameEvent =\n  /** The frame has laid out its entry: a deck says how many slides it has. */\n  | FrameEventOf<\"ready\", { readonly slides?: number }>\n  /** The reader picked a slide in the overview. */\n  | FrameEventOf<\"select\", { readonly slide: number }>\n  /** A key the app handles, pressed while the frame had focus. */\n  | FrameEventOf<\"key\", { readonly key: string }>\n  /** A link to another artifact, which opens where the reader is. */\n  | FrameEventOf<\"open\", { readonly address: string }>\n  /**\n   * A link to a web page, which the app opens in a new tab: the frame cannot open windows itself.\n   * Only `http:` and `https:` addresses.\n   */\n  | FrameEventOf<\"link\", { readonly url: string }>\n  /**\n   * Where the `<sixb-embed>` boxes in view are, for the app to draw each over the frame: in the\n   * frame's pixels, with the scale they are drawn at. A deck reports the shown slide's, and none in\n   * the overview, where an embed stays a placeholder, as it does in a filled frame, which never\n   * reports; a page reports those near its view as it scrolls, at its own scale.\n   */\n  | FrameEventOf<\"embeds\", { readonly embeds: readonly FrameEmbed[] }>\n  /** A page's height as laid out at the frame's width, so a document can size the frame to it. */\n  | FrameEventOf<\"size\", { readonly height: number }>\n\n/** One `<sixb-embed>` the frame shows. */\nexport interface FrameEmbed {\n  /** The element's own id while the page is loaded: the same as it scrolls out and back. */\n  readonly id: number\n  readonly address: string\n  readonly rect: {\n    readonly x: number\n    readonly y: number\n    readonly width: number\n    readonly height: number\n  }\n  /**\n   * The scale it is drawn at: a slide's, where the embed is laid out at `rect / scale` and scaled\n   * with the slide; 1 on a page.\n   */\n  readonly scale: number\n}\n\ninterface FrameEventOf<Event extends string, Params> {\n  readonly protocol: typeof FRAME_PROTOCOL\n  readonly event: Event\n  readonly params: Params\n}\n\n/**\n * What the frame asks of the app, numbered so the app's `result` answers it: a page keeping data\n * with `sixb.state`, or reading one of its version's queries with `sixb.query`. The app answers\n * only its own frame, for the artifact and the version it shows.\n */\nexport type FrameCall =\n  | FrameCallOf<\"state.get\", { readonly key: string }>\n  | FrameCallOf<\"state.set\", { readonly key: string; readonly value: unknown }>\n  | FrameCallOf<\"state.delete\", { readonly key: string }>\n  | FrameCallOf<\"state.keys\", Record<string, never>>\n  /** Runs `queries/<name>.json` as the reader; the value is the query route's JSON. */\n  | FrameCallOf<\"query.run\", { readonly name: string }>\n\ninterface FrameCallOf<Method extends string, Params> {\n  readonly protocol: typeof FRAME_PROTOCOL\n  readonly call: number\n  readonly method: Method\n  readonly params: Params\n}\n\n/** The app's answer to one call: its value, or why it failed. */\nexport interface FrameCallResult {\n  readonly protocol: typeof FRAME_PROTOCOL\n  readonly result: number\n  readonly value?: unknown\n  readonly error?: string\n}\n\n/**\n * A message from a frame as a call, or null when it is not one. A page's scripts write what it\n * posts, so the shapes are checked here, and a value is checked for size as JSON, as storage will\n * count it, before the app sends it anywhere.\n */\nexport function parseFrameCall(data: unknown): FrameCall | null {\n  if (!isRecord(data) || data.protocol !== FRAME_PROTOCOL || !isRecord(data.params)) return null\n  if (!Number.isSafeInteger(data.call) || Number(data.call) < 0) return null\n  const call = Number(data.call)\n  const { params } = data\n  const key = params.key\n  const keyed = isStateKey(key)\n  switch (data.method) {\n    case \"state.get\":\n    case \"state.delete\":\n      return keyed\n        ? ({ protocol: FRAME_PROTOCOL, call, method: data.method, params: { key } } as FrameCall)\n        : null\n    case \"state.set\": {\n      if (!keyed || !(\"value\" in params)) return null\n      const json = jsonText(params.value)\n      if (json === undefined || utf8Bytes(json) > ARTIFACT_STATE_LIMITS.maxValueBytes) return null\n      return {\n        protocol: FRAME_PROTOCOL,\n        call,\n        method: \"state.set\",\n        params: { key, value: params.value },\n      }\n    }\n    case \"state.keys\":\n      return { protocol: FRAME_PROTOCOL, call, method: \"state.keys\", params: {} }\n    case \"query.run\": {\n      // The client puts the name in the URL's path, as it does a key.\n      const { name } = params\n      if (typeof name !== \"string\" || !isArtifactQueryName(name)) return null\n\n      return { protocol: FRAME_PROTOCOL, call, method: \"query.run\", params: { name } }\n    }\n    default:\n      return null\n  }\n}\n\n/**\n * A key the app can send: the client puts it in the URL's path, where `.` and `..` would name\n * another route, `..` the artifact itself.\n */\nfunction isStateKey(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    value.length <= ARTIFACT_STATE_LIMITS.maxKeyLength &&\n    !/\\p{Cc}/u.test(value) &&\n    value !== \".\" &&\n    value !== \"..\"\n  )\n}\n\nfunction jsonText(value: unknown): string | undefined {\n  try {\n    return JSON.stringify(value)\n  } catch {\n    return undefined\n  }\n}\n\nfunction utf8Bytes(text: string): number {\n  return new TextEncoder().encode(text).byteLength\n}\n\n/** Keys the frame passes to the app, so a deck navigates the same with focus in it or not. */\nexport const DECK_KEYS = [\n  \"ArrowLeft\",\n  \"ArrowRight\",\n  \"ArrowUp\",\n  \"ArrowDown\",\n  \"PageUp\",\n  \"PageDown\",\n  \"Home\",\n  \"End\",\n  \" \",\n  \"Escape\",\n] as const\n\n/**\n * The theme tokens the app sends into a frame, read from the viewer as it is themed: the ones an\n * artifact's theme may set.\n */\nexport const FRAME_THEME_TOKENS = ARTIFACT_THEME_TOKENS\n\n/**\n * A message from a frame as an event, or null when it is not one this protocol sends. A deck runs\n * its own scripts, so anything it posts is checked for the shape the app relies on: whole slide\n * numbers, a key the app handles, finite boxes, and no more embeds than a version may record.\n */\nexport function parseFrameEvent(data: unknown): FrameEvent | null {\n  if (!isRecord(data) || data.protocol !== FRAME_PROTOCOL || !isRecord(data.params)) return null\n  const { params } = data\n  switch (data.event) {\n    case \"ready\":\n      if (params.slides === undefined) return event(\"ready\", {})\n      return isCount(params.slides) ? event(\"ready\", { slides: params.slides }) : null\n    case \"select\":\n      return isCount(params.slide) && params.slide > 0\n        ? event(\"select\", { slide: params.slide })\n        : null\n    case \"key\":\n      return typeof params.key === \"string\" && (DECK_KEYS as readonly string[]).includes(params.key)\n        ? event(\"key\", { key: params.key })\n        : null\n    case \"open\":\n      return isAddress(params.address) ? event(\"open\", { address: params.address }) : null\n    case \"link\":\n      return isWebAddress(params.url) ? event(\"link\", { url: params.url }) : null\n    case \"embeds\": {\n      const { embeds } = params\n      if (!Array.isArray(embeds) || embeds.length > ARTIFACT_LIMITS.maxReferences) return null\n      const parsed: FrameEmbed[] = []\n      const ids = new Set<number>()\n      for (const embed of embeds) {\n        if (!isRecord(embed) || !isAddress(embed.address) || !isRecord(embed.rect)) return null\n\n        // Two embeds with one id would be one element drawn twice.\n        if (!isCount(embed.id) || ids.has(embed.id)) return null\n        ids.add(embed.id)\n\n        const { x, y, width, height } = embed.rect\n        if (![x, y, width, height, embed.scale].every(Number.isFinite)) return null\n        if (Number(width) < 0 || Number(height) < 0 || Number(embed.scale) <= 0) return null\n        parsed.push({\n          id: embed.id,\n          address: embed.address,\n          rect: { x: Number(x), y: Number(y), width: Number(width), height: Number(height) },\n          scale: Number(embed.scale),\n        })\n      }\n      return event(\"embeds\", { embeds: parsed })\n    }\n    case \"size\":\n      return Number.isFinite(params.height) && Number(params.height) >= 0\n        ? event(\"size\", { height: Math.min(Number(params.height), MAX_HEIGHT) })\n        : null\n    default:\n      return null\n  }\n}\n\n/** The most a page reports as its height: more is a page that grows with its frame. */\nconst MAX_HEIGHT = 100_000\n\nfunction event<Name extends FrameEvent[\"event\"]>(\n  name: Name,\n  params: Extract<FrameEvent, { event: Name }>[\"params\"]\n): FrameEvent {\n  return { protocol: FRAME_PROTOCOL, event: name, params } as FrameEvent\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null\n}\n\nfunction isCount(value: unknown): value is number {\n  return Number.isSafeInteger(value) && Number(value) >= 0\n}\n\n/** Long enough for any address a version can record; the app resolves it before using it. */\nfunction isAddress(value: unknown): value is string {\n  return typeof value === \"string\" && value.length <= 2048\n}\n\n/** The longest web address the app opens: longer than any link a page needs. */\nconst MAX_URL_LENGTH = 8192\n\n/** An absolute `http:` or `https:` address, as the frame resolves a link's. */\nfunction isWebAddress(value: unknown): value is string {\n  if (typeof value !== \"string\" || value.length > MAX_URL_LENGTH) return false\n\n  try {\n    const { protocol } = new URL(value)\n    return protocol === \"http:\" || protocol === \"https:\"\n  } catch {\n    return false\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "AA3028BCE82011C864756E2164756E21",
+  "names": []
+}

package/dist/artifacts/kinds.d.ts

@@ -0,0 +1,5 @@
+/** The kinds of artifact Sixb renders. An artifact's kind is fixed when it is created. */
+export declare const ARTIFACT_KINDS: readonly ["document", "sheet", "slides", "page", "canvas", "file"];
+export type ArtifactKind = (typeof ARTIFACT_KINDS)[number];
+export declare function isArtifactKind(value: unknown): value is ArtifactKind;
+//# sourceMappingURL=kinds.d.ts.map

package/dist/artifacts/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/artifacts/kinds.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,cAAc,oEAAqE,CAAA;AAEhG,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/artifacts/limits.d.ts

@@ -0,0 +1,58 @@
+/** What one version may hold. Publishing refuses a version over any of these. */
+export declare const ARTIFACT_LIMITS: {
+    readonly maxFiles: 200;
+    readonly maxFileBytes: number;
+    readonly maxVersionBytes: number;
+    readonly maxPathLength: 512;
+    readonly maxTitleLength: 200;
+    /** A document's Markdown is parsed whole when it is published. */
+    readonly maxDocumentBytes: number;
+    readonly maxThemeBytes: number;
+    readonly maxWorkbookBytes: number;
+    /** A sheet's limits keep the grid quick and its charts readable. */
+    readonly maxSheets: 20;
+    readonly maxSheetRows: 100000;
+    /** The viewer reads a sheet whole, and reads at most this much. */
+    readonly maxSheetFileBytes: number;
+    readonly maxSheetColumns: 200;
+    readonly maxCharts: 10;
+    readonly maxChartSeries: 5;
+    /** One slice per theme chart color, so no two slices share one. */
+    readonly maxPieSlices: 5;
+    /** A deck's `index.html` is parsed whole when it is published. */
+    readonly maxDeckBytes: number;
+    /** A page's `index.html` is parsed whole when it is published; its scripts and data are not. */
+    readonly maxPageBytes: number;
+    readonly maxSlides: 100;
+    /** A canvas's items, its live boards, and where they may sit, in pixels. */
+    readonly maxCanvasBytes: number;
+    readonly maxCanvasItems: 500;
+    readonly maxCanvasBoards: 40;
+    readonly minCanvasItemSize: 40;
+    readonly maxCanvasItemSize: 8000;
+    readonly maxCanvasPosition: 100000;
+    /** A note's or a text's words, in characters. */
+    readonly maxCanvasTextLength: 2000;
+    /** An item's title, a shape's words, or an arrow's label, in characters. */
+    readonly maxCanvasLabelLength: 120;
+    /** A board's HTML is parsed whole when it is published, as a page's is. */
+    readonly maxBoardBytes: number;
+    /** `artifact:` addresses one version may use. */
+    readonly maxReferences: 200;
+    /** `queries/<name>.json` files, each run for every reader who opens the version. */
+    readonly maxQueries: 20;
+    readonly maxQueryBytes: number;
+    /** What one query returns at most; past it, its result says it is truncated. */
+    readonly maxQueryRows: 10000;
+};
+/**
+ * What a page may keep for each reader with `sixb.state`, across its versions: values are JSON,
+ * counted by their UTF-8 bytes as written.
+ */
+export declare const ARTIFACT_STATE_LIMITS: {
+    readonly maxKeyLength: 128;
+    readonly maxValueBytes: number;
+    readonly maxKeys: 100;
+    readonly maxBytes: number;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/artifacts/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/artifacts/limits.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,eAAe;;;;;;IAM1B,kEAAkE;;;;IAIlE,oEAAoE;;;IAGpE,mEAAmE;;;;;IAKnE,mEAAmE;;IAEnE,kEAAkE;;IAElE,gGAAgG;;;IAGhG,4EAA4E;;;;;;;IAO5E,iDAAiD;;IAEjD,4EAA4E;;IAE5E,2EAA2E;;IAE3E,iDAAiD;;IAEjD,oFAAoF;;;IAGpF,gFAAgF;;CAExE,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAA"}

package/dist/artifacts/live-sheet.d.ts

@@ -0,0 +1,65 @@
+import type { CsvTable } from "./csv";
+import type { ArtifactQueryProperty, ArtifactQuerySchema } from "./queries";
+import { type SheetColumnType, type WorkbookSheet } from "./workbook";
+/**
+ * A live sheet laid out against what its query's rows hold: publishing checks it as its author
+ * sees the rows, and the viewer draws it as each reader does.
+ */
+export interface LiveSheetLayout {
+    /**
+     * The sheet with a format for every column, as a CSV sheet's workbook gives them: what the
+     * publish rules, the grid and the charts read.
+     */
+    readonly sheet: WorkbookSheet;
+    /** Each column, in order, with what it shows. */
+    readonly columns: readonly LiveSheetColumn[];
+    /** The first column that does not lay out, in the words publishing refuses it with; or null. */
+    readonly problem: string | null;
+}
+export interface LiveSheetColumn {
+    readonly name: string;
+    /** The property the column shows, of the rows or of what `linkId` reaches; none when computed. */
+    readonly from?: {
+        readonly linkId?: string;
+        readonly propertyId: string;
+    };
+    /** Whether the rows hold no such property for this reader: every cell of it is locked. */
+    readonly missing: boolean;
+}
+/** What a row of a query's result holds, as core reads it and as the API serializes it. */
+export interface LiveSheetRow {
+    readonly properties: Readonly<Record<string, unknown>>;
+    /** The properties left out because the reader is not cleared for them. */
+    readonly redactions?: Readonly<Record<string, unknown>>;
+    readonly links?: Readonly<Record<string, LiveSheetRow | readonly LiveSheetRow[] | null>>;
+}
+/** A live sheet's rows as a sheet's CSV would hold them, and the cells the reader may not see. */
+export interface LiveSheetTable {
+    /** Each cell as a CSV cell holds its value, computed columns empty. */
+    readonly table: CsvTable;
+    /**
+     * By row, the columns of the cells the reader may not see: drawn locked, never as empty. A
+     * computed cell that reads a locked one is locked too.
+     */
+    readonly locked: ReadonlyMap<number, ReadonlySet<number>>;
+}
+/**
+ * The column type a property's values take in a sheet: numbers, dates, true or false, an enum's
+ * values as tags, and anything else as text. The ontology names no money or ratio, so a number is
+ * a number; a column that wants a currency says so.
+ */
+export declare function sheetColumnType(property: ArtifactQueryProperty): SheetColumnType;
+/**
+ * Lays a live sheet out against its query's schema: each column's property, and its type, its
+ * property's unless the workbook gives one. A column whose property the schema lacks shows locked
+ * cells, and `problem` names the first that does not lay out.
+ */
+export declare function liveSheetColumns(sheet: WorkbookSheet, schema: ArtifactQuerySchema): LiveSheetLayout;
+/**
+ * A query's rows as a live sheet shows them: each column's value written as a CSV cell holds it,
+ * so the grid, the charts and the downloads read them as they read a CSV sheet's. A value the
+ * reader is not cleared for is a locked cell, as is every cell of a column the reader's rows do
+ * not hold.
+ */
+export declare function liveSheetTable(layout: LiveSheetLayout, rows: readonly LiveSheetRow[]): LiveSheetTable;
+//# sourceMappingURL=live-sheet.d.ts.map

package/dist/artifacts/live-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-sheet.d.ts","sourceRoot":"","sources":["../../src/artifacts/live-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC3E,OAAO,EAIL,KAAK,eAAe,EAIpB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAA;AAEnB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;CACzF;AAED,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;CAC1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,eAAe,CAgBhF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,mBAAmB,GAC1B,eAAe,CAgDjB;AA4ED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,GAC5B,cAAc,CAyBhB"}

package/dist/artifacts/outline.d.ts

@@ -0,0 +1,70 @@
+/**
+ * What a version contains, read from its files when it is published. Addresses resolve against
+ * it, and previews and hover cards show it without opening the files.
+ */
+export type ArtifactOutline = DocumentOutline | SheetOutline | SlidesOutline | PageOutline | CanvasOutline | FileOutline;
+export interface DocumentOutline {
+    readonly kind: "document";
+    readonly headings: readonly DocumentHeading[];
+}
+export interface DocumentHeading {
+    readonly depth: number;
+    readonly text: string;
+    /** What `#part` names in an address to this section. */
+    readonly slug: string;
+}
+export interface SheetOutline {
+    readonly kind: "sheet";
+    readonly sheets: readonly SheetSummary[];
+    /** The names of the charts declared in the workbook. */
+    readonly charts: readonly string[];
+}
+export interface SheetSummary {
+    readonly name: string;
+    /** The rows of its CSV; none for a live sheet, whose rows are each reader's. */
+    readonly rows: number;
+    readonly columns: readonly string[];
+    /** A live sheet's query, whose rows it shows. */
+    readonly query?: string;
+}
+export interface SlidesOutline {
+    readonly kind: "slides";
+    /** One entry per slide, in order; the title is the slide's first heading. */
+    readonly slides: readonly {
+        readonly title?: string;
+    }[];
+}
+export interface PageOutline {
+    readonly kind: "page";
+    /** The page's `<title>`, else its first heading. */
+    readonly title?: string;
+}
+export interface CanvasOutline {
+    readonly kind: "canvas";
+    /** The boards and sections an address can name, by id, in the canvas's order. */
+    readonly items: readonly CanvasOutlineItem[];
+}
+export type CanvasOutlineItem = {
+    readonly id: string;
+    readonly type: "board";
+    readonly title?: string;
+    /** The HTML file it shows, and its size: what its frame serves, and the shape it embeds at. */
+    readonly file: string;
+    readonly w: number;
+    readonly h: number;
+} | {
+    readonly id: string;
+    readonly type: "section";
+    readonly title?: string;
+};
+export interface FileOutline {
+    readonly kind: "file";
+    readonly mediaType: string;
+}
+/**
+ * Turns a document's heading texts, in order, into their section slugs: lowercase, punctuation
+ * dropped, spaces as hyphens, and `-1`, `-2` after a repeat. Publishing and the renderer both name
+ * sections with it, so an address to a section finds the heading the reader sees.
+ */
+export declare function createHeadingSlugger(): (text: string) => string;
+//# sourceMappingURL=outline.d.ts.map

package/dist/artifacts/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/artifacts/outline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,YAAY,GACZ,aAAa,GACb,WAAW,GACX,aAAa,GACb,WAAW,CAAA;AAEf,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC7C;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAc/D"}

package/dist/artifacts/publish/files.d.ts

@@ -0,0 +1,15 @@
+import type { BlobStorage } from "../../blob-storage/types";
+import type { ArtifactFile } from "../../storage/artifacts/types";
+import { ArtifactRequestError } from "../errors";
+export type ArtifactBlobStorage = Pick<BlobStorage, "stat" | "open">;
+/**
+ * Checks a version's files before anything reads them: safe unique paths, the per-version limits,
+ * and stored bytes that match each reference.
+ */
+export declare function checkArtifactFiles(blobStorage: ArtifactBlobStorage, files: readonly ArtifactFile[]): Promise<void>;
+/** The file at `path`, read as UTF-8 text when it is no larger than `maxBytes`. */
+export declare function readArtifactText(blobStorage: ArtifactBlobStorage, file: ArtifactFile, maxBytes: number): Promise<string>;
+/** Relative, `/`-separated, no empty, `.`, or `..` segment, no backslash or control character. */
+export declare function isArtifactPath(path: string): boolean;
+export declare function invalidArtifact(message: string): ArtifactRequestError;
+//# sourceMappingURL=files.d.ts.map

package/dist/artifacts/publish/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/artifacts/publish/files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAGhD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAEpE;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,mBAAmB,EAChC,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,mBAAmB,EAChC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUpD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAErE"}

package/dist/artifacts/publish/index.d.ts

@@ -0,0 +1,7 @@
+/** Publishing for this repo's packages: the Agent publishes through the same checks as the API. */
+export { artifactAccessRule, artifactQueryChecker } from "../execution";
+export { isArtifactId } from "../ids";
+export { ARTIFACT_LIMITS } from "../limits";
+export { artifactQueryName } from "../queries";
+export { artifactVersionWarnings, type PreparedArtifactVersion, type PublishArtifactInput, prepareArtifactVersion, publishArtifact, storeArtifactVersion, } from "./publish";
+//# sourceMappingURL=index.d.ts.map

package/dist/artifacts/publish/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/artifacts/publish/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACL,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACrB,MAAM,WAAW,CAAA"}