@litfamily/litopencode 1.0.7 → 1.0.9

package/skills/lit-pptx/specs/slide-ast-v1.schema.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "slide-ast-v1",
+  "title": "Slide AST v1",
+  "description": "Versioned intermediate representation for compiled Markdown slide decks. Template-independent; resolved at render time against enrolled template contracts.",
+  "type": "object",
+  "required": ["astVersion", "version", "deck", "slides"],
+  "additionalProperties": false,
+  "properties": {
+    "astVersion": {
+      "type": "string",
+      "const": "slide-ast-v1",
+      "description": "AST version identifier. Must be exactly 'slide-ast-v1'."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Schema version (semver)."
+    },
+    "deck": {
+      "type": "object",
+      "required": ["template", "title"],
+      "additionalProperties": false,
+      "properties": {
+        "template": {
+          "type": "string",
+          "description": "Enrolled template name (e.g. AZURE-PRO)."
+        },
+        "title": {
+          "type": "string",
+          "description": "Deck title."
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Optional deck-level metadata (date, department, presenter, etc.)."
+        }
+      }
+    },
+    "slides": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/slide" },
+      "description": "Ordered array of slides."
+    }
+  },
+  "$defs": {
+    "slide": {
+      "type": "object",
+      "required": ["index", "layout", "blocks"],
+      "additionalProperties": false,
+      "properties": {
+        "index": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "0-based slide position."
+        },
+        "layout": {
+          "type": "string",
+          "enum": ["cover", "content", "main", "summary", "closing"],
+          "description": "Slide layout type."
+        },
+        "blocks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/block" },
+          "description": "Content blocks in order."
+        }
+      }
+    },
+    "block": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["title", "body", "main-box", "summary-group", "kpi-table", "image", "notes"],
+          "description": "Block type."
+        }
+      },
+      "oneOf": [
+        { "$ref": "#/$defs/titleBlock" },
+        { "$ref": "#/$defs/bodyBlock" },
+        { "$ref": "#/$defs/mainBoxBlock" },
+        { "$ref": "#/$defs/summaryGroupBlock" },
+        { "$ref": "#/$defs/kpiTableBlock" },
+        { "$ref": "#/$defs/imageBlock" },
+        { "$ref": "#/$defs/notesBlock" }
+      ]
+    },
+    "titleBlock": {
+      "type": "object",
+      "required": ["type", "content", "level"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "title" },
+        "content": { "type": "string", "description": "Title text." },
+        "level": { "type": "integer", "enum": [1, 2, 3], "description": "Heading level (1=#, 2=##, 3=###)." }
+      }
+    },
+    "bodyBlock": {
+      "type": "object",
+      "required": ["type", "items"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "body" },
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/bodyItem" },
+          "description": "Body content items."
+        }
+      }
+    },
+    "mainBoxBlock": {
+      "type": "object",
+      "required": ["type", "content"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "main-box" },
+        "content": { "type": "string", "description": "Text content for the bordered box." }
+      }
+    },
+    "summaryGroupBlock": {
+      "type": "object",
+      "required": ["type", "position", "heading", "items"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "summary-group" },
+        "position": { "type": "string", "enum": ["top", "bottom"], "description": "Vertical position on the summary slide." },
+        "heading": { "type": "string", "description": "Group heading text." },
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/bodyItem" },
+          "description": "Group content items."
+        }
+      }
+    },
+    "kpiTableBlock": {
+      "type": "object",
+      "required": ["type", "rows"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "kpi-table" },
+        "headers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Column headers."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "description": "Table rows (each row is an array of cell strings)."
+        }
+      }
+    },
+    "imageBlock": {
+      "type": "object",
+      "required": ["type", "src"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "image" },
+        "src": { "type": "string", "description": "Image path (relative or absolute)." },
+        "alt": { "type": "string", "description": "Alt text." },
+        "width": { "type": "string", "description": "Optional width (e.g. '4in')." },
+        "height": { "type": "string", "description": "Optional height (e.g. '3in')." }
+      }
+    },
+    "notesBlock": {
+      "type": "object",
+      "required": ["type", "content"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string", "const": "notes" },
+        "content": { "type": "string", "description": "Speaker/footnote text." }
+      }
+    },
+    "bodyItem": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["bullet", "numbered", "section", "text"],
+          "description": "Item type."
+        }
+      },
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "type": "string", "const": "bullet" },
+            "text": { "type": "string" },
+            "level": { "type": "integer", "default": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "type": "string", "const": "numbered" },
+            "text": { "type": "string" }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["type", "heading", "children"],
+          "properties": {
+            "type": { "type": "string", "const": "section" },
+            "heading": { "type": "string" },
+            "children": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/bodyItem" }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "type": "string", "const": "text" },
+            "text": { "type": "string" }
+          }
+        }
+      ]
+    }
+  }
+}

