@blockslides/ai-context 0.1.0

package/dist/index.cjs

@@ -0,0 +1,806 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all2) => {
+  for (var name in all2)
+    __defProp(target, name, { get: all2[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  bundlesV1: () => v1_exports4,
+  contextsV1: () => v1_exports,
+  examplesV1: () => v1_exports2,
+  recipesV1: () => v1_exports5,
+  schemasV1: () => v1_exports3
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/contexts/v1/index.ts
+var v1_exports = {};
+__export(v1_exports, {
+  blockquote: () => blockquote,
+  bulletList: () => bulletList,
+  codeBlock: () => codeBlock,
+  column: () => column,
+  core: () => core,
+  editingRules: () => editingRules,
+  fullDocument: () => fullDocument,
+  hardBreak: () => hardBreak,
+  heading: () => heading,
+  horizontalRule: () => horizontalRule,
+  image: () => image,
+  imageBlock: () => imageBlock,
+  paragraph: () => paragraph,
+  row: () => row,
+  sizing: () => sizing,
+  slide: () => slide,
+  style: () => style,
+  youtube: () => youtube
+});
+
+// src/contexts/v1/core.ts
+var core = `
+You are given a BlockSlides document to CREATE or EDIT.
+
+Document shape:
+- doc: { type: "doc", content: slide[] }
+- slide: { type: "slide", attrs?, content: row[] }
+- row: { type: "row", attrs?, content: column[] | block[] }
+- column: { type: "column", attrs?, content: (block | row)[] }
+- block: includes nodes like paragraph, heading, imageBlock, etc.
+
+Rules:
+- Use only known node types and valid attrs. Do not invent attributes.
+- Prefer stable references: preserve slide.attrs.id if present.
+- Slides and flyers share the same JSON; flyers are slides sized via attrs and theme.
+`.trim();
+
+// src/contexts/v1/output.fullDocument.ts
+var fullDocument = `
+Output contract:
+- Return exactly one JSON object representing the ENTIRE document.
+- No prose, no markdown, no code fences, no comments. JSON only.
+- Include all required attrs. Use allowed enum values only.
+`.trim();
+
+// src/contexts/v1/imageBlock.ts
+var imageBlock = `
+Node: imageBlock
+Attrs:
+- src (required): string (URL)
+- alt (optional): string
+- caption (optional): string
+- credit (optional): string
+- layout (optional): "cover" | "contain" | "fill" | "focus" | "pattern"
+- align (optional): "left" | "center" | "right" | "stretch" (default "center")
+- width (optional): number (px) or string ("%"/"px")
+- height (optional): number (px) or string ("%"/"px")
+- fullBleed (optional): boolean (removes radius; stretches width)
+- assetId (optional): string
+- focalX, focalY (optional): 0\u2013100; spotlight position (when relevant)
+
+Behavior:
+- Numbers for width/height are interpreted as pixels.
+- layout:
+  - cover: Fill container; crop edges as needed.
+  - contain: Fit entirely; may letterbox.
+  - fill: Stretch to container (may distort).
+  - focus: Cover + radial spotlight at focalX/focalY.
+  - pattern: Hide <img>; use tiled background (from src).
+- Do not set unknown attributes. Preserve existing valid attrs.
+`.trim();
+
+// src/contexts/v1/row.ts
+var row = `
+Node: row
+Attrs:
+- layout (optional): "", "1", "1-1", "2-1", "1-2", "1-1-1", "2-1-1", "1-2-1", "1-1-2", "1-1-1-1"
+- className (optional): string (CSS classes)
+
+Semantics:
+- Fractions determine relative column flex:
+  - 1-1: two equal columns
+  - 2-1: first column is double width
+  - 1-2: second column is double width
+  - 1-1-1: three equal columns
+  - 1-1-1-1: four equal columns
+- Empty layout ("", "1") acts as a single full-width column.
+`.trim();
+
+// src/contexts/v1/column.ts
+var column = `
+Node: column
+Attrs:
+- className (optional): string
+- contentMode (optional): "default" (future-friendly)
+- verticalAlign (optional): "top" | "center" | "bottom" (default "top")
+- horizontalAlign (optional): "left" | "center" | "right" | "stretch" (default "left")
+- padding (optional): "none" (future-friendly)
+
+Notes:
+- Use className for spacing, colors, typography (e.g., Tailwind).
+- Keep nesting shallow; columns can contain rows or blocks as needed.
+`.trim();
+
+// src/contexts/v1/slide.ts
+var slide = `
+Node: slide
+Attrs:
+- id (optional): string (stable identifier; preserve if present)
+- className (optional): string (styling)
+- size (optional): "16x9" | "4x3" | "a4-portrait" | "a4-landscape" | "letter-portrait" | "letter-landscape" | "linkedin-banner"
+
+Content:
+- slide contains one or more rows.
+
+Notes:
+- Flyers are slides sized for paper (e.g., size: "a4-portrait").
+- Set size to control canvas dimensions; theme applies the exact width/height.
+`.trim();
+
+// src/contexts/v1/style.ts
+var style = `
+Styling
+- Prefer using attrs.className for styling (e.g., Tailwind classes).
+- Use enums for canonical behaviors (e.g., imageBlock.layout).
+- When enums are insufficient (spacing, backgrounds), use className.
+`.trim();
+
+// src/contexts/v1/editingRules.ts
+var editingRules = `
+Editing rules
+- Preserve existing ids and valid attributes. Do not remove or rename known attrs.
+- Use only allowed enum values. Do not invent new enum values.
+- Avoid introducing new attrs. If styling is needed, prefer className.
+- Keep the document valid: slide > row > column > blocks.
+`.trim();
+
+// src/contexts/v1/sizing.ts
+var sizing = `
+Sizing
+- Slides and flyers share the same JSON. Flyers are slides sized via slide.attrs.size and theme rules.
+- Allowed sizes: "16x9" | "4x3" | "a4-portrait" | "a4-landscape" | "letter-portrait" | "letter-landscape" | "linkedin-banner".
+- Editors may render with fixed canvases or dynamic mode. The default is fixed; dynamic stretches to container with preserved aspect.
+`.trim();
+
+// src/contexts/v1/blockquote.ts
+var blockquote = `
+Node: blockquote
+Attrs:
+- HTML-only; no required JSON attrs beyond optional styling such as className.
+
+Content:
+- One or more block nodes (typically paragraphs, headings, lists).
+
+Semantics:
+- Use for quoted text or callouts inside a column or row.
+- Styling should be applied via className on the surrounding column/slide, not by inventing new attrs here.
+`.trim();
+
+// src/contexts/v1/bulletList.ts
+var bulletList = `
+Node: bulletList
+Attrs:
+- HTML-only; no required JSON attrs beyond optional styling such as className.
+
+Content:
+- One or more list item nodes (listItem) that contain paragraphs or inline content.
+
+Semantics:
+- Represents an unordered list rendered as <ul>.
+- Use when you need bullet points inside a column or blockquote.
+- Do not use bulletList as a top-level child of doc; it belongs inside a column/row structure.
+`.trim();
+
+// src/contexts/v1/codeBlock.ts
+var codeBlock = `
+Node: codeBlock
+Attrs:
+- language (optional): string | null (e.g., "js", "ts", "python").
+
+Content:
+- Plain text only (no child nodes); used for preformatted code samples.
+
+Semantics:
+- Renders as <pre><code>\u2026</code></pre>.
+- language controls a CSS class (e.g., "language-js") for syntax highlighting.
+- Use when the user explicitly wants a fenced code block, not inline code in a paragraph.
+`.trim();
+
+// src/contexts/v1/hardBreak.ts
+var hardBreak = `
+Node: hardBreak
+Attrs:
+- None (HTML-only); behaves like a manual line break.
+
+Content:
+- Inline-only; used within paragraphs or headings.
+
+Semantics:
+- Renders as <br> and as a newline in plain text exports.
+- Use when the user requests a line break without starting a new paragraph.
+`.trim();
+
+// src/contexts/v1/horizontalRule.ts
+var horizontalRule = `
+Node: horizontalRule
+Attrs:
+- HTML-only; no JSON attrs beyond optional styling via surrounding layout.
+
+Content:
+- No children; this is a self-contained separator.
+
+Semantics:
+- Renders as <hr>.
+- Use to visually separate sections within a slide (for example, between rows of text).
+`.trim();
+
+// src/contexts/v1/image.ts
+var image = `
+Node: image
+Attrs:
+- src (required): string (URL to the image).
+- alt (optional): string (accessibility text).
+- title (optional): string (tooltip / caption).
+- width, height (optional): numbers (px) used as hints for rendering.
+
+Content:
+- No children; this is an atomic inline or block-level image node depending on editor configuration.
+
+Semantics:
+- Renders as a simple <img>, unlike imageBlock which adds rich framing/caption UI.
+- Prefer imageBlock for designed layouts; use image for simple inline images in paragraphs.
+`.trim();
+
+// src/contexts/v1/heading.ts
+var heading = `
+Node: heading
+Attrs:
+- level (required): 1 | 2 | 3 | 4 | 5 | 6.
+
+Content:
+- Inline content (text, marks, inline nodes).
+
+Semantics:
+- Renders as <h1>\u2026<h6> depending on level.
+- Use level 1\u20132 for main slide titles, 3\u20134 for section headings, 5\u20136 for subtle labels.
+- Do not invent other attrs; typography/styling should come from className on columns/slides.
+`.trim();
+
+// src/contexts/v1/paragraph.ts
+var paragraph = `
+Node: paragraph
+Attrs:
+- HTML-only; no structured JSON attrs beyond optional styling such as className.
+
+Content:
+- Inline content (text with marks, inline nodes such as image or hardBreak).
+
+Semantics:
+- Default text block inside columns and rows.
+- Multiple paragraphs can be stacked within the same column to create vertical rhythm.
+`.trim();
+
+// src/contexts/v1/youtube.ts
+var youtube = `
+Node: youtube
+Attrs:
+- src (required): string (public YouTube URL).
+- start (optional): number (start time in seconds).
+- width (optional): number (frame width in px).
+- height (optional): number (frame height in px).
+
+Content:
+- No children; this is an atomic embed node.
+
+Semantics:
+- Renders as an embedded YouTube iframe wrapped in a container <div>.
+- Use for video embeds inside a column or row; keep other text in separate paragraphs/columns.
+- Do not embed raw <iframe> HTML directly; always use the youtube node with attrs.
+`.trim();
+
+// src/examples/v1/index.ts
+var v1_exports2 = {};
+__export(v1_exports2, {
+  flyers: () => flyers,
+  slides: () => slides
+});
+
+// src/examples/v1/slides.ts
+var slides = `
+Examples: Slides (full-document output)
+
+{
+  "type": "doc",
+  "content": [
+    {
+      "type": "slide",
+      "attrs": { "id": "intro", "size": "16x9" },
+      "content": [
+        {
+          "type": "row",
+          "attrs": { "layout": "1-1" },
+          "content": [
+            { "type": "column", "content": [
+              { "type": "heading", "attrs": { "level": 2 }, "content": [{ "type": "text", "text": "Welcome" }] }
+            ]},
+            { "type": "column", "content": [
+              { "type": "imageBlock", "attrs": { "src": "https://picsum.photos/seed/welcome/1200/800", "layout": "cover", "align": "center" } }
+            ]}
+          ]
+        }
+      ]
+    }
+  ]
+}
+
+/* more-slide-examples to be added here */
+`.trim();
+
+// src/examples/v1/flyers.ts
+var flyers = `
+Examples: Flyers (A4 slides; full-document output)
+
+{
+  "type": "doc",
+  "content": [
+    {
+      "type": "slide",
+      "attrs": { "id": "a4-flyer", "size": "a4-portrait", "className": "bg-white text-slate-900" },
+      "content": [
+        {
+          "type": "row",
+          "attrs": { "layout": "1" },
+          "content": [
+            { "type": "column", "content": [
+              { "type": "heading", "attrs": { "level": 2 }, "content": [{ "type": "text", "text": "Event Title" }] },
+              { "type": "paragraph", "content": [{ "type": "text", "text": "Date \xB7 Location" }] },
+              { "type": "imageBlock", "attrs": { "src": "https://picsum.photos/seed/a4/1600/1000", "layout": "contain", "align": "center", "height": 320 } }
+            ]}
+          ]
+        }
+      ]
+    }
+  ]
+}
+
+/* more-flyer-examples to be added here */
+`.trim();
+
+// src/bundles/v1/index.ts
+var v1_exports4 = {};
+__export(v1_exports4, {
+  all: () => all,
+  allContexts: () => allContexts,
+  allSchemas: () => allSchemas,
+  imageEditing: () => imageEditing,
+  minimalCreate: () => minimalCreate
+});
+
+// src/bundles/v1/minimalCreate.ts
+var minimalCreate = [core, fullDocument, slide, row, column, style].join("\n\n");
+
+// src/bundles/v1/imageEditing.ts
+var imageEditing = [core, fullDocument, imageBlock, editingRules].join("\n\n");
+
+// src/bundles/v1/all.ts
+var all = [
+  core,
+  fullDocument,
+  slide,
+  row,
+  column,
+  style,
+  sizing,
+  imageBlock,
+  blockquote,
+  bulletList,
+  heading,
+  paragraph,
+  image,
+  codeBlock,
+  hardBreak,
+  horizontalRule,
+  youtube,
+  editingRules
+].join("\n\n");
+
+// src/schemas/v1/index.ts
+var v1_exports3 = {};
+__export(v1_exports3, {
+  blockquote: () => blockquote_schema_default,
+  bulletList: () => bulletList_schema_default,
+  codeBlock: () => codeBlock_schema_default,
+  column: () => column_schema_default,
+  hardBreak: () => hardBreak_schema_default,
+  heading: () => heading_schema_default,
+  horizontalRule: () => horizontalRule_schema_default,
+  image: () => image_schema_default,
+  imageBlock: () => imageBlock_schema_default,
+  paragraph: () => paragraph_schema_default,
+  row: () => row_schema_default,
+  slide: () => slide_schema_default,
+  youtube: () => youtube_schema_default
+});
+
+// src/schemas/v1/imageBlock.schema.json
+var imageBlock_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "imageBlock",
+  type: "object",
+  properties: {
+    type: { const: "imageBlock" },
+    attrs: {
+      type: "object",
+      properties: {
+        src: { type: "string", minLength: 1 },
+        alt: { type: "string" },
+        caption: { type: "string" },
+        credit: { type: "string" },
+        layout: { enum: ["cover", "contain", "fill", "focus", "pattern", null] },
+        align: { enum: ["left", "center", "right", "stretch", null] },
+        width: { type: ["number", "string", "null"] },
+        height: { type: ["number", "string", "null"] },
+        fullBleed: { type: "boolean" },
+        assetId: { type: ["string", "null"] },
+        focalX: { type: ["number", "null"], minimum: 0, maximum: 100 },
+        focalY: { type: ["number", "null"], minimum: 0, maximum: 100 }
+      },
+      required: ["src"],
+      additionalProperties: false
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/row.schema.json
+var row_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "row",
+  type: "object",
+  properties: {
+    type: { const: "row" },
+    attrs: {
+      type: "object",
+      properties: {
+        layout: {
+          enum: ["", "1", "1-1", "2-1", "1-2", "1-1-1", "2-1-1", "1-2-1", "1-1-2", "1-1-1-1", null]
+        },
+        className: { type: ["string", "null"] }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/column.schema.json
+var column_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "column",
+  type: "object",
+  properties: {
+    type: { const: "column" },
+    attrs: {
+      type: "object",
+      properties: {
+        className: { type: ["string", "null"] },
+        contentMode: { enum: ["default", null] },
+        verticalAlign: { enum: ["top", "center", "bottom", null] },
+        horizontalAlign: { enum: ["left", "center", "right", "stretch", null] },
+        padding: { enum: ["none", null] }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/slide.schema.json
+var slide_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "slide",
+  type: "object",
+  properties: {
+    type: { const: "slide" },
+    attrs: {
+      type: "object",
+      properties: {
+        id: { type: ["string", "null"] },
+        className: { type: ["string", "null"] },
+        size: {
+          enum: [
+            "16x9",
+            "4x3",
+            "a4-portrait",
+            "a4-landscape",
+            "letter-portrait",
+            "letter-landscape",
+            "linkedin-banner",
+            null
+          ]
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/blockquote.schema.json
+var blockquote_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "blockquote",
+  type: "object",
+  properties: {
+    type: { const: "blockquote" },
+    attrs: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/bulletList.schema.json
+var bulletList_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "bulletList",
+  type: "object",
+  properties: {
+    type: { const: "bulletList" },
+    attrs: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/codeBlock.schema.json
+var codeBlock_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "codeBlock",
+  type: "object",
+  properties: {
+    type: { const: "codeBlock" },
+    attrs: {
+      type: "object",
+      properties: {
+        language: { type: ["string", "null"] }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/hardBreak.schema.json
+var hardBreak_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "hardBreak",
+  type: "object",
+  properties: {
+    type: { const: "hardBreak" },
+    attrs: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/horizontalRule.schema.json
+var horizontalRule_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "horizontalRule",
+  type: "object",
+  properties: {
+    type: { const: "horizontalRule" },
+    attrs: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/image.schema.json
+var image_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "image",
+  type: "object",
+  properties: {
+    type: { const: "image" },
+    attrs: {
+      type: "object",
+      properties: {
+        src: { type: ["string", "null"] },
+        alt: { type: ["string", "null"] },
+        title: { type: ["string", "null"] },
+        width: { type: ["number", "null"] },
+        height: { type: ["number", "null"] }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/heading.schema.json
+var heading_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "heading",
+  type: "object",
+  properties: {
+    type: { const: "heading" },
+    attrs: {
+      type: "object",
+      properties: {
+        level: {
+          type: "integer",
+          minimum: 1,
+          maximum: 6
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/paragraph.schema.json
+var paragraph_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "paragraph",
+  type: "object",
+  properties: {
+    type: { const: "paragraph" },
+    attrs: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/schemas/v1/youtube.schema.json
+var youtube_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "youtube",
+  type: "object",
+  properties: {
+    type: { const: "youtube" },
+    attrs: {
+      type: "object",
+      properties: {
+        src: { type: ["string", "null"] },
+        start: { type: "number" },
+        width: { type: "number" },
+        height: { type: "number" }
+      },
+      additionalProperties: true
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
+
+// src/bundles/v1/allSchemas.ts
+var allSchemas = Object.entries(v1_exports3).map(
+  ([name, schema]) => `Schema "${name}":
+` + JSON.stringify(schema, null, 2)
+).join("\n\n");
+
+// src/bundles/v1/allContexts.ts
+var allContexts = [
+  core,
+  fullDocument,
+  slide,
+  row,
+  column,
+  style,
+  sizing,
+  imageBlock,
+  blockquote,
+  bulletList,
+  heading,
+  paragraph,
+  image,
+  codeBlock,
+  hardBreak,
+  horizontalRule,
+  youtube,
+  editingRules
+].join("\n\n");
+
+// src/recipes/v1/index.ts
+var v1_exports5 = {};
+__export(v1_exports5, {
+  addTwoColumns: () => addTwoColumns,
+  createSlide: () => createSlide,
+  editImageToCover: () => editImageToCover
+});
+
+// src/recipes/v1/createSlide.ts
+var createSlide = [
+  core,
+  fullDocument,
+  slide,
+  row,
+  column,
+  `
+Return a single JSON document that creates one 16x9 slide with a 1-1 row:
+{
+  "type": "doc",
+  "content": [
+    {
+      "type": "slide",
+      "attrs": { "size": "16x9" },
+      "content": [
+        { "type": "row", "attrs": { "layout": "1-1" }, "content": [
+          { "type": "column", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Left" }] }] },
+          { "type": "column", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Right" }] }] }
+        ] }
+      ]
+    }
+  ]
+}
+`.trim()
+].join("\n\n");
+
+// src/recipes/v1/addTwoColumns.ts
+var addTwoColumns = [
+  core,
+  fullDocument,
+  row,
+  column,
+  `
+Return a full document where the first slide contains a row with layout "1-1" and two columns with simple text paragraphs.
+`.trim()
+].join("\n\n");
+
+// src/recipes/v1/editImageToCover.ts
+var editImageToCover = [
+  core,
+  fullDocument,
+  imageBlock,
+  editingRules,
+  `
+Update an existing imageBlock on the first slide so it uses layout "cover" and align "center". Preserve all other attributes.
+`.trim()
+].join("\n\n");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bundlesV1,
+  contextsV1,
+  examplesV1,
+  recipesV1,
+  schemasV1
+});
+//# sourceMappingURL=index.cjs.map