notations 0.0.69 → 0.0.70

package/lib/cjs/carnatic/NotationView.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotationView = void 0;
 const TSU = __importStar(require("@panyam/tsutils"));
 const LineView_1 = require("./LineView");
+const notation_1 = require("../notation");
 const beatviews_1 = require("./beatviews");
 class NotationView {
     constructor(rootElement, config) {
@@ -43,9 +44,13 @@ class NotationView {
         this.config = config;
         this.lineViews = [];
         this.currentSVGElement = null;
+        this.layoutChangeUnsubscribe = null;
         this.beatViews = new Map();
         this.markerViews = new Map();
         this.loadChildViews();
+        if (config === null || config === void 0 ? void 0 : config.markdownParser) {
+            this.markdownParser = config.markdownParser;
+        }
     }
     get beatLayout() {
         return this._beatLayout;
@@ -140,18 +145,8 @@ class NotationView {
         this.beatViews = new Map();
     }
     refreshLayout() {
-        const lines = [];
         const lineViews = [];
-        for (const block of this.notation.blocks) {
-            if (block.TYPE == "RawBlock") {
-                this.renderBlock(block);
-            }
-            else {
-                lines.push(block);
-                const lineView = this.ensureLineView(block);
-                lineViews.push(lineView);
-            }
-        }
+        this.processBlock(this.notation, lineViews);
         const now = performance.now();
         for (const lineView of lineViews) {
             lineView.gridModel.lastUpdatedAt = now;
@@ -161,6 +156,26 @@ class NotationView {
             lineView.wrapToSize();
         }
     }
+    processBlock(block, lineViews) {
+        for (const child of block.children()) {
+            this.processBlockItem(child, lineViews);
+        }
+    }
+    processBlockItem(item, lineViews) {
+        if ((0, notation_1.isRawBlock)(item)) {
+            this.renderBlock(item);
+        }
+        else if ((0, notation_1.isLine)(item)) {
+            const line = item;
+            if (!line.isEmpty) {
+                const lineView = this.ensureLineView(line);
+                lineViews.push(lineView);
+            }
+        }
+        else if ((0, notation_1.isBlock)(item)) {
+            this.processBlock(item, lineViews);
+        }
+    }
     renderBlock(raw) {
         const [, td2] = this.addNewRow(raw.uuid + "", "rawBlock", false);
         if (raw.contentType == "metadata") {

package/lib/cjs/carnatic/NotationView.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotationView.js","sourceRoot":"","sources":["../../../src/carnatic/NotationView.ts"],"names":[],"mappings":"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","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\nimport { LineView } from \"./LineView\";\nimport { Notation, RawBlock } from \"../notation\";\nimport { Beat, GlobalBeatLayout } from \"../beats\";\nimport { GridCell, GridCellView } from \"../grids\";\nimport { Line } from \"../core\";\nimport { BeatView, MarkerView } from \"./beatviews\";\n\nexport class NotationView {\n  headerElement: HTMLDivElement;\n  notation: Notation;\n  lineViews: LineView[] = [];\n  // Mapping from line id -> list of beats in each of its roles\n  currentSVGElement: SVGSVGElement | null = null;\n  tableElement: HTMLTableElement;\n  markdownParser: (contents: string) => string;\n  _beatLayout: GlobalBeatLayout;\n\n  constructor(\n    public readonly rootElement: HTMLElement,\n    public readonly config?: any,\n  ) {\n    this.loadChildViews();\n  }\n\n  get beatLayout(): GlobalBeatLayout {\n    return this._beatLayout;\n  }\n\n  set beatLayout(beatLayout: GlobalBeatLayout) {\n    this._beatLayout = beatLayout;\n    beatLayout.gridLayoutGroup.getCellView = (cell) => this.viewForBeat(cell);\n  }\n\n  loadChildViews(): void {\n    this.tableElement = TSU.DOM.createNode(\"table\", {\n      parent: this.rootElement,\n      attrs: {\n        class: \"notationsContentRootTable\",\n      },\n    }) as HTMLTableElement;\n  }\n\n  renderNotation(notation: Notation, beatLayout: GlobalBeatLayout): void {\n    this.notation = notation;\n    this.beatLayout = beatLayout;\n    const startTime = performance.now();\n    this.refreshLayout();\n    const layoutTime = performance.now();\n    console.log(`V4 Document, Layout Time: ${layoutTime - startTime}ms`);\n  }\n\n  public addNewRow(id: string, prefix: string, withAnnotation = true): [HTMLElement, HTMLElement] {\n    const tr = TSU.DOM.createNode(\"tr\", {\n      parent: this.tableElement, // parent,\n      attrs: {\n        class: prefix + \"Row\",\n        id: prefix + \"Row\" + id,\n      },\n    });\n    let td1: HTMLElement | null = null;\n    if (withAnnotation) {\n      td1 = TSU.DOM.createNode(\"td\", {\n        parent: tr,\n        attrs: {\n          class: prefix + \"AnnotationCell\",\n          id: prefix + \"Annotation\" + id,\n        },\n      }) as HTMLElement;\n    }\n    const td2 = TSU.DOM.createNode(\"td\", {\n      parent: tr,\n      attrs: {\n        class: prefix + \"ContentCell\",\n        id: prefix + \"Content\" + id,\n        colspan: withAnnotation ? 1 : 2,\n      },\n    }) as HTMLElement;\n    return [td1!, td2];\n  }\n\n  public newLineRoot(parent: Element, line: Line): SVGSVGElement {\n    const [td1, td2] = this.addNewRow(line.uuid + \"\", \"line\");\n    // Hacky solution to \"line headings\"\n    if (line.marginText) {\n      td1.innerHTML = line.marginText;\n    }\n    return TSU.DOM.createSVGNode(\"svg\", {\n      parent: td2, // parent\n      attrs: {\n        style: \"margin-bottom: 10px\",\n        class: \"lineRootSVG\",\n      },\n    }) as SVGSVGElement;\n  }\n\n  ensureLineView(line: Line): LineView {\n    let lineView = this.getLineView(line);\n    if (lineView == null) {\n      const layoutParams = line.layoutParams || null;\n      const svgElem = this.newLineRoot(this.tableElement, line);\n      lineView = new LineView(svgElem, line, {\n        layoutParams: layoutParams,\n      } as any);\n      if (!line.isEmpty) {\n        // Probably because this is an empty line and AddAtoms was not called\n        TSU.assert(layoutParams != null, \"Layout params for a non empty line *should* exist\");\n        lineView.gridModel = this.beatLayout!.getGridModelForLine(line.uuid);\n      }\n      this.lineViews.push(lineView);\n    }\n    return lineView;\n  }\n\n  getLineView(line: Line): TSU.Nullable<LineView> {\n    return this.lineViews.find((l) => l.line == line) || null;\n  }\n\n  get currentLineView(): LineView {\n    return this.lineViews[this.lineViews.length - 1];\n  }\n\n  clear(): void {\n    this.lineViews = [];\n    // Mapping from line id -> list of beats in each of its roles\n    this.currentSVGElement = null;\n    this.tableElement.innerHTML = \"\";\n    this.beatViews = new Map<number, BeatView>();\n  }\n\n  /**\n   * Layout all the blocks in the Notation along with their corresponding blocks.\n   * Key thing is here is an opportunity to perform any batch rendering as needed.\n   */\n  refreshLayout(): void {\n    const lines = [] as Line[];\n    const lineViews = [] as LineView[];\n    for (const block of this.notation.blocks) {\n      if (block.TYPE == \"RawBlock\") {\n        // Add the markdown here\n        this.renderBlock(block as RawBlock);\n      } else {\n        lines.push(block as Line);\n        const lineView = this.ensureLineView(block as Line);\n        lineViews.push(lineView);\n      }\n    }\n\n    const now = performance.now();\n    for (const lineView of lineViews) {\n      lineView.gridModel.lastUpdatedAt = now;\n    }\n\n    this.beatLayout.gridLayoutGroup.refreshLayout();\n\n    for (const lineView of lineViews) {\n      lineView.wrapToSize();\n    }\n\n    // now that all spacing has been calculated\n    // go through all\n    // for (const beatView of this.beatViews.values()) { beatView.refreshLayout(); }\n  }\n\n  renderBlock(raw: RawBlock): void {\n    const [, td2] = this.addNewRow(raw.uuid + \"\", \"rawBlock\", false);\n    if (raw.contentType == \"metadata\") {\n      // we have a metadata block\n      const meta = this.notation.metadata.get(raw.content);\n      if (meta) {\n        // For now ignore metadata with \":\" in the key\n        if (meta.key.toLowerCase().indexOf(\":\") < 0) {\n          const div = td2.appendChild(TSU.DOM.createNode(\"div\"));\n          const html = `<span class = \"${meta.key.toLowerCase()}\"><strong>${meta.key}</strong>: ${meta.value}</span>`;\n          div.innerHTML = html;\n        }\n      }\n    } else {\n      const div = td2.appendChild(TSU.DOM.createNode(\"div\"));\n      div.innerHTML = this.markdownParser(raw.content.trim());\n    }\n    this.currentSVGElement = null;\n  }\n\n  beatViews = new Map<number, BeatView>();\n  markerViews = new Map<string, MarkerView>();\n  viewForBeat(cell: GridCell): GridCellView {\n    if (cell.colIndex % 3 == 1) {\n      // beat view needed\n      const beat = cell.value;\n      let curr = this.beatViews.get(beat.uuid) || null;\n      if (curr == null) {\n        const line = beat.role.line;\n        // how to get the bar and beat index for a given beat in a given row?\n        const lineView = this.ensureLineView(line);\n        const lp = line.layoutParams;\n        curr = new BeatView(cell, beat, lineView.gElem, lp.cycle);\n        this.beatViews.set(beat.uuid, curr);\n      }\n      return curr;\n    } else {\n      // markers view\n      const marker = cell.value;\n      const beat = marker.beat as Beat;\n      let curr = this.markerViews.get(\"pre:\" + beat.uuid) || null;\n      if (curr == null) {\n        const line = beat.role.line;\n        const lineView = this.ensureLineView(line);\n        const lp = line.layoutParams;\n        const isPreMarker = cell.colIndex % 3 == 0;\n        curr = new MarkerView(cell, beat, marker.markers, isPreMarker, lineView.gElem);\n        this.markerViews.set(\"pre:\" + beat.uuid, curr);\n      }\n      return curr;\n    }\n  }\n}\n"]}
+{"version":3,"file":"NotationView.js","sourceRoot":"","sources":["../../../src/carnatic/NotationView.ts"],"names":[],"mappings":"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","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\nimport { LineView } from \"./LineView\";\nimport { Notation, RawBlock, Block, BlockItem, isLine, isBlock, isRawBlock } from \"../notation\";\nimport { Beat, GlobalBeatLayout } from \"../beats\";\nimport { GridCell, GridCellView, GridLayoutGroup, LayoutChangeEvent } from \"../grids\";\nimport { Line } from \"../core\";\nimport { BeatView, MarkerView } from \"./beatviews\";\n\n/**\n * Configuration options for NotationView.\n */\nexport interface NotationViewConfig {\n  /**\n   * Optional shared GridLayoutGroup for column alignment across multiple NotationViews.\n   * When provided, this view will share column widths with other views using the same group.\n   */\n  sharedGridLayoutGroup?: GridLayoutGroup;\n\n  /**\n   * Optional markdown parser for RawBlock content.\n   */\n  markdownParser?: (contents: string) => string;\n}\n\nexport class NotationView {\n  headerElement: HTMLDivElement;\n  notation: Notation;\n  lineViews: LineView[] = [];\n  // Mapping from line id -> list of beats in each of its roles\n  currentSVGElement: SVGSVGElement | null = null;\n  tableElement: HTMLTableElement;\n  markdownParser: (contents: string) => string;\n  _beatLayout: GlobalBeatLayout;\n\n  /** Unsubscribe function for layout change listener */\n  private layoutChangeUnsubscribe: (() => void) | null = null;\n\n  constructor(\n    public readonly rootElement: HTMLElement,\n    public readonly config?: NotationViewConfig,\n  ) {\n    this.loadChildViews();\n    if (config?.markdownParser) {\n      this.markdownParser = config.markdownParser;\n    }\n  }\n\n  get beatLayout(): GlobalBeatLayout {\n    return this._beatLayout;\n  }\n\n  set beatLayout(beatLayout: GlobalBeatLayout) {\n    this._beatLayout = beatLayout;\n    beatLayout.gridLayoutGroup.getCellView = (cell) => this.viewForBeat(cell);\n  }\n\n  loadChildViews(): void {\n    this.tableElement = TSU.DOM.createNode(\"table\", {\n      parent: this.rootElement,\n      attrs: {\n        class: \"notationsContentRootTable\",\n      },\n    }) as HTMLTableElement;\n  }\n\n  renderNotation(notation: Notation, beatLayout: GlobalBeatLayout): void {\n    this.notation = notation;\n    this.beatLayout = beatLayout;\n    const startTime = performance.now();\n    this.refreshLayout();\n    const layoutTime = performance.now();\n    console.log(`V4 Document, Layout Time: ${layoutTime - startTime}ms`);\n  }\n\n  public addNewRow(id: string, prefix: string, withAnnotation = true): [HTMLElement, HTMLElement] {\n    const tr = TSU.DOM.createNode(\"tr\", {\n      parent: this.tableElement, // parent,\n      attrs: {\n        class: prefix + \"Row\",\n        id: prefix + \"Row\" + id,\n      },\n    });\n    let td1: HTMLElement | null = null;\n    if (withAnnotation) {\n      td1 = TSU.DOM.createNode(\"td\", {\n        parent: tr,\n        attrs: {\n          class: prefix + \"AnnotationCell\",\n          id: prefix + \"Annotation\" + id,\n        },\n      }) as HTMLElement;\n    }\n    const td2 = TSU.DOM.createNode(\"td\", {\n      parent: tr,\n      attrs: {\n        class: prefix + \"ContentCell\",\n        id: prefix + \"Content\" + id,\n        colspan: withAnnotation ? 1 : 2,\n      },\n    }) as HTMLElement;\n    return [td1!, td2];\n  }\n\n  public newLineRoot(parent: Element, line: Line): SVGSVGElement {\n    const [td1, td2] = this.addNewRow(line.uuid + \"\", \"line\");\n    // Hacky solution to \"line headings\"\n    if (line.marginText) {\n      td1.innerHTML = line.marginText;\n    }\n    return TSU.DOM.createSVGNode(\"svg\", {\n      parent: td2, // parent\n      attrs: {\n        style: \"margin-bottom: 10px\",\n        class: \"lineRootSVG\",\n      },\n    }) as SVGSVGElement;\n  }\n\n  ensureLineView(line: Line): LineView {\n    let lineView = this.getLineView(line);\n    if (lineView == null) {\n      const layoutParams = line.layoutParams || null;\n      const svgElem = this.newLineRoot(this.tableElement, line);\n      lineView = new LineView(svgElem, line, {\n        layoutParams: layoutParams,\n      } as any);\n      if (!line.isEmpty) {\n        // Probably because this is an empty line and AddAtoms was not called\n        TSU.assert(layoutParams != null, \"Layout params for a non empty line *should* exist\");\n        lineView.gridModel = this.beatLayout!.getGridModelForLine(line.uuid);\n      }\n      this.lineViews.push(lineView);\n    }\n    return lineView;\n  }\n\n  getLineView(line: Line): TSU.Nullable<LineView> {\n    return this.lineViews.find((l) => l.line == line) || null;\n  }\n\n  get currentLineView(): LineView {\n    return this.lineViews[this.lineViews.length - 1];\n  }\n\n  clear(): void {\n    this.lineViews = [];\n    // Mapping from line id -> list of beats in each of its roles\n    this.currentSVGElement = null;\n    this.tableElement.innerHTML = \"\";\n    this.beatViews = new Map<number, BeatView>();\n  }\n\n  /**\n   * Layout all the blocks in the Notation along with their corresponding blocks.\n   * Key thing is here is an opportunity to perform any batch rendering as needed.\n   */\n  refreshLayout(): void {\n    const lineViews = [] as LineView[];\n\n    // Recursively process the notation (which is a Block) and collect LineViews\n    this.processBlock(this.notation, lineViews);\n\n    const now = performance.now();\n    for (const lineView of lineViews) {\n      lineView.gridModel.lastUpdatedAt = now;\n    }\n\n    this.beatLayout.gridLayoutGroup.refreshLayout();\n\n    for (const lineView of lineViews) {\n      lineView.wrapToSize();\n    }\n  }\n\n  /**\n   * Recursively processes a block and its children for rendering.\n   * Uses block.children() to get expanded children (e.g., RepeatBlock expands to N copies).\n   *\n   * @param block The block to process\n   * @param lineViews Array to collect LineViews for batch layout\n   */\n  protected processBlock(block: Block, lineViews: LineView[]): void {\n    for (const child of block.children()) {\n      this.processBlockItem(child, lineViews);\n    }\n  }\n\n  /**\n   * Processes a single block item (Block, Line, or RawBlock) for rendering.\n   *\n   * @param item The item to process\n   * @param lineViews Array to collect LineViews for batch layout\n   */\n  protected processBlockItem(item: BlockItem, lineViews: LineView[]): void {\n    if (isRawBlock(item)) {\n      // Render raw content (markdown, metadata)\n      this.renderBlock(item as RawBlock);\n    } else if (isLine(item)) {\n      // Render line\n      const line = item as Line;\n      if (!line.isEmpty) {\n        const lineView = this.ensureLineView(line);\n        lineViews.push(lineView);\n      }\n    } else if (isBlock(item)) {\n      // Recursively process nested block\n      this.processBlock(item as Block, lineViews);\n    }\n  }\n\n  renderBlock(raw: RawBlock): void {\n    const [, td2] = this.addNewRow(raw.uuid + \"\", \"rawBlock\", false);\n    if (raw.contentType == \"metadata\") {\n      // we have a metadata block\n      const meta = this.notation.metadata.get(raw.content);\n      if (meta) {\n        // For now ignore metadata with \":\" in the key\n        if (meta.key.toLowerCase().indexOf(\":\") < 0) {\n          const div = td2.appendChild(TSU.DOM.createNode(\"div\"));\n          const html = `<span class = \"${meta.key.toLowerCase()}\"><strong>${meta.key}</strong>: ${meta.value}</span>`;\n          div.innerHTML = html;\n        }\n      }\n    } else {\n      const div = td2.appendChild(TSU.DOM.createNode(\"div\"));\n      div.innerHTML = this.markdownParser(raw.content.trim());\n    }\n    this.currentSVGElement = null;\n  }\n\n  beatViews = new Map<number, BeatView>();\n  markerViews = new Map<string, MarkerView>();\n  viewForBeat(cell: GridCell): GridCellView {\n    if (cell.colIndex % 3 == 1) {\n      // beat view needed\n      const beat = cell.value;\n      let curr = this.beatViews.get(beat.uuid) || null;\n      if (curr == null) {\n        const line = beat.role.line;\n        // how to get the bar and beat index for a given beat in a given row?\n        const lineView = this.ensureLineView(line);\n        const lp = line.layoutParams;\n        curr = new BeatView(cell, beat, lineView.gElem, lp.cycle);\n        this.beatViews.set(beat.uuid, curr);\n      }\n      return curr;\n    } else {\n      // markers view\n      const marker = cell.value;\n      const beat = marker.beat as Beat;\n      let curr = this.markerViews.get(\"pre:\" + beat.uuid) || null;\n      if (curr == null) {\n        const line = beat.role.line;\n        const lineView = this.ensureLineView(line);\n        const lp = line.layoutParams;\n        const isPreMarker = cell.colIndex % 3 == 0;\n        curr = new MarkerView(cell, beat, marker.markers, isPreMarker, lineView.gElem);\n        this.markerViews.set(\"pre:\" + beat.uuid, curr);\n      }\n      return curr;\n    }\n  }\n}\n"]}

package/lib/cjs/commands.d.ts

@@ -1,18 +1,18 @@
 import * as TSU from "@panyam/tsutils";
 import { Atom } from "./core";
-import { Command, Notation, MetaData as Meta } from "./notation";
+import { Command, MetaData as Meta, Block } from "./notation";
 export declare class RawEmbedding extends Command {
     get rawContents(): string;
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
 }
 export declare class MetaData extends Command {
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
     get meta(): Meta;
     get key(): string;
     get value(): string;
 }
 export declare class ActivateRole extends Command {
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
     get roleName(): string;
 }
 export declare class AddAtoms extends Command {
@@ -20,33 +20,47 @@ export declare class AddAtoms extends Command {
     atoms: Atom[];
     constructor(...atoms: Atom[]);
     debugValue(): any;
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
 }
 export declare class CreateLine extends Command {
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
     get offset(): TSU.Num.Fraction;
     get marginText(): string;
 }
 export declare class CreateRole extends Command {
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
     get notesOnly(): boolean;
 }
 export declare abstract class LayoutParamCommand extends Command {
 }
 export declare class ApplyLayout extends Command {
     validateParams(): void;
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
 }
 export declare class SetBreaks extends LayoutParamCommand {
     get pattern(): number[];
     validateParams(): void;
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
 }
 export declare class SetCycle extends LayoutParamCommand {
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
 }
 export declare class SetBeatDuration extends LayoutParamCommand {
     validateParams(): void;
     get beatDuration(): number;
-    applyToNotation(notation: Notation): void;
+    applyToBlock(container: Block): void;
+}
+export declare class Section extends Command {
+    get sectionName(): string;
+    validateParams(): void;
+    applyToBlock(_container: Block): void;
+}
+export declare class ScopedGroup extends Command {
+    get groupName(): string;
+    applyToBlock(_container: Block): void;
+}
+export declare class Repeat extends Command {
+    get count(): number;
+    validateParams(): void;
+    applyToBlock(_container: Block): void;
 }

package/lib/cjs/commands.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetBeatDuration = exports.SetCycle = exports.SetBreaks = exports.ApplyLayout = exports.LayoutParamCommand = exports.CreateRole = exports.CreateLine = exports.AddAtoms = exports.ActivateRole = exports.MetaData = exports.RawEmbedding = void 0;
+exports.Repeat = exports.ScopedGroup = exports.Section = exports.SetBeatDuration = exports.SetCycle = exports.SetBreaks = exports.ApplyLayout = exports.LayoutParamCommand = exports.CreateRole = exports.CreateLine = exports.AddAtoms = exports.ActivateRole = exports.MetaData = exports.RawEmbedding = void 0;
 const TSU = __importStar(require("@panyam/tsutils"));
 const utils_1 = require("./utils");
 const notation_1 = require("./notation");
@@ -41,15 +41,17 @@ class RawEmbedding extends notation_1.Command {
     get rawContents() {
         return this.getParamAt(0);
     }
-    applyToNotation(notation) {
+    applyToBlock(container) {
         const raw = new notation_1.RawBlock(this.rawContents);
-        notation.addRawBlock(raw);
+        container.addBlockItem(raw);
     }
 }
 exports.RawEmbedding = RawEmbedding;
 class MetaData extends notation_1.Command {
-    applyToNotation(notation) {
-        notation.addMetaData(this.meta);
+    applyToBlock(container) {
+        if (container instanceof notation_1.Notation) {
+            container.addMetaData(this.meta);
+        }
     }
     get meta() {
         const out = new notation_1.MetaData(this.key, this.value);
@@ -64,8 +66,8 @@ class MetaData extends notation_1.Command {
 }
 exports.MetaData = MetaData;
 class ActivateRole extends notation_1.Command {
-    applyToNotation(notation) {
-        notation.setCurrRole(this.roleName);
+    applyToBlock(container) {
+        container.setCurrRole(this.roleName);
     }
     get roleName() {
         return this.getParamAt(0);
@@ -85,26 +87,28 @@ class AddAtoms extends notation_1.Command {
             atoms: this.atoms.map((a) => a.debugValue()),
         };
     }
-    applyToNotation(notation) {
-        let roleDef = notation.currRoleDef;
+    applyToBlock(container) {
+        let roleDef = container.currRoleDef;
         if (roleDef == null) {
-            roleDef = notation.newRoleDef("Sw", true);
-        }
-        const lpForLine = notation.currentLine.layoutParams;
-        if (lpForLine == null) {
-            notation.currentLine.layoutParams = notation.layoutParams;
+            roleDef = container.newRoleDef("Sw", true);
         }
-        else {
-            TSU.assert(lpForLine == notation.layoutParams, "Layout parameters have changed so a new line should have been started");
+        const line = container.currentLine;
+        if (container instanceof notation_1.Notation) {
+            const lpForLine = line.layoutParams;
+            if (lpForLine == null) {
+                line.layoutParams = container.layoutParams;
+            }
+            else {
+                TSU.assert(lpForLine == container.layoutParams, "Layout parameters have changed so a new line should have been started");
+            }
         }
-        const finalised = this.atoms;
-        notation.currentLine.addAtoms(roleDef.name, roleDef.notesOnly, ...finalised);
+        line.addAtoms(roleDef.name, roleDef.notesOnly, ...this.atoms);
     }
 }
 exports.AddAtoms = AddAtoms;
 class CreateLine extends notation_1.Command {
-    applyToNotation(notation) {
-        const line = notation.newLine();
+    applyToBlock(container) {
+        const line = container.newLine();
         line.offset = this.offset;
         line.marginText = this.marginText;
     }
@@ -125,9 +129,9 @@ class CreateLine extends notation_1.Command {
 }
 exports.CreateLine = CreateLine;
 class CreateRole extends notation_1.Command {
-    applyToNotation(notation) {
+    applyToBlock(container) {
         const name = this.getParamAt(0);
-        notation.newRoleDef(name, this.notesOnly);
+        container.newRoleDef(name, this.notesOnly);
     }
     get notesOnly() {
         const notesOnly = this.getParam("notes");
@@ -144,9 +148,11 @@ class ApplyLayout extends notation_1.Command {
             throw new Error("layout command must contain one string argument");
         }
     }
-    applyToNotation(notation) {
-        const value = this.params[0].value;
-        notation.ensureNamedLayoutParams(value);
+    applyToBlock(container) {
+        if (container instanceof notation_1.Notation) {
+            const value = this.params[0].value;
+            container.ensureNamedLayoutParams(value);
+        }
     }
 }
 exports.ApplyLayout = ApplyLayout;
@@ -164,18 +170,22 @@ class SetBreaks extends LayoutParamCommand {
             }
         }
     }
-    applyToNotation(notation) {
-        notation.currentBreaks = this.pattern;
-        notation.resetLayoutParams();
+    applyToBlock(container) {
+        container.localBreaks = this.pattern;
+        if (container instanceof notation_1.Notation) {
+            container.resetLayoutParams();
+        }
     }
 }
 exports.SetBreaks = SetBreaks;
 class SetCycle extends LayoutParamCommand {
-    applyToNotation(notation) {
+    applyToBlock(container) {
         const value = this.params[0].value;
         const cycle = (0, utils_1.parseCycle)(value);
-        notation.currentCycle = cycle;
-        notation.resetLayoutParams();
+        container.localCycle = cycle;
+        if (container instanceof notation_1.Notation) {
+            container.resetLayoutParams();
+        }
     }
 }
 exports.SetCycle = SetCycle;
@@ -188,10 +198,53 @@ class SetBeatDuration extends LayoutParamCommand {
     get beatDuration() {
         return this.params[0].value;
     }
-    applyToNotation(notation) {
-        notation.currentAPB = this.beatDuration;
-        notation.resetLayoutParams();
+    applyToBlock(container) {
+        container.localAtomsPerBeat = this.beatDuration;
+        if (container instanceof notation_1.Notation) {
+            container.resetLayoutParams();
+        }
     }
 }
 exports.SetBeatDuration = SetBeatDuration;
+class Section extends notation_1.Command {
+    get sectionName() {
+        return this.getParamAt(0) || "";
+    }
+    validateParams() {
+        if (this.params.length < 1 || typeof this.params[0].value !== "string") {
+            throw new Error("section command must contain a string name");
+        }
+    }
+    applyToBlock(_container) {
+    }
+}
+exports.Section = Section;
+class ScopedGroup extends notation_1.Command {
+    get groupName() {
+        return this.getParamAt(0) || "";
+    }
+    applyToBlock(_container) {
+    }
+}
+exports.ScopedGroup = ScopedGroup;
+class Repeat extends notation_1.Command {
+    get count() {
+        const count = this.getParamAt(0);
+        if (typeof count === "number") {
+            return count;
+        }
+        return 0;
+    }
+    validateParams() {
+        if (this.params.length > 0) {
+            const count = this.params[0].value;
+            if (typeof count !== "number" || count < 0) {
+                throw new Error("repeat command count must be a non-negative number");
+            }
+        }
+    }
+    applyToBlock(_container) {
+    }
+}
+exports.Repeat = Repeat;
 //# sourceMappingURL=commands.js.map

package/lib/cjs/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"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","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\nimport { Atom } from \"./core\";\nimport { parseCycle } from \"./utils\";\nimport { Command, RawBlock, Notation, MetaData as Meta } from \"./notation\";\n\n/**\n * Command for embedding raw content in the notation.\n * This allows including arbitrary raw text blocks (like markdown or HTML) within the notation.\n */\nexport class RawEmbedding extends Command {\n  /**\n   * Gets the raw content of this embedding.\n   */\n  get rawContents(): string {\n    return this.getParamAt(0);\n  }\n\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    const raw = new RawBlock(this.rawContents);\n    notation.addRawBlock(raw);\n  }\n}\n\n/**\n * Command for adding metadata to the notation.\n */\nexport class MetaData extends Command {\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    // Create the role - ensure that we have a role\n    notation.addMetaData(this.meta);\n  }\n\n  /**\n   * Gets the metadata object for this command.\n   */\n  get meta(): Meta {\n    const out = new Meta(this.key, this.value);\n    return out;\n  }\n\n  /**\n   * Gets the key for this metadata.\n   */\n  get key(): string {\n    return this.getParamAt(0);\n  }\n\n  /**\n   * Gets the value for this metadata.\n   */\n  get value(): string {\n    return this.getParamAt(1);\n  }\n}\n\n/**\n * Command for activating (selecting) a specific role.\n */\nexport class ActivateRole extends Command {\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    // Create the role - ensure that we have a role\n    notation.setCurrRole(this.roleName);\n    // const line = notation.ensureLine();\n  }\n\n  /**\n   * Gets the name of the role to activate.\n   */\n  get roleName(): string {\n    return this.getParamAt(0);\n  }\n}\n\n/**\n * Command for adding atoms to the current role.\n */\nexport class AddAtoms extends Command {\n  /** Index of this command in the sequence */\n  index: number;\n  /** Atoms to add */\n  atoms: Atom[];\n\n  /**\n   * Creates a new AddAtoms command.\n   * @param atoms Atoms to add\n   */\n  constructor(...atoms: Atom[]) {\n    super();\n    this.atoms = atoms;\n    this.index = 0;\n  }\n\n  /**\n   * Returns a debug-friendly representation of this command.\n   * @returns An object containing debug information\n   */\n  debugValue(): any {\n    return {\n      name: this.name,\n      index: this.index,\n      atoms: this.atoms.map((a) => a.debugValue()),\n    };\n  }\n\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    let roleDef = notation.currRoleDef;\n    if (roleDef == null) {\n      // By default create a role for swaras\n      roleDef = notation.newRoleDef(\"Sw\", true);\n      // throw new Error(\"Current role is invalid\");\n    }\n    // Ensure a line exists\n    const lpForLine = notation.currentLine.layoutParams;\n    if (lpForLine == null) {\n      notation.currentLine.layoutParams = notation.layoutParams;\n    } else {\n      TSU.assert(\n        lpForLine == notation.layoutParams,\n        \"Layout parameters have changed so a new line should have been started\",\n      );\n    }\n    const finalised = this.atoms;\n    notation.currentLine.addAtoms(roleDef.name, roleDef.notesOnly, ...finalised);\n  }\n}\n\n/**\n * Command for creating a new line in the notation.\n */\nexport class CreateLine extends Command {\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    // We are not calling a newLine here just to avoid\n    // a series of \\line commands creating wasteful empty lines\n    // TODO - how do we consider offsets in line create\n    const line = notation.newLine();\n    line.offset = this.offset;\n    line.marginText = this.marginText;\n  }\n\n  /**\n   * Gets the offset for the new line.\n   */\n  get offset(): TSU.Num.Fraction {\n    let offset = this.getParam(\"offset\") || TSU.Num.Fraction.ZERO;\n    if (typeof offset === \"number\") offset = new TSU.Num.Fraction(offset);\n    return offset;\n  }\n\n  /**\n   * Gets the margin text for the new line.\n   */\n  get marginText(): string {\n    if (this.params.length > 0) {\n      if (this.params[0].key == null && typeof this.params[0].value === \"string\") {\n        return this.params[0].value.trim();\n      }\n    }\n    return this.getParam(\"marginText\") || \"\";\n  }\n}\n\n/**\n * Command for creating a new role in the notation.\n */\nexport class CreateRole extends Command {\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    // Create the role\n    const name = this.getParamAt(0);\n    notation.newRoleDef(name, this.notesOnly);\n  }\n\n  /**\n   * Gets whether this role should contain only notes (true) or also syllables/text (false).\n   */\n  get notesOnly(): boolean {\n    const notesOnly = this.getParam(\"notes\");\n    return notesOnly == \"true\" || notesOnly == \"yes\" || notesOnly == true;\n  }\n}\n\n/**\n * Base class for commands that modify layout parameters.\n */\nexport abstract class LayoutParamCommand extends Command {}\n\n/**\n * Command for applying a named layout to the notation.\n *\n * Saves the current layout with the given name.\n * Typically users can change layout params (currently cycle, APB and line layout)\n * with the \\cycle, \\layout and \\beatDuration commands. Each time these are\n * changed, the current layout params is set to null. So the next time layout\n * params are needed we look at saved layout params and search by the unique\n * combination of cycle, apb and line layout. This prevents users from creating\n * too many layouts with the same config. Each layout is associated with an\n * AtomLayout instance.\n *\n * For example consider this:\n *\n * \\apb(4)\n * \\breaks(4)\n * \\cycle(\"|4|2|2|\")\n * \\apb(5)\n * \\breaks(3)\n *\n * In all these cases LayoutParams are *not* created.  Instead they are reset to null.\n *\n *\n * When we do an AddAtoms command, this is where a LineView is created and along with this\n * a layoutParams is created taking the latest state of the layout params resulting an\n * LP (instance id = 1) of (layout = 3, cycle = \"4|2|2\", apb = 5)\n *\n * Now after this say we had the following commands:\n *\n * \\cycle(x)\n * \\cycle(|4|2|2)\n * \\apb(10)\n * \\apb(5)\n *\n * Sw: a b c\n *\n * Here again since the LP was set to null, \"creating\" layout params results in returning\n * the LP created previously (at the end of these commands the cycle, apb and layout params\n * are the same).\n *\n * eg doing\n *\n * \\layout(\"layout1\")\n *\n * This ensures that a *new* LP instance is created (even if another one exists with the same\n * apb, cycle, layout combo).  This allows us to group different sectiosn that are identical\n * in layout but to be processed by different atom layouts.\n *\n * To use a saved layout simply do:\n *\n * \\layout(\"layout\")\n *\n * Note the use and saving commands are same - as we cannot override existing\n * layouts so referring to it the first time creates and saves it too\n */\nexport class ApplyLayout extends Command {\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length != 1 || typeof this.params[0].value !== \"string\") {\n      throw new Error(\"layout command must contain one string argument\");\n    }\n  }\n\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    const value = this.params[0].value;\n    notation.ensureNamedLayoutParams(value);\n  }\n}\n\n/**\n * Command for setting line breaks in the layout.\n */\nexport class SetBreaks extends LayoutParamCommand {\n  /**\n   * Gets the line breaks pattern.\n   */\n  get pattern(): number[] {\n    return this.params.map((cmd) => cmd.value as number);\n  }\n\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    for (const param of this.params) {\n      if (param.key != null) {\n        throw new Error(\"Breaks command cannot have keyword params\");\n      }\n      if (typeof param.value !== \"number\") {\n        throw new Error(\"Breaks command must be a list of integers\");\n      }\n    }\n  }\n\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    notation.currentBreaks = this.pattern;\n    notation.resetLayoutParams();\n  }\n}\n\n/**\n * Command for setting the cycle pattern in the layout.\n */\nexport class SetCycle extends LayoutParamCommand {\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    const value = this.params[0].value;\n    // TODO - move the parsing to validation\n    const cycle = parseCycle(value);\n    notation.currentCycle = cycle;\n    notation.resetLayoutParams();\n  }\n}\n\n/**\n * Command for setting the beat duration in the layout.\n */\nexport class SetBeatDuration extends LayoutParamCommand {\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length != 1 || typeof this.params[0].value !== \"number\") {\n      throw new Error(\"beatDuration command must contain one number\");\n    }\n  }\n\n  /**\n   * Gets the beat duration value.\n   */\n  get beatDuration(): number {\n    return this.params[0].value;\n  }\n\n  /**\n   * Applies this command to a notation.\n   * @param notation The notation to apply this command to\n   */\n  applyToNotation(notation: Notation): void {\n    notation.currentAPB = this.beatDuration;\n    notation.resetLayoutParams();\n  }\n}\n"]}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAuC;AAEvC,mCAAqC;AACrC,yCAA6F;AAM7F,MAAa,YAAa,SAAQ,kBAAO;IAIvC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAMD,YAAY,CAAC,SAAgB;QAC3B,MAAM,GAAG,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF;AAhBD,oCAgBC;AAKD,MAAa,QAAS,SAAQ,kBAAO;IAKnC,YAAY,CAAC,SAAgB;QAC3B,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IAEH,CAAC;IAKD,IAAI,IAAI;QACN,MAAM,GAAG,GAAG,IAAI,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IAKD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAKD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF;AAjCD,4BAiCC;AAKD,MAAa,YAAa,SAAQ,kBAAO;IAKvC,YAAY,CAAC,SAAgB;QAC3B,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAKD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF;AAfD,oCAeC;AAKD,MAAa,QAAS,SAAQ,kBAAO;IAUnC,YAAY,GAAG,KAAa;QAC1B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAMD,UAAU;QACR,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;SAC7C,CAAC;IACJ,CAAC;IAMD,YAAY,CAAC,SAAgB;QAC3B,IAAI,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC;QACpC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAEpB,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC;QAEnC,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC;YACpC,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CACR,SAAS,IAAI,SAAS,CAAC,YAAY,EACnC,uEAAuE,CACxE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;CACF;AAvDD,4BAuDC;AAKD,MAAa,UAAW,SAAQ,kBAAO;IAKrC,YAAY,CAAC,SAAgB;QAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;IAKD,IAAI,MAAM;QACR,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IAKD,IAAI,UAAU;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AA/BD,gCA+BC;AAKD,MAAa,UAAW,SAAQ,kBAAO;IAKrC,YAAY,CAAC,SAAgB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAKD,IAAI,SAAS;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,IAAI,IAAI,CAAC;IACxE,CAAC;CACF;AAjBD,gCAiBC;AAKD,MAAsB,kBAAmB,SAAQ,kBAAO;CAAG;AAA3D,gDAA2D;AAyD3D,MAAa,WAAY,SAAQ,kBAAO;IAKtC,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAMD,YAAY,CAAC,SAAgB;QAC3B,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACnC,SAAS,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;IAEH,CAAC;CACF;AAtBD,kCAsBC;AAKD,MAAa,SAAU,SAAQ,kBAAkB;IAI/C,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;IACvD,CAAC;IAMD,cAAc;QACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAMD,YAAY,CAAC,SAAgB;QAC3B,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;QACrC,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAjCD,8BAiCC;AAKD,MAAa,QAAS,SAAQ,kBAAkB;IAK9C,YAAY,CAAC,SAAgB;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEnC,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC;QAChC,SAAS,CAAC,UAAU,GAAG,KAAK,CAAC;QAC7B,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAdD,4BAcC;AAKD,MAAa,eAAgB,SAAQ,kBAAkB;IAKrD,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAKD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC;IAMD,YAAY,CAAC,SAAgB;QAC3B,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC;QAChD,IAAI,SAAS,YAAY,mBAAQ,EAAE,CAAC;YAClC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AA5BD,0CA4BC;AAQD,MAAa,OAAQ,SAAQ,kBAAO;IAIlC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAMD,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAMD,YAAY,CAAC,UAAiB;IAE9B,CAAC;CACF;AAzBD,0BAyBC;AAQD,MAAa,WAAY,SAAQ,kBAAO;IAItC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAMD,YAAY,CAAC,UAAiB;IAE9B,CAAC;CACF;AAfD,kCAeC;AAQD,MAAa,MAAO,SAAQ,kBAAO;IAKjC,IAAI,KAAK;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAMD,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAMD,YAAY,CAAC,UAAiB;IAE9B,CAAC;CACF;AAjCD,wBAiCC","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\nimport { Atom } from \"./core\";\nimport { parseCycle } from \"./utils\";\nimport { Command, RawBlock, Notation, MetaData as Meta, BlockItem, Block } from \"./notation\";\n\n/**\n * Command for embedding raw content in the notation.\n * This allows including arbitrary raw text blocks (like markdown or HTML) within the notation.\n */\nexport class RawEmbedding extends Command {\n  /**\n   * Gets the raw content of this embedding.\n   */\n  get rawContents(): string {\n    return this.getParamAt(0);\n  }\n\n  /**\n   * Applies this command to a block.\n   * Adds a raw block to the container.\n   */\n  applyToBlock(container: Block): void {\n    const raw = new RawBlock(this.rawContents);\n    container.addBlockItem(raw);\n  }\n}\n\n/**\n * Command for adding metadata to the notation.\n */\nexport class MetaData extends Command {\n  /**\n   * Applies this command to a block.\n   * Only works on Notation (metadata is a Notation-specific feature).\n   */\n  applyToBlock(container: Block): void {\n    if (container instanceof Notation) {\n      container.addMetaData(this.meta);\n    }\n    // No-op for non-Notation blocks\n  }\n\n  /**\n   * Gets the metadata object for this command.\n   */\n  get meta(): Meta {\n    const out = new Meta(this.key, this.value);\n    return out;\n  }\n\n  /**\n   * Gets the key for this metadata.\n   */\n  get key(): string {\n    return this.getParamAt(0);\n  }\n\n  /**\n   * Gets the value for this metadata.\n   */\n  get value(): string {\n    return this.getParamAt(1);\n  }\n}\n\n/**\n * Command for activating (selecting) a specific role.\n */\nexport class ActivateRole extends Command {\n  /**\n   * Applies this command to a block.\n   * Sets the current role in the container.\n   */\n  applyToBlock(container: Block): void {\n    container.setCurrRole(this.roleName);\n  }\n\n  /**\n   * Gets the name of the role to activate.\n   */\n  get roleName(): string {\n    return this.getParamAt(0);\n  }\n}\n\n/**\n * Command for adding atoms to the current role.\n */\nexport class AddAtoms extends Command {\n  /** Index of this command in the sequence */\n  index: number;\n  /** Atoms to add */\n  atoms: Atom[];\n\n  /**\n   * Creates a new AddAtoms command.\n   * @param atoms Atoms to add\n   */\n  constructor(...atoms: Atom[]) {\n    super();\n    this.atoms = atoms;\n    this.index = 0;\n  }\n\n  /**\n   * Returns a debug-friendly representation of this command.\n   * @returns An object containing debug information\n   */\n  debugValue(): any {\n    return {\n      name: this.name,\n      index: this.index,\n      atoms: this.atoms.map((a) => a.debugValue()),\n    };\n  }\n\n  /**\n   * Applies this command to a block.\n   * Adds atoms to the current line in the container.\n   */\n  applyToBlock(container: Block): void {\n    let roleDef = container.currRoleDef;\n    if (roleDef == null) {\n      // By default create a role for swaras\n      roleDef = container.newRoleDef(\"Sw\", true);\n    }\n    // Get or create the current line\n    const line = container.currentLine;\n    // For Notation, also handle layoutParams\n    if (container instanceof Notation) {\n      const lpForLine = line.layoutParams;\n      if (lpForLine == null) {\n        line.layoutParams = container.layoutParams;\n      } else {\n        TSU.assert(\n          lpForLine == container.layoutParams,\n          \"Layout parameters have changed so a new line should have been started\",\n        );\n      }\n    }\n    // Add atoms to the line\n    line.addAtoms(roleDef.name, roleDef.notesOnly, ...this.atoms);\n  }\n}\n\n/**\n * Command for creating a new line in the notation.\n */\nexport class CreateLine extends Command {\n  /**\n   * Applies this command to a block.\n   * Creates a new line in the container.\n   */\n  applyToBlock(container: Block): void {\n    const line = container.newLine();\n    line.offset = this.offset;\n    line.marginText = this.marginText;\n  }\n\n  /**\n   * Gets the offset for the new line.\n   */\n  get offset(): TSU.Num.Fraction {\n    let offset = this.getParam(\"offset\") || TSU.Num.Fraction.ZERO;\n    if (typeof offset === \"number\") offset = new TSU.Num.Fraction(offset);\n    return offset;\n  }\n\n  /**\n   * Gets the margin text for the new line.\n   */\n  get marginText(): string {\n    if (this.params.length > 0) {\n      if (this.params[0].key == null && typeof this.params[0].value === \"string\") {\n        return this.params[0].value.trim();\n      }\n    }\n    return this.getParam(\"marginText\") || \"\";\n  }\n}\n\n/**\n * Command for creating a new role in the notation.\n */\nexport class CreateRole extends Command {\n  /**\n   * Applies this command to a block.\n   * Creates a role definition local to the container.\n   */\n  applyToBlock(container: Block): void {\n    const name = this.getParamAt(0);\n    container.newRoleDef(name, this.notesOnly);\n  }\n\n  /**\n   * Gets whether this role should contain only notes (true) or also syllables/text (false).\n   */\n  get notesOnly(): boolean {\n    const notesOnly = this.getParam(\"notes\");\n    return notesOnly == \"true\" || notesOnly == \"yes\" || notesOnly == true;\n  }\n}\n\n/**\n * Base class for commands that modify layout parameters.\n */\nexport abstract class LayoutParamCommand extends Command {}\n\n/**\n * Command for applying a named layout to the notation.\n *\n * Saves the current layout with the given name.\n * Typically users can change layout params (currently cycle, APB and line layout)\n * with the \\cycle, \\layout and \\beatDuration commands. Each time these are\n * changed, the current layout params is set to null. So the next time layout\n * params are needed we look at saved layout params and search by the unique\n * combination of cycle, apb and line layout. This prevents users from creating\n * too many layouts with the same config. Each layout is associated with an\n * AtomLayout instance.\n *\n * For example consider this:\n *\n * \\apb(4)\n * \\breaks(4)\n * \\cycle(\"|4|2|2|\")\n * \\apb(5)\n * \\breaks(3)\n *\n * In all these cases LayoutParams are *not* created.  Instead they are reset to null.\n *\n *\n * When we do an AddAtoms command, this is where a LineView is created and along with this\n * a layoutParams is created taking the latest state of the layout params resulting an\n * LP (instance id = 1) of (layout = 3, cycle = \"4|2|2\", apb = 5)\n *\n * Now after this say we had the following commands:\n *\n * \\cycle(x)\n * \\cycle(|4|2|2)\n * \\apb(10)\n * \\apb(5)\n *\n * Sw: a b c\n *\n * Here again since the LP was set to null, \"creating\" layout params results in returning\n * the LP created previously (at the end of these commands the cycle, apb and layout params\n * are the same).\n *\n * eg doing\n *\n * \\layout(\"layout1\")\n *\n * This ensures that a *new* LP instance is created (even if another one exists with the same\n * apb, cycle, layout combo).  This allows us to group different sectiosn that are identical\n * in layout but to be processed by different atom layouts.\n *\n * To use a saved layout simply do:\n *\n * \\layout(\"layout\")\n *\n * Note the use and saving commands are same - as we cannot override existing\n * layouts so referring to it the first time creates and saves it too\n */\nexport class ApplyLayout extends Command {\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length != 1 || typeof this.params[0].value !== \"string\") {\n      throw new Error(\"layout command must contain one string argument\");\n    }\n  }\n\n  /**\n   * Applies this command to a block.\n   * Named layouts are Notation-specific; no-op for other blocks.\n   */\n  applyToBlock(container: Block): void {\n    if (container instanceof Notation) {\n      const value = this.params[0].value;\n      container.ensureNamedLayoutParams(value);\n    }\n    // No-op for non-Notation blocks (named layouts are Notation-specific)\n  }\n}\n\n/**\n * Command for setting line breaks in the layout.\n */\nexport class SetBreaks extends LayoutParamCommand {\n  /**\n   * Gets the line breaks pattern.\n   */\n  get pattern(): number[] {\n    return this.params.map((cmd) => cmd.value as number);\n  }\n\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    for (const param of this.params) {\n      if (param.key != null) {\n        throw new Error(\"Breaks command cannot have keyword params\");\n      }\n      if (typeof param.value !== \"number\") {\n        throw new Error(\"Breaks command must be a list of integers\");\n      }\n    }\n  }\n\n  /**\n   * Applies this command to a block.\n   * Sets the local breaks on the container.\n   */\n  applyToBlock(container: Block): void {\n    container.localBreaks = this.pattern;\n    if (container instanceof Notation) {\n      container.resetLayoutParams();\n    }\n  }\n}\n\n/**\n * Command for setting the cycle pattern in the layout.\n */\nexport class SetCycle extends LayoutParamCommand {\n  /**\n   * Applies this command to a block.\n   * Sets the local cycle on the container.\n   */\n  applyToBlock(container: Block): void {\n    const value = this.params[0].value;\n    // TODO - move the parsing to validation\n    const cycle = parseCycle(value);\n    container.localCycle = cycle;\n    if (container instanceof Notation) {\n      container.resetLayoutParams();\n    }\n  }\n}\n\n/**\n * Command for setting the beat duration in the layout.\n */\nexport class SetBeatDuration extends LayoutParamCommand {\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length != 1 || typeof this.params[0].value !== \"number\") {\n      throw new Error(\"beatDuration command must contain one number\");\n    }\n  }\n\n  /**\n   * Gets the beat duration value.\n   */\n  get beatDuration(): number {\n    return this.params[0].value;\n  }\n\n  /**\n   * Applies this command to a block.\n   * Sets the local atoms per beat on the container.\n   */\n  applyToBlock(container: Block): void {\n    container.localAtomsPerBeat = this.beatDuration;\n    if (container instanceof Notation) {\n      container.resetLayoutParams();\n    }\n  }\n}\n\n/**\n * Command for creating a named section in the notation.\n * Sections are organizational blocks with a name that can be displayed as headers.\n *\n * Usage: \\section(\"Pallavi\") { ... }\n */\nexport class Section extends Command {\n  /**\n   * Gets the name of the section.\n   */\n  get sectionName(): string {\n    return this.getParamAt(0) || \"\";\n  }\n\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length < 1 || typeof this.params[0].value !== \"string\") {\n      throw new Error(\"section command must contain a string name\");\n    }\n  }\n\n  /**\n   * Applies this command to a block.\n   * No-op: SectionBlock handles the section behavior.\n   */\n  applyToBlock(_container: Block): void {\n    // SectionBlock handles section semantics\n  }\n}\n\n/**\n * Command for creating a grouping/scope block without specific semantics.\n * Groups are useful for visually organizing notation or applying shared properties.\n *\n * Usage: \\group(\"optional-name\") { ... }\n */\nexport class ScopedGroup extends Command {\n  /**\n   * Gets the optional name of the group.\n   */\n  get groupName(): string {\n    return this.getParamAt(0) || \"\";\n  }\n\n  /**\n   * Applies this command to a block.\n   * No additional properties to set for basic groups.\n   */\n  applyToBlock(_container: Block): void {\n    // No additional properties\n  }\n}\n\n/**\n * Command for creating a repeated section in the notation.\n * Repeats can specify a count for how many times the content should repeat.\n *\n * Usage: \\repeat(2) { ... } or \\repeat() { ... } for visual repeat markers\n */\nexport class Repeat extends Command {\n  /**\n   * Gets the number of times to repeat.\n   * Returns 0 if not specified (meaning visual repeat markers only).\n   */\n  get count(): number {\n    const count = this.getParamAt(0);\n    if (typeof count === \"number\") {\n      return count;\n    }\n    return 0;\n  }\n\n  /**\n   * Validates the parameters for this command.\n   * @throws Error if parameters are invalid\n   */\n  validateParams(): void {\n    if (this.params.length > 0) {\n      const count = this.params[0].value;\n      if (typeof count !== \"number\" || count < 0) {\n        throw new Error(\"repeat command count must be a non-negative number\");\n      }\n    }\n  }\n\n  /**\n   * Applies this command to a block.\n   * No-op: RepeatBlock handles the repeat behavior.\n   */\n  applyToBlock(_container: Block): void {\n    // RepeatBlock handles repeat semantics\n  }\n}\n"]}

package/lib/cjs/entity.d.ts

@@ -3,15 +3,11 @@ export declare class Entity {
     readonly TYPE: string;
     private static counter;
     readonly uuid: number;
+    protected _parent: TSU.Nullable<Entity>;
     constructor(config?: any);
+    get parent(): TSU.Nullable<Entity>;
+    setParent(parent: TSU.Nullable<Entity>): void;
     debugValue(): any;
-    children(): Entity[];
-    get childCount(): number;
-    addChild(child: Entity, index?: number): this;
-    childAt(index: number): Entity;
-    indexOfChild(entity: Entity): number;
-    removeChildAt(index: number): Entity;
-    setChildAt(index: number, entity: Entity): this;
     toString(): string;
     equals(another: this, expect?: boolean): boolean;
     clone(): this;

package/lib/cjs/entity.js

@@ -5,49 +5,19 @@ class Entity {
     constructor(config = null) {
         this.TYPE = "Entity";
         this.uuid = Entity.counter++;
+        this._parent = null;
         config = config || {};
         if (config.metadata)
             throw new Error("See where metadata is being passed");
     }
-    debugValue() {
-        return { type: this.TYPE };
-    }
-    children() {
-        return [];
-    }
-    get childCount() {
-        return this.children().length;
-    }
-    addChild(child, index = -1) {
-        if (index < 0) {
-            this.children().push(child);
-        }
-        else {
-            this.children().splice(index, 0, child);
-        }
-        return this;
+    get parent() {
+        return this._parent;
     }
-    childAt(index) {
-        return this.children()[index];
+    setParent(parent) {
+        this._parent = parent;
     }
-    indexOfChild(entity) {
-        let i = 0;
-        for (const child of this.children()) {
-            if (child == entity)
-                return i;
-            i++;
-        }
-        return -1;
-    }
-    removeChildAt(index) {
-        const children = this.children();
-        const out = children[index];
-        children.splice(index, 1);
-        return out;
-    }
-    setChildAt(index, entity) {
-        this.children()[index] = entity;
-        return this;
+    debugValue() {
+        return { type: this.TYPE };
     }
     toString() {
         return `Entity(id = ${this.uuid})`;

package/lib/cjs/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/entity.ts"],"names":[],"mappings":";;;AAMA,MAAa,MAAM;IAcjB,YAAY,SAAc,IAAI;QAbrB,SAAI,GAAW,QAAQ,CAAC;QAKxB,SAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAS/B,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAE7E,CAAC;IAOD,UAAU;QAER,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAMD,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAKD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAChC,CAAC;IAQD,QAAQ,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAOD,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAOD,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpC,IAAI,KAAK,IAAI,MAAM;gBAAE,OAAO,CAAC,CAAC;YAC9B,CAAC,EAAE,CAAC;QACN,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAOD,aAAa,CAAC,KAAa;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAQD,UAAU,CAAC,KAAa,EAAE,MAAc;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAuBD,QAAQ;QACN,OAAO,eAAe,IAAI,CAAC,IAAI,GAAG,CAAC;IACrC,CAAC;IAQD,MAAM,CAAC,OAAa,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAE5C,OAAO,IAAI,CAAC;IACd,CAAC;IAUD,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC;IAMD,MAAM,CAAC,OAAa;IAEpB,CAAC;IAMS,WAAW;QACnB,OAAO,IAAK,IAAI,CAAC,WAAmB,EAAE,CAAC;IACzC,CAAC;;AA3KH,wBA4KC;AAxKgB,cAAO,GAAG,CAAC,AAAJ,CAAK;AA8K7B,MAAsB,WAAY,SAAQ,MAAM;IAAhD;;QACW,SAAI,GAAW,aAAa,CAAC;IAgBxC,CAAC;IAHC,MAAM,CAAC,OAAa;QAClB,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;CACF;AAjBD,kCAiBC","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\n\n/**\n * A common Entity base class with support for unique IDs, copying, children and\n * debug info. This serves as the foundation for all entities in the notation system.\n */\nexport class Entity {\n  readonly TYPE: string = \"Entity\";\n\n  // readonly TYPE:string = \"Entity\";\n  private static counter = 0;\n  /** Unique identifier for this entity */\n  readonly uuid = Entity.counter++;\n  // private metadata: TSU.StringMap<any>;\n  // parent: TSU.Nullable<Entity> = null;\n\n  /**\n   * Creates a new Entity.\n   * @param config Optional configuration object\n   */\n  constructor(config: any = null) {\n    config = config || {};\n    if (config.metadata) throw new Error(\"See where metadata is being passed\");\n    // this.metadata = config.metadata || {};\n  }\n\n  /**\n   * Returns a debug-friendly representation of this entity.\n   * Usually overridden by children to add more debug info.\n   * @returns An object containing debug information\n   */\n  debugValue(): any {\n    // if (Object.keys(this.metadata).length > 0) return { metadata: this.metadata, type: this.type };\n    return { type: this.TYPE };\n  }\n\n  /**\n   * Gets all child entities of this entity.\n   * @returns An array of child entities\n   */\n  children(): Entity[] {\n    return [];\n  }\n\n  /**\n   * Gets the count of child entities.\n   */\n  get childCount(): number {\n    return this.children().length;\n  }\n\n  /**\n   * Adds a child entity at a given index.\n   * @param child Child entity to be added\n   * @param index Index where the child is to be inserted, -1 to append at the end\n   * @returns This entity instance for method chaining\n   */\n  addChild(child: Entity, index = -1): this {\n    if (index < 0) {\n      this.children().push(child);\n    } else {\n      this.children().splice(index, 0, child);\n    }\n    return this;\n  }\n\n  /**\n   * Returns the child at a given index.\n   * @param index The index of the child to retrieve\n   * @returns The child entity at the specified index\n   */\n  childAt(index: number): Entity {\n    return this.children()[index];\n  }\n\n  /**\n   * Returns the index of a given child entity.\n   * @param entity The child entity to find\n   * @returns The index where the child exists, or -1 if not found\n   */\n  indexOfChild(entity: Entity): number {\n    let i = 0;\n    for (const child of this.children()) {\n      if (child == entity) return i;\n      i++;\n    }\n    return -1;\n  }\n\n  /**\n   * Removes and returns the child entity at the specified index.\n   * @param index The index of the child to remove\n   * @returns The removed child entity\n   */\n  removeChildAt(index: number): Entity {\n    const children = this.children();\n    const out = children[index];\n    children.splice(index, 1);\n    return out;\n  }\n\n  /**\n   * Sets a child entity at the specified index.\n   * @param index The index where to set the child\n   * @param entity The entity to set at the index\n   * @returns This entity instance for method chaining\n   */\n  setChildAt(index: number, entity: Entity): this {\n    this.children()[index] = entity;\n    return this;\n  }\n\n  /*\n  setMetadata(key: string, value: any): this {\n    this.metadata[key] = value;\n    return this;\n  }\n\n  getMetadata(key: string, recurse = true): any {\n    if (key in this.metadata) {\n      return this.metadata[key];\n    }\n    if (recurse && this.parent) {\n      return this.parent.getMetadata(key);\n    }\n    return null;\n  }\n  */\n\n  /**\n   * Returns a simple string representation of this Entity.\n   * @returns A string representation\n   */\n  toString(): string {\n    return `Entity(id = ${this.uuid})`;\n  }\n\n  /**\n   * Checks if this Entity is equal to another Entity.\n   * @param another The Entity to compare with\n   * @param expect Optional parameter\n   * @returns True if the Entities are equal, false otherwise\n   */\n  equals(another: this, expect = false): boolean {\n    if (this.TYPE != another.TYPE) return false;\n    // check metadata too\n    return true;\n  }\n\n  /**\n   * Creates a clone of this entity.\n   * Cloning is a two-part process:\n   * 1. Creation of a new instance via this.newInstance()\n   * 2. Copying of data into the new instance via this.copyTo()\n   *\n   * @returns A new instance of the same type with the same properties\n   */\n  clone(): this {\n    const out = this.newInstance();\n    this.copyTo(out);\n    return out;\n  }\n\n  /**\n   * Copies information about this instance into another instance of the same type.\n   * @param another The target instance to copy properties to\n   */\n  copyTo(another: this): void {\n    // another.metadata = { ...this.metadata };\n  }\n\n  /**\n   * First part of the cloning process where the instance is created.\n   * @returns A new instance of the same type\n   */\n  protected newInstance(): this {\n    return new (this.constructor as any)();\n  }\n}\n\n/**\n * Music is all about timing! TimedEntities are base of all entities that\n * have a duration. This is an abstract class that all timed entities inherit from.\n */\nexport abstract class TimedEntity extends Entity {\n  readonly TYPE: string = \"TimedEntity\";\n\n  /**\n   * Gets the duration of this entity in terms of beats.\n   * By default, entity durations are readonly.\n   */\n  abstract get duration(): TSU.Num.Fraction;\n\n  /**\n   * Checks if this TimedEntity is equal to another TimedEntity.\n   * @param another The TimedEntity to compare with\n   * @returns True if the TimedEntities are equal, false otherwise\n   */\n  equals(another: this): boolean {\n    return super.equals(another) && this.duration.equals(another.duration);\n  }\n}\n"]}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/entity.ts"],"names":[],"mappings":";;;AAWA,MAAa,MAAM;IAajB,YAAY,SAAc,IAAI;QAZrB,SAAI,GAAW,QAAQ,CAAC;QAIxB,SAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvB,YAAO,GAAyB,IAAI,CAAC;QAO7C,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC7E,CAAC;IAKD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAMD,SAAS,CAAC,MAA4B;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAOD,UAAU;QACR,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAMD,QAAQ;QACN,OAAO,eAAe,IAAI,CAAC,IAAI,GAAG,CAAC;IACrC,CAAC;IAQD,MAAM,CAAC,OAAa,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAUD,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC;IAMD,MAAM,CAAC,OAAa;IAEpB,CAAC;IAMS,WAAW;QACnB,OAAO,IAAK,IAAI,CAAC,WAAmB,EAAE,CAAC;IACzC,CAAC;;AAzFH,wBA0FC;AAvFgB,cAAO,GAAG,CAAC,AAAJ,CAAK;AA6F7B,MAAsB,WAAY,SAAQ,MAAM;IAAhD;;QACW,SAAI,GAAW,aAAa,CAAC;IAgBxC,CAAC;IAHC,MAAM,CAAC,OAAa;QAClB,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;CACF;AAjBD,kCAiBC","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\n\n/**\n * A common Entity base class with support for unique IDs, parent references,\n * copying, and debug info. This serves as the foundation for all entities\n * in the notation system.\n *\n * Note: Child management is intentionally NOT included here. Each container type\n * (BlockContainer, Line, Group, etc.) defines its own child management with\n * appropriate types.\n */\nexport class Entity {\n  readonly TYPE: string = \"Entity\";\n\n  private static counter = 0;\n  /** Unique identifier for this entity */\n  readonly uuid = Entity.counter++;\n  /** Parent entity in the tree hierarchy */\n  protected _parent: TSU.Nullable<Entity> = null;\n\n  /**\n   * Creates a new Entity.\n   * @param config Optional configuration object\n   */\n  constructor(config: any = null) {\n    config = config || {};\n    if (config.metadata) throw new Error(\"See where metadata is being passed\");\n  }\n\n  /**\n   * Gets the parent entity.\n   */\n  get parent(): TSU.Nullable<Entity> {\n    return this._parent;\n  }\n\n  /**\n   * Sets the parent entity.\n   * @param parent The parent entity to set\n   */\n  setParent(parent: TSU.Nullable<Entity>): void {\n    this._parent = parent;\n  }\n\n  /**\n   * Returns a debug-friendly representation of this entity.\n   * Usually overridden by children to add more debug info.\n   * @returns An object containing debug information\n   */\n  debugValue(): any {\n    return { type: this.TYPE };\n  }\n\n  /**\n   * Returns a simple string representation of this Entity.\n   * @returns A string representation\n   */\n  toString(): string {\n    return `Entity(id = ${this.uuid})`;\n  }\n\n  /**\n   * Checks if this Entity is equal to another Entity.\n   * @param another The Entity to compare with\n   * @param expect Optional parameter\n   * @returns True if the Entities are equal, false otherwise\n   */\n  equals(another: this, expect = false): boolean {\n    if (this.TYPE != another.TYPE) return false;\n    return true;\n  }\n\n  /**\n   * Creates a clone of this entity.\n   * Cloning is a two-part process:\n   * 1. Creation of a new instance via this.newInstance()\n   * 2. Copying of data into the new instance via this.copyTo()\n   *\n   * @returns A new instance of the same type with the same properties\n   */\n  clone(): this {\n    const out = this.newInstance();\n    this.copyTo(out);\n    return out;\n  }\n\n  /**\n   * Copies information about this instance into another instance of the same type.\n   * @param another The target instance to copy properties to\n   */\n  copyTo(another: this): void {\n    // Subclasses override to copy their specific properties\n  }\n\n  /**\n   * First part of the cloning process where the instance is created.\n   * @returns A new instance of the same type\n   */\n  protected newInstance(): this {\n    return new (this.constructor as any)();\n  }\n}\n\n/**\n * Music is all about timing! TimedEntities are base of all entities that\n * have a duration. This is an abstract class that all timed entities inherit from.\n */\nexport abstract class TimedEntity extends Entity {\n  readonly TYPE: string = \"TimedEntity\";\n\n  /**\n   * Gets the duration of this entity in terms of beats.\n   * By default, entity durations are readonly.\n   */\n  abstract get duration(): TSU.Num.Fraction;\n\n  /**\n   * Checks if this TimedEntity is equal to another TimedEntity.\n   * @param another The TimedEntity to compare with\n   * @returns True if the TimedEntities are equal, false otherwise\n   */\n  equals(another: this): boolean {\n    return super.equals(another) && this.duration.equals(another.duration);\n  }\n}\n"]}