package/skills/lit-pptx/specs/slide-ast-v2.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "slide-ast-v2.schema.json",
+  "title": "Slide AST v2",
+  "description": "Additive successor to slide-ast-v1. A deck built only from v1 constructs still compiles to a slide-ast-v1 document; v2 is emitted only once a deck places content itself. Every v1 document is also a valid v2 document.",
+  "type": "object",
+  "required": ["astVersion", "version", "deck", "slides"],
+  "properties": {
+    "astVersion": { "enum": ["slide-ast-v1", "slide-ast-v2"] },
+    "version": { "type": "string" },
+    "deck": {
+      "type": "object",
+      "required": ["template", "title"],
+      "properties": {
+        "template": { "type": "string" },
+        "title": { "type": "string" },
+        "metadata": { "type": "object" }
+      }
+    },
+    "slides": { "type": "array", "items": { "$ref": "#/definitions/slide" } }
+  },
+  "definitions": {
+    "slide": {
+      "type": "object",
+      "required": ["index", "layout", "blocks"],
+      "properties": {
+        "index": { "type": "number" },
+        "layout": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Any name the chosen template declares. The v1 set (cover, content, main, summary, section, closing) is no longer closed; layout-resolver validates the name against the template mapping."
+        },
+        "meta": {
+          "type": "object",
+          "description": "Slide-local keys declared under the layout line, such as variant.",
+          "additionalProperties": { "type": "string" }
+        },
+        "blocks": { "type": "array", "items": { "$ref": "#/definitions/block" } }
+      }
+    },
+
+    "block": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "enum": [
+            "title", "body", "main-box", "summary-group", "kpi-table", "chart", "image",
+            "notes", "figure-caption", "table-caption",
+            "columns", "box", "shape"
+          ]
+        },
+        "regionHint": {
+          "type": "string",
+          "description": "Region this block targets, set by '::: region name=<region>'. Overrides the block-type default the resolver would otherwise pick."
+        }
+      },
+      "allOf": [
+        { "$ref": "#/definitions/columnsBlock" },
+        { "$ref": "#/definitions/boxBlock" },
+        { "$ref": "#/definitions/shapeBlock" }
+      ]
+    },
+
+    "columnsBlock": {
+      "description": "Declarative side-by-side placement. Tracks are fr ratios; the resolver divides the layout's body region between them and no coordinate appears in the source.",
+      "if": { "properties": { "type": { "const": "columns" } }, "required": ["type"] },
+      "then": {
+        "required": ["tracks", "gap", "columns"],
+        "properties": {
+          "tracks": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string" },
+            "description": "One entry per column, e.g. [\"2fr\", \"1fr\"]. Count must equal columns.length."
+          },
+          "gap": { "type": "number", "description": "Gutter in inches." },
+          "columns": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["blocks"],
+              "properties": {
+                "blocks": { "type": "array", "items": { "$ref": "#/definitions/block" } }
+              }
+            }
+          }
+        }
+      }
+    },
+
+    "boxBlock": {
+      "description": "Absolutely placed content. Coordinates are inches on the template canvas and are never adjusted by the resolver's auto-nudge rules.",
+      "if": { "properties": { "type": { "const": "box" } }, "required": ["type"] },
+      "then": {
+        "required": ["x", "y", "w", "h", "z", "blocks"],
+        "properties": {
+          "x": { "type": "number" },
+          "y": { "type": "number" },
+          "w": { "type": "number" },
+          "h": { "type": "number" },
+          "role": { "type": "string", "description": "font_role from the template's capabilities.yaml. Defaults to body_text." },
+          "align": { "type": "string" },
+          "valign": { "type": "string" },
+          "z": { "enum": ["under", "over"], "description": "Drawn before or after the template's own regions. Defaults to over." },
+          "blocks": { "type": "array", "items": { "$ref": "#/definitions/block" } }
+        }
+      }
+    },
+
+    "shapeBlock": {
+      "description": "A drawing primitive. Style keys are forwarded verbatim to the decoration renderer, which owns their meaning.",
+      "if": { "properties": { "type": { "const": "shape" } }, "required": ["type"] },
+      "then": {
+        "required": ["shape", "x", "y", "w", "z"],
+        "properties": {
+          "shape": { "enum": ["rect", "roundRect", "pill", "ellipse", "ring", "line", "text", "image"] },
+          "x": { "type": "number" },
+          "y": { "type": "number" },
+          "w": { "type": "number" },
+          "h": { "type": "number", "description": "Required for every kind except line, which takes its thickness from the stroke width." },
+          "z": { "enum": ["under", "over"], "description": "Defaults to under, so a shape sits behind the slide's content." },
+          "fill": { "type": "string" },
+          "line": { "type": "string" },
+          "lw": { "type": "number" },
+          "radius": { "type": "number" },
+          "rotate": { "type": "number" },
+          "text": { "type": "string" },
+          "color": { "type": "string" },
+          "size": { "type": "number" },
+          "align": { "type": "string" },
+          "valign": { "type": "string" },
+          "char_spacing": { "type": "number" },
+          "bold": { "type": "boolean" },
+          "asset": { "type": "string" },
+          "dir": { "type": "string" },
+          "src": { "type": "string" },
+          "note": { "type": "string" }
+        }
+      }
+    }
+  }
+}