notations 1.0.2 → 1.0.4

package/lib/esm/web/utils/sourceSerializer.js

@@ -0,0 +1,154 @@
+import { isBlock, isLine, isRawBlock } from "../../block";
+const DEFAULT_OPTIONS = {
+    indent: "  ",
+    lineSeparator: "\n",
+    preserveUnmodified: true,
+};
+export function serializeCells(cells, options = {}) {
+    const opts = Object.assign(Object.assign({}, DEFAULT_OPTIONS), options);
+    const parts = [];
+    for (const cell of cells) {
+        const serialized = serializeCell(cell, 0, opts);
+        if (serialized) {
+            parts.push(serialized);
+        }
+    }
+    return parts.join(opts.lineSeparator + opts.lineSeparator);
+}
+export function serializeCell(cell, depth, options) {
+    const indent = options.indent.repeat(depth);
+    if (options.preserveUnmodified && cell.source && !cell.state.hasError) {
+        if (depth === 0) {
+            return cell.source;
+        }
+        return cell.source
+            .split("\n")
+            .map((line) => indent + line)
+            .join(options.lineSeparator);
+    }
+    return serializeBlockItem(cell.blockItem, depth, options);
+}
+export function serializeBlockItem(item, depth, options) {
+    if (isRawBlock(item)) {
+        return serializeRawBlock(item, depth, options);
+    }
+    if (isLine(item)) {
+        return serializeLine(item, depth, options);
+    }
+    if (isBlock(item)) {
+        return serializeBlock(item, depth, options);
+    }
+    return "";
+}
+function serializeRawBlock(rawBlock, depth, options) {
+    const indent = options.indent.repeat(depth);
+    const content = rawBlock.content;
+    if (rawBlock.contentType === "md") {
+        return `${indent}---${options.lineSeparator}${content}${options.lineSeparator}${indent}---`;
+    }
+    if (rawBlock.contentType === "metadata") {
+        return `${indent}@@${content}`;
+    }
+    return content
+        .split("\n")
+        .map((line) => indent + line)
+        .join(options.lineSeparator);
+}
+function serializeLine(line, depth, options) {
+    const indent = options.indent.repeat(depth);
+    return `${indent}; [Line serialization not fully implemented]`;
+}
+function serializeBlock(block, depth, options) {
+    const indent = options.indent.repeat(depth);
+    const childIndent = options.indent.repeat(depth + 1);
+    const parts = [];
+    const header = serializeBlockHeader(block);
+    parts.push(`${indent}${header} {`);
+    for (const child of block.blockItems) {
+        const childSource = serializeBlockItem(child, depth + 1, options);
+        if (childSource) {
+            parts.push(childSource);
+        }
+    }
+    parts.push(`${indent}}`);
+    return parts.join(options.lineSeparator);
+}
+function serializeBlockHeader(block) {
+    var _a;
+    const type = block.blockType;
+    switch (type) {
+        case "section":
+            return `\\section("${block.name || ""}")`;
+        case "repeat": {
+            const repeatCount = (_a = block.repeatCount) !== null && _a !== void 0 ? _a : 1;
+            return `\\repeat(${repeatCount})`;
+        }
+        case "cycle":
+            if (block.localCycle) {
+                return `\\cycle("${block.localCycle.toString()}")`;
+            }
+            return "\\cycle()";
+        case "beatduration":
+            if (block.localAtomsPerBeat !== null) {
+                return `\\beatDuration(${block.localAtomsPerBeat})`;
+            }
+            return "\\beatDuration(1)";
+        case "breaks":
+            if (block.localBreaks) {
+                return `\\breaks(${block.localBreaks.join(", ")})`;
+            }
+            return "\\breaks()";
+        case "role": {
+            const roleName = Array.from(block.localRoles.keys())[0] || "";
+            return `\\role("${roleName}")`;
+        }
+        case "group":
+            if (block.name) {
+                return `\\group("${block.name}")`;
+            }
+            return "\\group()";
+        case "notation":
+            return "";
+        default:
+            return `\\${type}()`;
+    }
+}
+export function updateCellSource(cell, newSource) {
+    return Object.assign(Object.assign({}, cell), { source: newSource });
+}
+export function validateCellSource(source) {
+    let braceCount = 0;
+    for (const char of source) {
+        if (char === "{")
+            braceCount++;
+        if (char === "}")
+            braceCount--;
+        if (braceCount < 0) {
+            return {
+                isValid: false,
+                error: "Unmatched closing brace",
+            };
+        }
+    }
+    if (braceCount !== 0) {
+        return {
+            isValid: false,
+            error: "Unmatched opening brace",
+        };
+    }
+    return { isValid: true };
+}
+export function findCellSourceRange(cell, fullSource) {
+    if (isRawBlock(cell.blockItem)) {
+        const rawBlock = cell.blockItem;
+        const start = fullSource.indexOf(rawBlock.content);
+        if (start >= 0) {
+            return {
+                start,
+                end: start + rawBlock.content.length,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=sourceSerializer.js.map

package/lib/esm/web/utils/sourceSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceSerializer.js","sourceRoot":"","sources":["../../../../src/web/utils/sourceSerializer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0B1D,MAAM,eAAe,GAAsB;IACzC,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,IAAI;CACzB,CAAC;AASF,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,UAA6B,EAAE;IAChF,MAAM,IAAI,mCAAQ,eAAe,GAAK,OAAO,CAAE,CAAC;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAc,GAAG,IAAI,CAAC,aAAc,CAAC,CAAC;AAC/D,CAAC;AAUD,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,KAAa,EAAE,OAA0B;IACtF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAG7C,IAAI,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEtE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM;aACf,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;aAC5B,IAAI,CAAC,OAAO,CAAC,aAAc,CAAC,CAAC;IAClC,CAAC;IAGD,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAUD,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,KAAa,EAAE,OAA0B;IAC3F,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,iBAAiB,CAAC,IAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,OAAO,aAAa,CAAC,IAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,cAAc,CAAC,IAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAKD,SAAS,iBAAiB,CAAC,QAAkB,EAAE,KAAa,EAAE,OAA0B;IACtF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAGjC,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAElC,OAAO,GAAG,MAAM,MAAM,OAAO,CAAC,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,MAAM,KAAK,CAAC;IAC9F,CAAC;IAED,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAExC,OAAO,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC;IACjC,CAAC;IAGD,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;SAC5B,IAAI,CAAC,OAAO,CAAC,aAAc,CAAC,CAAC;AAClC,CAAC;AAQD,SAAS,aAAa,CAAC,IAAU,EAAE,KAAa,EAAE,OAA0B;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAK7C,OAAO,GAAG,MAAM,8CAA8C,CAAC;AACjE,CAAC;AAKD,SAAS,cAAc,CAAC,KAAY,EAAE,KAAa,EAAE,OAA0B;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAG3B,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;IAGnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAGD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAEzB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAc,CAAC,CAAC;AAC5C,CAAC;AAKD,SAAS,oBAAoB,CAAC,KAAY;;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,cAAc,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC;QAE5C,KAAK,QAAQ,CAAC,CAAC,CAAC;YAEd,MAAM,WAAW,GAAG,MAAC,KAAa,CAAC,WAAW,mCAAI,CAAC,CAAC;YACpD,OAAO,YAAY,WAAW,GAAG,CAAC;QACpC,CAAC;QAED,KAAK,OAAO;YAEV,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,OAAO,YAAY,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC;YACrD,CAAC;YACD,OAAO,WAAW,CAAC;QAErB,KAAK,cAAc;YACjB,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;gBACrC,OAAO,kBAAkB,KAAK,CAAC,iBAAiB,GAAG,CAAC;YACtD,CAAC;YACD,OAAO,mBAAmB,CAAC;QAE7B,KAAK,QAAQ;YACX,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,OAAO,YAAY,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACrD,CAAC;YACD,OAAO,YAAY,CAAC;QAEtB,KAAK,MAAM,CAAC,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9D,OAAO,WAAW,QAAQ,IAAI,CAAC;QACjC,CAAC;QAED,KAAK,OAAO;YACV,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,YAAY,KAAK,CAAC,IAAI,IAAI,CAAC;YACpC,CAAC;YACD,OAAO,WAAW,CAAC;QAErB,KAAK,UAAU;YAEb,OAAO,EAAE,CAAC;QAEZ;YACE,OAAO,KAAK,IAAI,IAAI,CAAC;IACzB,CAAC;AACH,CAAC;AASD,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,SAAiB;IACjE,uCACK,IAAI,KACP,MAAM,EAAE,SAAS,IACjB;AACJ,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAQ/C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,GAAG;YAAE,UAAU,EAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,GAAG;YAAE,UAAU,EAAE,CAAC;QAC/B,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,yBAAyB;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,yBAAyB;SACjC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAWD,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,UAAkB;IAIrE,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAqB,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO;gBACL,KAAK;gBACL,GAAG,EAAE,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Source serializer for converting CellModel trees back to notation source.\n *\n * This module handles serializing edited cells back into notation source text,\n * preserving formatting and structure where possible.\n */\n\nimport type { BlockItem, Block, RawBlock } from \"../../block\";\nimport type { Line } from \"../../core\";\nimport { isBlock, isLine, isRawBlock } from \"../../block\";\nimport { CellModel } from \"../types/notebook\";\n\n/**\n * Options for source serialization.\n */\nexport interface SerializerOptions {\n  /**\n   * Indentation string to use for nested blocks.\n   * @default \"  \" (two spaces)\n   */\n  indent?: string;\n\n  /**\n   * Line separator.\n   * @default \"\\n\"\n   */\n  lineSeparator?: string;\n\n  /**\n   * Whether to preserve original source for unmodified cells.\n   * @default true\n   */\n  preserveUnmodified?: boolean;\n}\n\nconst DEFAULT_OPTIONS: SerializerOptions = {\n  indent: \"  \",\n  lineSeparator: \"\\n\",\n  preserveUnmodified: true,\n};\n\n/**\n * Serializes a cell tree back to notation source.\n *\n * @param cells The cell models to serialize\n * @param options Serialization options\n * @returns The serialized notation source\n */\nexport function serializeCells(cells: CellModel[], options: SerializerOptions = {}): string {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  const parts: string[] = [];\n\n  for (const cell of cells) {\n    const serialized = serializeCell(cell, 0, opts);\n    if (serialized) {\n      parts.push(serialized);\n    }\n  }\n\n  return parts.join(opts.lineSeparator! + opts.lineSeparator!);\n}\n\n/**\n * Serializes a single cell to source.\n *\n * @param cell The cell to serialize\n * @param depth The current nesting depth\n * @param options Serialization options\n * @returns The serialized source\n */\nexport function serializeCell(cell: CellModel, depth: number, options: SerializerOptions): string {\n  const indent = options.indent!.repeat(depth);\n\n  // If preserving unmodified and cell has source, use it directly\n  if (options.preserveUnmodified && cell.source && !cell.state.hasError) {\n    // For top-level cells, return source as-is\n    if (depth === 0) {\n      return cell.source;\n    }\n    // For nested cells, indent each line\n    return cell.source\n      .split(\"\\n\")\n      .map((line) => indent + line)\n      .join(options.lineSeparator!);\n  }\n\n  // Otherwise, serialize from the block item\n  return serializeBlockItem(cell.blockItem, depth, options);\n}\n\n/**\n * Serializes a BlockItem to source.\n *\n * @param item The block item to serialize\n * @param depth The current nesting depth\n * @param options Serialization options\n * @returns The serialized source\n */\nexport function serializeBlockItem(item: BlockItem, depth: number, options: SerializerOptions): string {\n  if (isRawBlock(item)) {\n    return serializeRawBlock(item as RawBlock, depth, options);\n  }\n\n  if (isLine(item)) {\n    return serializeLine(item as Line, depth, options);\n  }\n\n  if (isBlock(item)) {\n    return serializeBlock(item as Block, depth, options);\n  }\n\n  return \"\";\n}\n\n/**\n * Serializes a RawBlock to source.\n */\nfunction serializeRawBlock(rawBlock: RawBlock, depth: number, options: SerializerOptions): string {\n  const indent = options.indent!.repeat(depth);\n  const content = rawBlock.content;\n\n  // Determine wrapper based on content type\n  if (rawBlock.contentType === \"md\") {\n    // Markdown content uses triple backtick or raw syntax\n    return `${indent}---${options.lineSeparator}${content}${options.lineSeparator}${indent}---`;\n  }\n\n  if (rawBlock.contentType === \"metadata\") {\n    // Metadata reference\n    return `${indent}@@${content}`;\n  }\n\n  // Default: plain text or other content\n  return content\n    .split(\"\\n\")\n    .map((line) => indent + line)\n    .join(options.lineSeparator!);\n}\n\n/**\n * Serializes a Line to source.\n *\n * Note: This is a simplified serialization. Full Line serialization\n * would need to reconstruct atoms, spaces, embellishments, etc.\n */\nfunction serializeLine(line: Line, depth: number, options: SerializerOptions): string {\n  const indent = options.indent!.repeat(depth);\n\n  // For now, return a placeholder\n  // Full implementation would iterate through line.atoms and serialize each\n  // This would require significant work to reconstruct the DSL syntax\n  return `${indent}; [Line serialization not fully implemented]`;\n}\n\n/**\n * Serializes a Block to source.\n */\nfunction serializeBlock(block: Block, depth: number, options: SerializerOptions): string {\n  const indent = options.indent!.repeat(depth);\n  const childIndent = options.indent!.repeat(depth + 1);\n  const parts: string[] = [];\n\n  // Block header\n  const header = serializeBlockHeader(block);\n  parts.push(`${indent}${header} {`);\n\n  // Children\n  for (const child of block.blockItems) {\n    const childSource = serializeBlockItem(child, depth + 1, options);\n    if (childSource) {\n      parts.push(childSource);\n    }\n  }\n\n  // Closing brace\n  parts.push(`${indent}}`);\n\n  return parts.join(options.lineSeparator!);\n}\n\n/**\n * Serializes a block header (command with parameters).\n */\nfunction serializeBlockHeader(block: Block): string {\n  const type = block.blockType;\n\n  switch (type) {\n    case \"section\":\n      return `\\\\section(\"${block.name || \"\"}\")`;\n\n    case \"repeat\": {\n      // RepeatBlock has repeatCount property\n      const repeatCount = (block as any).repeatCount ?? 1;\n      return `\\\\repeat(${repeatCount})`;\n    }\n\n    case \"cycle\":\n      // CycleBlock has localCycle\n      if (block.localCycle) {\n        return `\\\\cycle(\"${block.localCycle.toString()}\")`;\n      }\n      return \"\\\\cycle()\";\n\n    case \"beatduration\":\n      if (block.localAtomsPerBeat !== null) {\n        return `\\\\beatDuration(${block.localAtomsPerBeat})`;\n      }\n      return \"\\\\beatDuration(1)\";\n\n    case \"breaks\":\n      if (block.localBreaks) {\n        return `\\\\breaks(${block.localBreaks.join(\", \")})`;\n      }\n      return \"\\\\breaks()\";\n\n    case \"role\": {\n      // Get first role name from localRoles\n      const roleName = Array.from(block.localRoles.keys())[0] || \"\";\n      return `\\\\role(\"${roleName}\")`;\n    }\n\n    case \"group\":\n      if (block.name) {\n        return `\\\\group(\"${block.name}\")`;\n      }\n      return \"\\\\group()\";\n\n    case \"notation\":\n      // Root notation block has no header\n      return \"\";\n\n    default:\n      return `\\\\${type}()`;\n  }\n}\n\n/**\n * Updates a cell's source and marks it as modified.\n *\n * @param cell The cell to update\n * @param newSource The new source text\n * @returns A new CellModel with updated source\n */\nexport function updateCellSource(cell: CellModel, newSource: string): CellModel {\n  return {\n    ...cell,\n    source: newSource,\n  };\n}\n\n/**\n * Validates cell source by attempting to parse it.\n *\n * @param source The source to validate\n * @returns Object with isValid flag and optional error message\n */\nexport function validateCellSource(source: string): {\n  isValid: boolean;\n  error?: string;\n} {\n  // For now, just check for basic syntax issues\n  // Full validation would require the notation parser\n\n  // Check for balanced braces\n  let braceCount = 0;\n  for (const char of source) {\n    if (char === \"{\") braceCount++;\n    if (char === \"}\") braceCount--;\n    if (braceCount < 0) {\n      return {\n        isValid: false,\n        error: \"Unmatched closing brace\",\n      };\n    }\n  }\n\n  if (braceCount !== 0) {\n    return {\n      isValid: false,\n      error: \"Unmatched opening brace\",\n    };\n  }\n\n  return { isValid: true };\n}\n\n/**\n * Extracts the source range for a cell from full notation source.\n * This is a best-effort function that tries to find the cell's content\n * in the original source.\n *\n * @param cell The cell to find\n * @param fullSource The full notation source\n * @returns Source range or null if not found\n */\nexport function findCellSourceRange(cell: CellModel, fullSource: string): { start: number; end: number } | null {\n  // This is a simplified implementation\n  // Full implementation would need source position tracking in the parser\n\n  if (isRawBlock(cell.blockItem)) {\n    const rawBlock = cell.blockItem as RawBlock;\n    const start = fullSource.indexOf(rawBlock.content);\n    if (start >= 0) {\n      return {\n        start,\n        end: start + rawBlock.content.length,\n      };\n    }\n  }\n\n  return null;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notations",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "author": "Sriram Panyam",
   "description": "A package for modelling, parsing, laying out carnatic musical notation",
   "homepage": "https://github.com/panyam/notations#readme",
@@ -8,6 +8,25 @@
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",
   "types": "lib/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/esm/index.d.ts",
+      "import": "./lib/esm/index.js",
+      "require": "./lib/cjs/index.js"
+    },
+    "./web": {
+      "types": "./lib/esm/web/index.d.ts",
+      "import": "./lib/esm/web/index.js",
+      "require": "./lib/cjs/web/index.js"
+    },
+    "./web/dockview": {
+      "types": "./lib/esm/web/dockview.d.ts",
+      "import": "./lib/esm/web/dockview.js",
+      "require": "./lib/cjs/web/dockview.js"
+    },
+    "./styles/*": "./styles/*",
+    "./dist/*": "./dist/*"
+  },
   "files": [
     "lib/",
     "styles/",
@@ -29,12 +48,22 @@
     "@lume/kiwi": "^0.4.4",
     "@panyam/tsutils": "*",
     "galore": "*",
+    "tlex": "*",
     "yaml": "^2.8.2"
   },
+  "peerDependencies": {
+    "dockview-core": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "dockview-core": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@babel/core": "^7.26.10",
     "@babel/plugin-proposal-class-properties": "^7.18.6",
     "@babel/plugin-proposal-object-rest-spread": "^7.20.7",
+    "@babel/preset-env": "^7.23.0",
     "@babel/preset-flow": "^7.25.9",
     "@babel/preset-typescript": "^7.27.0",
     "@eslint/js": "^9.39.2",
@@ -49,11 +78,15 @@
     "babel-loader": "^10.0.0",
     "babel-preset-env": "^1.7.0",
     "browserify": "17.0.1",
+    "clean-webpack-plugin": "^4.0.0",
     "codecov": "^3.8.3",
+    "css-loader": "^7.1.2",
+    "dockview-core": "^4.13.1",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "highlight.js": "11.11.1",
+    "html-webpack-plugin": "^5.5.3",
     "jest": "^29.7.0",
     "jest-each": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
@@ -64,7 +97,11 @@
     "pre-commit": "^1.2.2",
     "prettier": "^3.5.3",
     "sass": "^1.97.1",
+    "sass-loader": "^16.0.6",
+    "stream-browserify": "^3.0.0",
+    "style-loader": "^4.0.0",
     "ts-jest": "^29.3.1",
+    "ts-loader": "^9.5.0",
     "typedoc": "^0.28.2",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.51.0",
@@ -86,6 +123,9 @@
     "buildbase": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig-cjs.json",
     "build:css": "mkdir -p dist && sass styles/NotationView.scss dist/NotationView.css --style=expanded && sass styles/NotationView.scss dist/NotationView.min.css --style=compressed",
     "build:umd": "webpack --mode=development && webpack --mode=production",
+    "build:docs": "webpack --config docs/webpack.config.js --mode production",
+    "build:docs:dev": "webpack --config docs/webpack.config.js --mode development",
+    "build:docs:watch": "webpack --config docs/webpack.config.js --mode development --watch",
     "build": "npm run builddocs && npm run buildbase && npm run build:css && npm run build:umd",
     "test": "jest --coverage --runInBand",
     "lint": "eslint src --quiet",