@multiplayer-app/sandbox 0.0.16 → 0.0.17

package/dist/lib/notebooks/notebook-yjs-blocks.js

@@ -0,0 +1,223 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tipTapNodeSchema = void 0;
+exports.tipTapNodeToYXml = tipTapNodeToYXml;
+exports.readFragmentBlocks = readFragmentBlocks;
+exports.blockPlainText = blockPlainText;
+exports.buildOutline = buildOutline;
+exports.ensureRunnableBlockAttrs = ensureRunnableBlockAttrs;
+const Y = __importStar(require("yjs"));
+const zod_1 = require("zod");
+const tipTapMarkSchema = zod_1.z.object({
+    type: zod_1.z.string().min(1),
+    attrs: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+exports.tipTapNodeSchema = zod_1.z.lazy(() => zod_1.z.object({
+    type: zod_1.z.string().min(1),
+    attrs: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    content: zod_1.z.array(exports.tipTapNodeSchema).optional(),
+    text: zod_1.z.string().optional(),
+    marks: zod_1.z.array(tipTapMarkSchema).optional(),
+}));
+function marksToDeltaAttributes(marks) {
+    var _a;
+    const attributes = {};
+    for (const mark of marks !== null && marks !== void 0 ? marks : []) {
+        if (mark.type !== 'ychange') {
+            attributes[mark.type] = (_a = mark.attrs) !== null && _a !== void 0 ? _a : {};
+        }
+    }
+    return attributes;
+}
+function createTextFromRun(run) {
+    const text = new Y.XmlText();
+    text.applyDelta(run.map((node) => {
+        var _a;
+        return ({
+            insert: (_a = node.text) !== null && _a !== void 0 ? _a : '',
+            attributes: marksToDeltaAttributes(node.marks),
+        });
+    }));
+    return text;
+}
+/** Convert a TipTap JSON node to a Y.Xml type, matching y-prosemirror's encoding. */
+function tipTapNodeToYXml(node) {
+    var _a, _b;
+    if (node.type === 'text') {
+        return createTextFromRun([node]);
+    }
+    const element = new Y.XmlElement(node.type);
+    for (const [key, value] of Object.entries((_a = node.attrs) !== null && _a !== void 0 ? _a : {})) {
+        if (value !== null && value !== undefined && key !== 'ychange') {
+            element.setAttribute(key, value);
+        }
+    }
+    // Consecutive text nodes collapse into a single Y.XmlText (normalizePNodeContent).
+    const children = [];
+    let textRun = [];
+    const flushRun = () => {
+        if (textRun.length > 0) {
+            children.push(createTextFromRun(textRun));
+            textRun = [];
+        }
+    };
+    for (const child of (_b = node.content) !== null && _b !== void 0 ? _b : []) {
+        if (child.type === 'text') {
+            textRun.push(child);
+        }
+        else {
+            flushRun();
+            children.push(tipTapNodeToYXml(child));
+        }
+    }
+    flushRun();
+    if (children.length > 0) {
+        element.insert(0, children);
+    }
+    return element;
+}
+function serializeXmlText(item) {
+    const delta = item.toDelta();
+    return delta.map((op) => {
+        const text = { type: 'text', text: op.insert };
+        if (op.attributes) {
+            text.marks = Object.keys(op.attributes).map((type) => {
+                var _a;
+                return ({
+                    type,
+                    attrs: (_a = op.attributes) === null || _a === void 0 ? void 0 : _a[type],
+                });
+            });
+        }
+        return text;
+    });
+}
+function serializeXmlElement(item) {
+    const node = { type: item.nodeName };
+    const attrs = item.getAttributes();
+    if (Object.keys(attrs).length > 0) {
+        node.attrs = attrs;
+    }
+    const children = item.toArray();
+    if (children.length > 0) {
+        node.content = children.flatMap((child) => child instanceof Y.XmlText
+            ? serializeXmlText(child)
+            : [serializeXmlElement(child)]);
+    }
+    return node;
+}
+/** Read the fragment's top-level blocks as TipTap JSON (mirror of yXmlFragmentToProsemirrorJSON). */
+function readFragmentBlocks(fragment) {
+    return fragment
+        .toArray()
+        .map((item) => item instanceof Y.XmlText
+        ? serializeXmlText(item)
+        : serializeXmlElement(item))
+        .flat();
+}
+const TEXTUAL_ATTR_KEYS = ['query', 'content', 'title'];
+/** Plain text of a block for search/previews, including code/query attrs of atom blocks. */
+function blockPlainText(node) {
+    var _a, _b;
+    const parts = [];
+    if (node.text) {
+        parts.push(node.text);
+    }
+    for (const key of TEXTUAL_ATTR_KEYS) {
+        const value = (_a = node.attrs) === null || _a === void 0 ? void 0 : _a[key];
+        if (typeof value === 'string' && value.length > 0) {
+            parts.push(value);
+        }
+    }
+    for (const child of (_b = node.content) !== null && _b !== void 0 ? _b : []) {
+        parts.push(blockPlainText(child));
+    }
+    return parts.filter(Boolean).join(' ');
+}
+const OUTLINE_PREVIEW_LENGTH = 150;
+const OUTLINE_ATTR_KEYS = {
+    heading: ['level'],
+    sqlBlock: ['_globalName', 'databaseName'],
+    runnableCodeBlock: ['_globalName', 'language'],
+    chartBlock: ['_globalName', 'title'],
+};
+/** Compact numbered outline of top-level blocks for agent orientation. */
+function buildOutline(blocks) {
+    return blocks.map((block, index) => {
+        const entry = {
+            index,
+            type: block.type,
+            preview: blockPlainText(block).slice(0, OUTLINE_PREVIEW_LENGTH),
+        };
+        const keys = OUTLINE_ATTR_KEYS[block.type];
+        if (keys && block.attrs) {
+            const attrs = {};
+            for (const key of keys) {
+                if (block.attrs[key] !== undefined) {
+                    attrs[key] = block.attrs[key];
+                }
+            }
+            if (Object.keys(attrs).length > 0) {
+                entry.attrs = attrs;
+            }
+        }
+        return entry;
+    });
+}
+const RUNNABLE_BLOCK_TYPES = new Set(['runnableCodeBlock', 'sqlBlock', 'chartBlock']);
+/**
+ * Ensure runnable blocks carry the `_id`/`_globalName` attrs the editor generates
+ * client-side (`generateId`/`generateName` in @multiplayer-app/blocknote); server-created
+ * nodes bypass TipTap attribute defaults, so missing values are filled here.
+ */
+function ensureRunnableBlockAttrs(node) {
+    var _a;
+    if (!RUNNABLE_BLOCK_TYPES.has(node.type)) {
+        return node;
+    }
+    const attrs = { ...((_a = node.attrs) !== null && _a !== void 0 ? _a : {}) };
+    if (typeof attrs._id !== 'string' || attrs._id.length === 0) {
+        attrs._id = `${Date.now()}-${Math.random()}`;
+    }
+    if (typeof attrs._globalName !== 'string' || attrs._globalName.length === 0) {
+        attrs._globalName = Date.now().toString();
+    }
+    if (node.type !== 'chartBlock' && attrs._runnable === undefined) {
+        attrs._runnable = true;
+    }
+    return { ...node, attrs };
+}
+//# sourceMappingURL=notebook-yjs-blocks.js.map

package/dist/lib/notebooks/notebook-yjs-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-yjs-blocks.js","sourceRoot":"","sources":["../../../src/lib/notebooks/notebook-yjs-blocks.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,4CAmCC;AAyCD,gDASC;AAKD,wCAeC;AAkBD,oCAsBC;AASD,4DAeC;AA1OD,uCAAwB;AACxB,6BAAuB;AA2BvB,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAA;AAEW,QAAA,gBAAgB,GAA0B,OAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACjE,OAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,wBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CACH,CAAA;AAED,SAAS,sBAAsB,CAAC,KAA+B;;IAC7D,MAAM,UAAU,GAA4B,EAAE,CAAA;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,EAAE,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAiB;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5B,IAAI,CAAC,UAAU,CACb,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;;QAAC,OAAA,CAAC;YACjB,MAAM,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,EAAE;YACvB,UAAU,EAAE,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAA;KAAA,CAAC,CACJ,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,qFAAqF;AACrF,SAAgB,gBAAgB,CAAC,IAAgB;;IAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,KAAK,mCAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC/D,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,KAAe,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,MAAM,QAAQ,GAAoC,EAAE,CAAA;IACpD,IAAI,OAAO,GAAiB,EAAE,CAAA;IAC9B,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;YACzC,OAAO,GAAG,EAAE,CAAA;QACd,CAAC;IACH,CAAC,CAAA;IACD,KAAK,MAAM,KAAK,IAAI,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,QAAQ,EAAE,CAAA;YACV,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAA;IAEV,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAOD,SAAS,gBAAgB,CAAC,IAAe;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAmB,CAAA;IAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACtB,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,CAAA;QAC1D,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;;gBAAC,OAAA,CAAC;oBACrD,IAAI;oBACJ,KAAK,EAAE,MAAA,EAAE,CAAC,UAAU,0CAAG,IAAI,CAAC;iBAC7B,CAAC,CAAA;aAAA,CAAC,CAAA;QACL,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAkB;IAC7C,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;IAEhD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAA6B,CAAA;IAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAC/B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACxC,KAAK,YAAY,CAAC,CAAC,OAAO;YACxB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAqB,CAAC,CAAC,CACjD,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,qGAAqG;AACrG,SAAgB,kBAAkB,CAAC,QAAuB;IACxD,OAAO,QAAQ;SACZ,OAAO,EAAE;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,IAAI,YAAY,CAAC,CAAC,OAAO;QACvB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,mBAAmB,CAAC,IAAoB,CAAC,CAC9C;SACA,IAAI,EAAE,CAAA;AACX,CAAC;AAED,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAEhE,4FAA4F;AAC5F,SAAgB,cAAc,CAAC,IAAgB;;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAA,IAAI,CAAC,KAAK,0CAAG,GAAG,CAAC,CAAA;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxC,CAAC;AASD,MAAM,sBAAsB,GAAG,GAAG,CAAA;AAClC,MAAM,iBAAiB,GAA6B;IAClD,OAAO,EAAE,CAAC,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;IACzC,iBAAiB,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC;IAC9C,UAAU,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;CACrC,CAAA;AAED,0EAA0E;AAC1E,SAAgB,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,KAAK,GAAyB;YAClC,KAAK;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC;SAChE,CAAA;QAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,KAAK,GAA4B,EAAE,CAAA;YACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBACnC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;YACrB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAA;AAErF;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,IAAgB;;IACvD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,MAAA,IAAI,CAAC,KAAK,mCAAI,EAAE,CAAC,EAAE,CAAA;IACvC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAA;IAC9C,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAK,KAAK,CAAC,WAAsB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxF,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IAC3C,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAA;AAC3B,CAAC"}

package/dist/lib/session-artifacts/hashline-tags.d.ts

@@ -0,0 +1,17 @@
+export interface TaggedLine {
+    tag: string;
+    text: string;
+}
+export declare function computeLineHash(line: string): string;
+export declare function splitContentLines(content: string): string[];
+export declare function joinContentLines(lines: string[]): string;
+export declare function formatTaggedLines(content: string): TaggedLine[];
+export interface ParsedTagRange {
+    startLine: number;
+    startHash: string;
+    endLine: number;
+    endHash: string;
+}
+export declare function parseTagRange(range: string): ParsedTagRange;
+export declare function applyTaggedLinePatch(lines: string[], range: string, replace: string): string[];
+//# sourceMappingURL=hashline-tags.d.ts.map

package/dist/lib/session-artifacts/hashline-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashline-tags.d.ts","sourceRoot":"","sources":["../../../src/lib/session-artifacts/hashline-tags.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAK/D;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAmB3D;AAgBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAe9F"}

package/dist/lib/session-artifacts/hashline-tags.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeLineHash = computeLineHash;
+exports.splitContentLines = splitContentLines;
+exports.joinContentLines = joinContentLines;
+exports.formatTaggedLines = formatTaggedLines;
+exports.parseTagRange = parseTagRange;
+exports.applyTaggedLinePatch = applyTaggedLinePatch;
+const node_crypto_1 = require("node:crypto");
+const TAG_RANGE_PATTERN = /^(\d+):([0-9a-f]+)\.\.(\d+):([0-9a-f]+)$/i;
+function computeLineHash(line) {
+    return (0, node_crypto_1.createHash)('sha256').update(line).digest('hex').slice(0, 2);
+}
+function splitContentLines(content) {
+    if (content.length === 0) {
+        return [];
+    }
+    return content.split('\n');
+}
+function joinContentLines(lines) {
+    return lines.join('\n');
+}
+function formatTaggedLines(content) {
+    return splitContentLines(content).map((text, index) => ({
+        tag: `${index + 1}:${computeLineHash(text)}`,
+        text,
+    }));
+}
+function parseTagRange(range) {
+    const match = range.trim().match(TAG_RANGE_PATTERN);
+    if (!match) {
+        throw new Error(`Invalid tag range: ${range}`);
+    }
+    const startLine = Number.parseInt(match[1], 10);
+    const endLine = Number.parseInt(match[3], 10);
+    if (startLine < 1 || endLine < startLine) {
+        throw new Error(`Invalid tag range bounds: ${range}`);
+    }
+    return {
+        startLine,
+        startHash: match[2].toLowerCase(),
+        endLine,
+        endHash: match[4].toLowerCase(),
+    };
+}
+function assertLineTag(lines, lineNumber, expectedHash) {
+    const index = lineNumber - 1;
+    if (index < 0 || index >= lines.length) {
+        throw new Error(`Line ${lineNumber} out of range (file has ${lines.length} lines)`);
+    }
+    const actualHash = computeLineHash(lines[index]);
+    if (actualHash !== expectedHash) {
+        throw new Error(`Hash mismatch at line ${lineNumber}: expected ${expectedHash}, got ${actualHash}. Re-read the file before editing.`);
+    }
+}
+function applyTaggedLinePatch(lines, range, replace) {
+    const { startLine, startHash, endLine, endHash } = parseTagRange(range);
+    assertLineTag(lines, startLine, startHash);
+    assertLineTag(lines, endLine, endHash);
+    const replacementLines = splitContentLines(replace);
+    const startIndex = startLine - 1;
+    const deleteCount = endLine - startLine + 1;
+    return [
+        ...lines.slice(0, startIndex),
+        ...replacementLines,
+        ...lines.slice(startIndex + deleteCount),
+    ];
+}
+//# sourceMappingURL=hashline-tags.js.map

package/dist/lib/session-artifacts/hashline-tags.js.map

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

package/dist/lib/session-artifacts/parse-hashline-diff.d.ts

@@ -5,6 +5,7 @@ interface Patch {
     replace: string;
 }
 export declare function parsePatches(input: string): Patch[];
+export declare function applyPatchToLines(lines: string[], patchText: string): string[];
 export declare function applyPatch(ytext: Y.Text, patchText: string): void;
 export {};
 //# sourceMappingURL=parse-hashline-diff.d.ts.map

package/dist/lib/session-artifacts/parse-hashline-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-hashline-diff.d.ts","sourceRoot":"","sources":["../../../src/lib/session-artifacts/parse-hashline-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAcnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAiBjE"}
+{"version":3,"file":"parse-hashline-diff.d.ts","sourceRoot":"","sources":["../../../src/lib/session-artifacts/parse-hashline-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAQxB,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAmBnD;AAUD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAcjE"}

package/dist/lib/session-artifacts/parse-hashline-diff.js

@@ -1,32 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePatches = parsePatches;
+exports.applyPatchToLines = applyPatchToLines;
 exports.applyPatch = applyPatch;
+const hashline_tags_1 = require("./hashline-tags");
 const PATCH_PATTERN = /<<<SEARCH\s+([^\n]+)\n([\s\S]*?)>>>REPLACE\n([\s\S]*?)<<<END/g;
 function parsePatches(input) {
     const patches = [];
     let match;
     while ((match = PATCH_PATTERN.exec(input)) !== null) {
+        let replace = match[3];
+        if (replace.endsWith('\n')) {
+            replace = replace.slice(0, -1);
+        }
         patches.push({
             range: match[1].trim(),
             search: match[2],
-            replace: match[3],
+            replace,
         });
     }
     return patches;
 }
+function sortPatchesForApplication(patches) {
+    return [...patches].sort((left, right) => {
+        const leftStart = (0, hashline_tags_1.parseTagRange)(left.range).startLine;
+        const rightStart = (0, hashline_tags_1.parseTagRange)(right.range).startLine;
+        return rightStart - leftStart;
+    });
+}
+function applyPatchToLines(lines, patchText) {
+    const patches = sortPatchesForApplication(parsePatches(patchText));
+    let nextLines = lines;
+    for (const patch of patches) {
+        nextLines = (0, hashline_tags_1.applyTaggedLinePatch)(nextLines, patch.range, patch.replace);
+    }
+    return nextLines;
+}
 function applyPatch(ytext, patchText) {
     var _a;
     const patches = parsePatches(patchText);
+    if (patches.length === 0) {
+        throw new Error('No SEARCH/REPLACE blocks found in diff');
+    }
     (_a = ytext.doc) === null || _a === void 0 ? void 0 : _a.transact(() => {
-        for (const patch of patches) {
-            const current = ytext.toString();
-            const start = current.indexOf(patch.search);
-            if (start === -1) {
-                throw new Error(`Search block not found for range ${patch.range}`);
-            }
-            ytext.delete(start, patch.search.length);
-            ytext.insert(start, patch.replace);
+        const current = ytext.toString();
+        const updated = (0, hashline_tags_1.joinContentLines)(applyPatchToLines((0, hashline_tags_1.splitContentLines)(current), patchText));
+        ytext.delete(0, current.length);
+        if (updated.length > 0) {
+            ytext.insert(0, updated);
         }
     });
 }

package/dist/lib/session-artifacts/parse-hashline-diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-hashline-diff.js","sourceRoot":"","sources":["../../../src/lib/session-artifacts/parse-hashline-diff.ts"],"names":[],"mappings":";;AAWA,oCAcC;AAED,gCAiBC;AApCD,MAAM,aAAa,GACf,+DAA+D,CAAA;AAEnE,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,OAAO,GAAY,EAAE,CAAA;IAE3B,IAAI,KAA6B,CAAA;IAEjC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACtB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa,EAAE,SAAiB;;IACzD,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAEvC,MAAA,KAAK,CAAC,GAAG,0CAAE,QAAQ,CAAC,GAAG,EAAE;QACvB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YAEhC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YAE3C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;YACpE,CAAC;YAED,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACxC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"parse-hashline-diff.js","sourceRoot":"","sources":["../../../src/lib/session-artifacts/parse-hashline-diff.ts"],"names":[],"mappings":";;AAiBA,oCAmBC;AAUD,8CASC;AAED,gCAcC;AAtED,mDAKwB;AAQxB,MAAM,aAAa,GACjB,+DAA+D,CAAA;AAEjE,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,OAAO,GAAY,EAAE,CAAA;IAE3B,IAAI,KAA6B,CAAA;IAEjC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACtB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAChC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACtB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAgB;IACjD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,SAAS,GAAG,IAAA,6BAAa,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAA;QACrD,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAA;QACvD,OAAO,UAAU,GAAG,SAAS,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAe,EAAE,SAAiB;IAClE,MAAM,OAAO,GAAG,yBAAyB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAElE,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,SAAS,GAAG,IAAA,oCAAoB,EAAC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa,EAAE,SAAiB;;IACzD,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC3D,CAAC;IAED,MAAA,KAAK,CAAC,GAAG,0CAAE,QAAQ,CAAC,GAAG,EAAE;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,IAAA,gCAAgB,EAAC,iBAAiB,CAAC,IAAA,iCAAiB,EAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;QAC1F,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC/B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/lib/session-pages/html-artifact-template.d.ts

@@ -0,0 +1,12 @@
+export interface WrapHtmlFragmentOptions {
+    title?: string;
+    lang?: string;
+}
+export declare function isHtmlFragment(content: string): boolean;
+export declare function wrapHtmlFragment(fragment: string, options?: WrapHtmlFragmentOptions): string;
+export declare function prepareHtmlArtifactContent(content: string, options?: {
+    fragment?: boolean;
+    title?: string;
+    lang?: string;
+}): string;
+//# sourceMappingURL=html-artifact-template.d.ts.map

package/dist/lib/session-pages/html-artifact-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-artifact-template.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/html-artifact-template.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAoBhG;AAUD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,MAAM,CAOR"}

package/dist/lib/session-pages/html-artifact-template.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHtmlFragment = isHtmlFragment;
+exports.wrapHtmlFragment = wrapHtmlFragment;
+exports.prepareHtmlArtifactContent = prepareHtmlArtifactContent;
+const PICO_CSS_URL = 'https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css';
+const FULL_HTML_DOCUMENT_PATTERN = /<!DOCTYPE\s+html|<html[\s>]/i;
+function isHtmlFragment(content) {
+    return !FULL_HTML_DOCUMENT_PATTERN.test(content.trim());
+}
+function wrapHtmlFragment(fragment, options = {}) {
+    var _a, _b;
+    const lang = (_a = options.lang) !== null && _a !== void 0 ? _a : 'en';
+    const title = ((_b = options.title) === null || _b === void 0 ? void 0 : _b.trim()) || 'Page';
+    const body = fragment.trim();
+    return `<!DOCTYPE html>
+<html lang="${lang}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="stylesheet" href="${PICO_CSS_URL}">
+  <title>${escapeHtml(title)}</title>
+</head>
+<body>
+  <main class="container">
+${body}
+  </main>
+</body>
+</html>
+`;
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function prepareHtmlArtifactContent(content, options = {}) {
+    const useFragment = options.fragment === true || (options.fragment !== false && isHtmlFragment(content));
+    if (!useFragment) {
+        return content;
+    }
+    return wrapHtmlFragment(content, { title: options.title, lang: options.lang });
+}
+//# sourceMappingURL=html-artifact-template.js.map

package/dist/lib/session-pages/html-artifact-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-artifact-template.js","sourceRoot":"","sources":["../../../src/lib/session-pages/html-artifact-template.ts"],"names":[],"mappings":";;AASA,wCAEC;AAED,4CAoBC;AAUD,gEAUC;AArDD,MAAM,YAAY,GAAG,+DAA+D,CAAA;AAEpF,MAAM,0BAA0B,GAAG,8BAA8B,CAAA;AAOjE,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,UAAmC,EAAE;;IACtF,MAAM,IAAI,GAAG,MAAA,OAAO,CAAC,IAAI,mCAAI,IAAI,CAAA;IACjC,MAAM,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,IAAI,EAAE,KAAI,MAAM,CAAA;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAE5B,OAAO;cACK,IAAI;;;;iCAIe,YAAY;WAClC,UAAU,CAAC,KAAK,CAAC;;;;EAI1B,IAAI;;;;CAIL,CAAA;AACD,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED,SAAgB,0BAA0B,CACxC,OAAe,EACf,UAAiE,EAAE;IAEnE,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;IACxG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAChF,CAAC"}

package/dist/lib/session-pages/write-session-artifacts.d.ts

@@ -1,6 +1,10 @@
 export interface SessionArtifactFile {
     path: string;
     content: string;
+    /** For .html files: when true, content is a body/main fragment wrapped in a Pico template server-side. */
+    fragment?: boolean;
+    /** Optional document title when publishing an HTML fragment. */
+    title?: string;
 }
 export interface WriteSessionArtifactsInput {
     sessionId: string;

package/dist/lib/session-pages/write-session-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-session-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,wBAAwB,EAAE,CAAA;CACtC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAmBtC"}
+{"version":3,"file":"write-session-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,wBAAwB,EAAE,CAAA;CACtC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CA0BtC"}

package/dist/lib/session-pages/write-session-artifacts.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeSessionArtifacts = writeSessionArtifacts;
 const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+const html_artifact_template_1 = require("./html-artifact-template");
 const paths_1 = require("./paths");
 async function writeSessionArtifacts(input) {
     if (input.files.length === 0) {
@@ -11,7 +12,13 @@ async function writeSessionArtifacts(input) {
     const artifacts = [];
     for (const file of input.files) {
         const relativePath = (0, paths_1.normalizeArtifactPath)(file.path);
-        const published = await store.initializeFromContent(input.sessionId, relativePath, file.content);
+        const content = relativePath.toLowerCase().endsWith('.html')
+            ? (0, html_artifact_template_1.prepareHtmlArtifactContent)(file.content, {
+                fragment: file.fragment,
+                title: file.title,
+            })
+            : file.content;
+        const published = await store.initializeFromContent(input.sessionId, relativePath, content);
         artifacts.push({
             path: published.path,
             bytes: published.bytes,

package/dist/lib/session-pages/write-session-artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-session-artifacts.js","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":";;AAsBA,sDAqBC;AA3CD,0FAAsF;AACtF,mCAA+C;AAqBxC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IAC1C,MAAM,SAAS,GAA+B,EAAE,CAAA;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAChG,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,SAAS;KACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"write-session-artifacts.js","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":";;AA2BA,sDA4BC;AAvDD,0FAAsF;AACtF,qEAAqE;AACrE,mCAA+C;AAyBxC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IAC1C,MAAM,SAAS,GAA+B,EAAE,CAAA;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,OAAO,GACX,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,IAAA,mDAA0B,EAAC,IAAI,CAAC,OAAO,EAAE;gBACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;QAClB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QAC3F,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,SAAS;KACV,CAAA;AACH,CAAC"}

package/dist/lib/socket/artifact-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-events.d.ts","sourceRoot":"","sources":["../../../src/lib/socket/artifact-events.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,EAAG,iBAA0B,CAAA;AAE/D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAiBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAMvF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAKjG"}
+{"version":3,"file":"artifact-events.d.ts","sourceRoot":"","sources":["../../../src/lib/socket/artifact-events.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,EAAG,iBAA0B,CAAA;AAE/D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAiBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAavF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAKjG"}

package/dist/lib/socket/artifact-events.js

@@ -5,6 +5,7 @@ exports.emitArtifactUpdate = emitArtifactUpdate;
 exports.emitArtifactUpdateToUsers = emitArtifactUpdateToUsers;
 const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
 const context_1 = require("../../context");
+const logger_1 = require("../../logger");
 exports.ARTIFACT_UPDATE_EVENT = 'artifact:update';
 function getSocketIO() {
     try {
@@ -17,8 +18,14 @@ function getSocketIO() {
 }
 function emitArtifactUpdate(userId, payload) {
     const io = getSocketIO();
-    if (!io || !userId)
+    if (!io) {
+        (0, logger_1.getBuilderApiLogger)().warn('Artifact update not emitted — Socket.IO unavailable');
         return;
+    }
+    if (!userId) {
+        (0, logger_1.getBuilderApiLogger)().warn('Artifact update not emitted — missing userId');
+        return;
+    }
     const userRoom = `${ai_agent_types_1.SocketIOConfig.UserRoomPrefix}${userId}`;
     io.to(userRoom).emit(exports.ARTIFACT_UPDATE_EVENT, payload);
 }

package/dist/lib/socket/artifact-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-events.js","sourceRoot":"","sources":["../../../src/lib/socket/artifact-events.ts"],"names":[],"mappings":";;;AA8BA,gDAMC;AAED,8DAKC;AA1CD,oEAAgE;AAChE,2CAA+C;AAElC,QAAA,qBAAqB,GAAG,iBAA0B,CAAA;AAiB/D,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,yBAAe,GAAE,CAAA;QACjC,OAAQ,OAA6C,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;IAC7E,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAc,EAAE,OAA8B;IAC/E,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM;QAAE,OAAM;IAE1B,MAAM,QAAQ,GAAG,GAAG,+BAAc,CAAC,cAAc,GAAG,MAAM,EAAE,CAAA;IAC5D,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,6BAAqB,EAAE,OAAO,CAAC,CAAA;AACtD,CAAC;AAED,SAAgB,yBAAyB,CAAC,OAAiB,EAAE,OAA8B;IACzF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACpD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;AACH,CAAC"}
+{"version":3,"file":"artifact-events.js","sourceRoot":"","sources":["../../../src/lib/socket/artifact-events.ts"],"names":[],"mappings":";;;AA+BA,gDAaC;AAED,8DAKC;AAlDD,oEAAgE;AAChE,2CAA+C;AAC/C,yCAAkD;AAErC,QAAA,qBAAqB,GAAG,iBAA0B,CAAA;AAiB/D,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,yBAAe,GAAE,CAAA;QACjC,OAAQ,OAA6C,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;IAC7E,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAc,EAAE,OAA8B;IAC/E,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;QACjF,OAAM;IACR,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;QAC1E,OAAM;IACR,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,+BAAc,CAAC,cAAc,GAAG,MAAM,EAAE,CAAA;IAC5D,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,6BAAqB,EAAE,OAAO,CAAC,CAAA;AACtD,CAAC;AAED,SAAgB,yBAAyB,CAAC,OAAiB,EAAE,OAA8B;IACzF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACpD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;AACH,CAAC"}

package/dist/lib/sql-schema.d.ts

@@ -26,4 +26,5 @@ export interface SqlQueryResult {
     rowCount: number;
     durationMs: number;
 }
+export type SqlExecutor = (query: string, databaseName: string) => Promise<SqlQueryResult>;
 //# sourceMappingURL=sql-schema.d.ts.map

package/dist/lib/sql-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-schema.d.ts","sourceRoot":"","sources":["../../src/lib/sql-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB"}
+{"version":3,"file":"sql-schema.d.ts","sourceRoot":"","sources":["../../src/lib/sql-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA"}

package/dist/realtime/session-artifact-yjs-store.d.ts

@@ -26,6 +26,13 @@ export declare class SessionArtifactYjsStore {
     applyPatchText(sessionId: string, artifactPath: string, patchText: string): Promise<{
         path: string;
     }>;
+    /** Notebook content lives in the 'xml' fragment (TipTap/y-prosemirror document). */
+    getNotebookFragment(accountId: string, notebookId: string): Promise<Y.XmlFragment>;
+    /**
+     * Mutates the notebook document in a single transaction, broadcasts the update to
+     * connected editors, and persists state immediately.
+     */
+    mutateNotebook(accountId: string, notebookId: string, mutator: (fragment: Y.XmlFragment, doc: Y.Doc) => void): Promise<void>;
     evictDocument(sessionId: string, artifactPath: string): void;
     resetFromFileContent(sessionId: string, artifactPath: string): Promise<void>;
     schedulePersist(documentIdentifier: string, doc: Y.Doc): void;

package/dist/realtime/session-artifact-yjs-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-artifact-yjs-store.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-yjs-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAsBxB,KAAK,eAAe,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;AAS/E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IACjF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAItC,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAwBrE,8FAA8F;YAChF,yBAAyB;IAiCjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7E;;;OAGG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCvE;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;IAyB7B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAYtD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,eAAe,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI;IAevD,uBAAuB,CAC3B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC;QAAE,EAAE,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS,CAAC;IAqBpE,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBxE,aAAa;IAuB3B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,qBAAqB;CAO9B;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE"}
+{"version":3,"file":"session-artifact-yjs-store.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-yjs-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAsBxB,KAAK,eAAe,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;AAS/E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IACjF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAItC,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAwBrE,8FAA8F;YAChF,yBAAyB;IAiCjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7E;;;OAGG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCvE;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;IAyB7B,oFAAoF;IAC9E,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IASxF;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,GACrD,OAAO,CAAC,IAAI,CAAC;IAmBhB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAYtD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,eAAe,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI;IAevD,uBAAuB,CAC3B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC;QAAE,EAAE,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS,CAAC;IAqBpE,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBxE,aAAa;IAuB3B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,qBAAqB;CAO9B;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE"}