notations 0.0.69 → 1.0.0

package/lib/cjs/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/block.ts"],"names":[],"mappings":"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","sourcesContent":["import * as TSU from \"@panyam/tsutils\";\nimport { Entity } from \"./entity\";\nimport { Cycle } from \"./cycle\";\nimport { Line } from \"./core\";\nimport { LayoutParams } from \"./layouts\";\n\n/**\n * Definition of a role in a block context.\n * This is used for block-scoped role definitions.\n */\nexport class RoleDef {\n  /** Name of the role */\n  name = \"\";\n\n  /** Whether this role contains only notes (true) or can also contain syllables/text (false) */\n  notesOnly = false;\n\n  /** Index of this role in the notation */\n  index = 0;\n}\n\n/**\n * Represents a raw block of content in the notation.\n * Raw blocks can contain arbitrary content like markdown, HTML, etc.\n */\nexport class RawBlock extends Entity {\n  readonly TYPE: string = \"RawBlock\";\n\n  /**\n   * Creates a new RawBlock.\n   * @param content The content of the block\n   * @param contentType The type of content (e.g., \"md\" for markdown)\n   */\n  constructor(\n    public content: string,\n    public contentType: string = \"md\",\n  ) {\n    super();\n  }\n\n  /**\n   * Returns a debug-friendly representation of this raw block.\n   * @returns An object containing debug information\n   */\n  debugValue(): any {\n    return { ...super.debugValue(), content: this.content, contentType: this.contentType };\n  }\n}\n\n/**\n * Union type for items that can appear in a block.\n */\nexport type BlockItem = Block | Line | RawBlock;\n\n/**\n * Type guard to check if an entity is a Block.\n */\nexport function isBlock(item: BlockItem): item is Block {\n  return item.TYPE === \"Block\";\n}\n\n/**\n * Type guard to check if an entity is a Line.\n */\nexport function isLine(item: BlockItem): item is Line {\n  return item.TYPE === \"Line\";\n}\n\n/**\n * Type guard to check if an entity is a RawBlock.\n */\nexport function isRawBlock(item: BlockItem): item is RawBlock {\n  return item.TYPE === \"RawBlock\";\n}\n\n/**\n * Represents a scoped block created by a command with braces.\n * For example: \\section(\"Pallavi\") { ... }\n *\n * Blocks inherit properties from their parent Block and can override them locally.\n * Properties are resolved lazily by walking up the tree.\n *\n * Block = Command + Children (unified model)\n */\nexport class Block extends Entity {\n  readonly TYPE: string = \"Block\";\n\n  /** The type of block (e.g., \"section\", \"repeat\", \"cycle\") */\n  readonly blockType: string;\n\n  /** Optional name for the block (e.g., section name) */\n  readonly name: TSU.Nullable<string>;\n\n  /** Child items (before expansion by subclasses) */\n  readonly blockItems: BlockItem[] = [];\n\n  // Local properties\n  localCycle: TSU.Nullable<Cycle> = null;\n  localAtomsPerBeat: TSU.Nullable<number> = null;\n  localBreaks: TSU.Nullable<number[]> = null;\n  readonly localRoles = new Map<string, RoleDef>();\n\n  // Store parent reference (Block or null for root)\n  private _parentBlock: TSU.Nullable<Block> = null;\n\n  // State tracking for command application (protected for Notation override)\n  protected _currRoleDef: TSU.Nullable<RoleDef> = null;\n  protected _currentLine: TSU.Nullable<Line> = null;\n\n  /**\n   * Creates a new Block.\n   * @param blockType The type of block (e.g., \"section\", \"group\")\n   * @param parent The parent block (null for root)\n   * @param name Optional name for the block\n   */\n  constructor(blockType: string, parent: TSU.Nullable<Block> = null, name: TSU.Nullable<string> = null) {\n    super();\n    this.blockType = blockType;\n    this.name = name;\n    this._parentBlock = parent;\n    // Also set Entity's parent for tree traversal\n    if (parent) {\n      this.setParent(parent);\n    }\n  }\n\n  /**\n   * Returns the expanded children for layout iteration.\n   * Subclasses can override this to transform children (e.g., Repeat, Section).\n   */\n  children(): BlockItem[] {\n    return this.blockItems;\n  }\n\n  /**\n   * Gets the parent block.\n   */\n  get parentBlock(): TSU.Nullable<Block> {\n    return this._parentBlock;\n  }\n\n  // ============================================\n  // Property inheritance via tree walking\n  // ============================================\n\n  /**\n   * Gets the effective cycle by walking up the tree.\n   */\n  get cycle(): TSU.Nullable<Cycle> {\n    if (this.localCycle !== null) {\n      return this.localCycle;\n    }\n    return this.parentBlock?.cycle ?? null;\n  }\n\n  /**\n   * Gets the effective atoms per beat by walking up the tree.\n   * Defaults to 1 if not set anywhere in the tree.\n   */\n  get atomsPerBeat(): number {\n    if (this.localAtomsPerBeat !== null) {\n      return this.localAtomsPerBeat;\n    }\n    return this.parentBlock?.atomsPerBeat ?? 1;\n  }\n\n  /**\n   * Gets the effective line breaks by walking up the tree.\n   * Defaults to empty array if not set anywhere.\n   */\n  get breaks(): number[] {\n    if (this.localBreaks !== null) {\n      return this.localBreaks;\n    }\n    return this.parentBlock?.breaks ?? [];\n  }\n\n  // ============================================\n  // Layout parameters management\n  // ============================================\n\n  /** Layout parameters caching for this block scope */\n  private _unnamedLayoutParams: LayoutParams[] = [];\n  private _namedLayoutParams = new Map<string, LayoutParams>();\n  private _layoutParams: LayoutParams | null = null;\n\n  /**\n   * Gets the unnamed layout parameters for this block.\n   */\n  get unnamedLayoutParams(): ReadonlyArray<LayoutParams> {\n    return this._unnamedLayoutParams;\n  }\n\n  /**\n   * Gets the named layout parameters for this block.\n   */\n  get namedLayoutParams(): ReadonlyMap<string, LayoutParams> {\n    return this._namedLayoutParams;\n  }\n\n  /**\n   * Gets the current layout parameters for this block scope.\n   * Uses the effective cycle, atomsPerBeat, and breaks from tree walking.\n   * Creates or finds a matching LayoutParams if needed.\n   */\n  get layoutParams(): LayoutParams {\n    if (this._layoutParams == null) {\n      // Find or create layout params matching current effective values\n      this._layoutParams = this.findUnnamedLayoutParams();\n      if (this._layoutParams == null) {\n        this._layoutParams = this.snapshotLayoutParams();\n        this._unnamedLayoutParams.push(this._layoutParams);\n      }\n    }\n    return this._layoutParams;\n  }\n\n  /**\n   * Resets the current layout parameters to null.\n   * Called when layout-affecting properties change.\n   */\n  resetLayoutParams(): void {\n    this._layoutParams = null;\n    this.resetLine();\n  }\n\n  /**\n   * Creates a snapshot of the current layout parameters.\n   * @returns A new LayoutParams object with the current effective settings\n   */\n  protected snapshotLayoutParams(): LayoutParams {\n    const effectiveCycle = this.cycle;\n    if (effectiveCycle == null) {\n      throw new Error(\"Cannot create layout params: no cycle defined\");\n    }\n    return new LayoutParams({\n      cycle: effectiveCycle,\n      beatDuration: this.atomsPerBeat,\n      layout: this.breaks,\n    });\n  }\n\n  /**\n   * Finds an unnamed layout parameters object that matches the current effective settings.\n   * @returns Matching layout parameters, or null if none found\n   */\n  protected findUnnamedLayoutParams(): LayoutParams | null {\n    const effectiveCycle = this.cycle;\n    if (effectiveCycle == null) return null;\n\n    return (\n      this._unnamedLayoutParams.find((lp) => {\n        return (\n          lp.beatDuration == this.atomsPerBeat && effectiveCycle.equals(lp.cycle) && lp.lineBreaksEqual(this.breaks)\n        );\n      }) || null\n    );\n  }\n\n  /**\n   * Ensures that named layout parameters with the given name exist.\n   * @param name The name of the layout parameters\n   * @returns The layout parameters\n   */\n  ensureNamedLayoutParams(name: string): LayoutParams {\n    let lp = this._namedLayoutParams.get(name) || null;\n    if (lp == null || this._layoutParams != lp) {\n      if (lp == null) {\n        // Create new named layout params\n        lp = this.snapshotLayoutParams();\n        this._namedLayoutParams.set(name, lp);\n      } else {\n        // Copy named LPs attributes into our locals\n        this.localCycle = lp.cycle;\n        this.localAtomsPerBeat = lp.beatDuration;\n        this.localBreaks = lp.lineBreaks;\n      }\n      this._layoutParams = lp;\n      this.resetLine();\n    }\n    return this._layoutParams!;\n  }\n\n  /**\n   * Gets a role definition by name, walking up the tree if not found locally.\n   * @param name The name of the role\n   */\n  getRole(name: string): TSU.Nullable<RoleDef> {\n    const local = this.localRoles.get(name.toLowerCase());\n    if (local) {\n      return local;\n    }\n    return this.parentBlock?.getRole(name) ?? null;\n  }\n\n  // ============================================\n  // State tracking for command application\n  // ============================================\n\n  /**\n   * Gets the current role definition.\n   * Falls back to parent's current role or the last defined role.\n   */\n  get currRoleDef(): TSU.Nullable<RoleDef> {\n    if (this._currRoleDef !== null) {\n      return this._currRoleDef;\n    }\n    // Fall back to parent's current role\n    if (this.parentBlock) {\n      return this.parentBlock.currRoleDef;\n    }\n    // Or use the last locally defined role\n    const roles = Array.from(this.localRoles.values());\n    return roles.length > 0 ? roles[roles.length - 1] : null;\n  }\n\n  /**\n   * Sets the current role by name.\n   * If the role doesn't exist, tries to create it via the root container's onMissingRole.\n   * @param name The name of the role to activate\n   * @throws Error if the role is not found and cannot be created\n   */\n  setCurrRole(name: string): void {\n    name = name.trim().toLowerCase();\n    if (name === \"\") {\n      throw new Error(\"Role name cannot be empty\");\n    }\n    let roleDef = this.getRole(name);\n    // If role not found, try auto-creation\n    if (roleDef == null) {\n      // Create the role locally in this block\n      // Default: \"sw\" is notes-only, others are not\n      roleDef = this.newRoleDef(name, name === \"sw\");\n    }\n    this._currRoleDef = roleDef;\n  }\n\n  /**\n   * Gets the current line, creating one if needed.\n   */\n  get currentLine(): Line {\n    if (this._currentLine === null) {\n      return this.newLine();\n    }\n    return this._currentLine;\n  }\n\n  /**\n   * Creates a new line in this block.\n   */\n  newLine(): Line {\n    if (this._currentLine !== null && this._currentLine.isEmpty) {\n      // Remove empty line before creating new one\n      this.removeBlockItem(this._currentLine);\n    }\n    this._currentLine = new Line();\n    this.addBlockItem(this._currentLine);\n    return this._currentLine;\n  }\n\n  /**\n   * Resets the current line pointer to null.\n   * Called when layout parameters change to force a new line.\n   */\n  resetLine(): void {\n    this._currentLine = null;\n  }\n\n  /**\n   * Creates a new role definition local to this block.\n   * @param name The name of the role\n   * @param notesOnly Whether this role contains only notes\n   */\n  newRoleDef(name: string, notesOnly = false): RoleDef {\n    name = name.trim().toLowerCase();\n    if (name === \"\") {\n      throw new Error(\"Role name cannot be empty\");\n    }\n    if (this.localRoles.has(name)) {\n      throw new Error(`Role '${name}' already exists in this block`);\n    }\n    const rd = new RoleDef();\n    rd.name = name;\n    rd.notesOnly = notesOnly;\n    rd.index = this.localRoles.size;\n    this.localRoles.set(name, rd);\n    return rd;\n  }\n\n  // ============================================\n  // Child management\n  // ============================================\n\n  /**\n   * Adds a child item to this block.\n   * @param item The item to add\n   */\n  addBlockItem(item: BlockItem): void {\n    item.setParent(this);\n    this.blockItems.push(item);\n  }\n\n  /**\n   * Removes a child item from this block.\n   * @param item The item to remove\n   * @returns The index of the removed item, or -1 if not found\n   */\n  removeBlockItem(item: BlockItem): number {\n    const index = this.blockItems.indexOf(item);\n    if (index >= 0) {\n      this.blockItems.splice(index, 1);\n      item.setParent(null);\n    }\n    return index;\n  }\n\n  /**\n   * Returns a debug-friendly representation of this block.\n   */\n  debugValue(): any {\n    const out: any = {\n      ...super.debugValue(),\n      blockType: this.blockType,\n      blockItems: this.blockItems.map((c) => c.debugValue()),\n    };\n    if (this.name) {\n      out.name = this.name;\n    }\n    if (this.localCycle) {\n      out.localCycle = this.localCycle.uuid;\n    }\n    if (this.localAtomsPerBeat !== null) {\n      out.localAtomsPerBeat = this.localAtomsPerBeat;\n    }\n    if (this.localBreaks !== null) {\n      out.localBreaks = this.localBreaks;\n    }\n    if (this.localRoles.size > 0) {\n      out.localRoles = Array.from(this.localRoles.keys());\n    }\n    return out;\n  }\n}\n\n/**\n * Helper function to find the containing block of an entity by walking up the tree.\n * @param entity The entity to start from\n * @returns The containing Block, or null if not found\n */\nexport function findContainingBlock(entity: Entity): TSU.Nullable<Block> {\n  let current: TSU.Nullable<Entity> = entity.parent;\n  while (current !== null) {\n    if (current instanceof Block) {\n      return current;\n    }\n    current = current.parent;\n  }\n  return null;\n}\n\n// ============================================\n// Block Subclasses\n// ============================================\n\n/**\n * A section block with a heading.\n * Expands children to include a heading RawBlock followed by the content.\n *\n * Usage: \\section(\"Pallavi\") { ... }\n */\nexport class SectionBlock extends Block {\n  constructor(sectionName: string, parent: TSU.Nullable<Block> = null) {\n    super(\"section\", parent, sectionName);\n  }\n\n  /**\n   * Expands children to include a heading RawBlock.\n   */\n  children(): BlockItem[] {\n    const heading = new RawBlock(`# ${this.name}`, \"md\");\n    return [heading, ...this.blockItems];\n  }\n}\n\n/**\n * A repeat block that expands its children N times.\n *\n * Usage: \\repeat(2) { ... }\n */\nexport class RepeatBlock extends Block {\n  /** Number of times to repeat (0 = visual markers only) */\n  readonly repeatCount: number;\n\n  constructor(repeatCount: number, parent: TSU.Nullable<Block> = null) {\n    super(\"repeat\", parent);\n    this.repeatCount = repeatCount;\n  }\n\n  /**\n   * Expands children by repeating them N times.\n   * If count is 0, returns children as-is (visual repeat markers only).\n   */\n  children(): BlockItem[] {\n    if (this.repeatCount <= 0) {\n      return this.blockItems;\n    }\n    const expanded: BlockItem[] = [];\n    for (let i = 0; i < this.repeatCount; i++) {\n      expanded.push(...this.blockItems);\n    }\n    return expanded;\n  }\n}\n\n/**\n * A cycle block that sets localCycle for scoped notation.\n *\n * Usage: \\cycle(\"|4|4|\") { ... }\n */\nexport class CycleBlock extends Block {\n  constructor(cycle: Cycle, parent: TSU.Nullable<Block> = null) {\n    super(\"cycle\", parent);\n    this.localCycle = cycle;\n  }\n}\n\n/**\n * A beat duration block that sets localAtomsPerBeat for scoped notation.\n *\n * Usage: \\beatDuration(2) { ... }\n */\nexport class BeatDurationBlock extends Block {\n  constructor(atomsPerBeat: number, parent: TSU.Nullable<Block> = null) {\n    super(\"beatduration\", parent);\n    this.localAtomsPerBeat = atomsPerBeat;\n  }\n}\n\n/**\n * A breaks block that sets localBreaks for scoped notation.\n *\n * Usage: \\breaks(4, 2, 2) { ... }\n */\nexport class BreaksBlock extends Block {\n  constructor(breaks: number[], parent: TSU.Nullable<Block> = null) {\n    super(\"breaks\", parent);\n    this.localBreaks = breaks;\n  }\n}\n\n/**\n * A role block that creates a local role definition.\n *\n * Usage: \\role(\"Vocals\", notes=false) { ... }\n */\nexport class RoleBlock extends Block {\n  constructor(roleName: string, notesOnly: boolean, parent: TSU.Nullable<Block> = null) {\n    super(\"role\", parent);\n    // Create the role locally\n    this.newRoleDef(roleName, notesOnly);\n  }\n}\n\n/**\n * A group block for organizing notation without special semantics.\n *\n * Usage: \\group(\"optional-name\") { ... }\n */\nexport class GroupBlock extends Block {\n  constructor(groupName: string | null, parent: TSU.Nullable<Block> = null) {\n    super(\"group\", parent, groupName);\n  }\n}\n"]}

package/lib/cjs/carnatic/NotationView.d.ts

@@ -1,13 +1,17 @@
 import * as TSU from "@panyam/tsutils";
 import { LineView } from "./LineView";
-import { Notation, RawBlock } from "../notation";
+import { Notation, RawBlock, Block, BlockItem } from "../notation";
 import { GlobalBeatLayout } from "../beats";
-import { GridCell, GridCellView } from "../grids";
+import { GridCell, GridCellView, GridLayoutGroup } from "../grids";
 import { Line } from "../core";
 import { BeatView, MarkerView } from "./beatviews";
+export interface NotationViewConfig {
+    sharedGridLayoutGroup?: GridLayoutGroup;
+    markdownParser?: (contents: string) => string;
+}
 export declare class NotationView {
     readonly rootElement: HTMLElement;
-    readonly config?: any | undefined;
+    readonly config?: NotationViewConfig | undefined;
     headerElement: HTMLDivElement;
     notation: Notation;
     lineViews: LineView[];
@@ -15,7 +19,8 @@ export declare class NotationView {
     tableElement: HTMLTableElement;
     markdownParser: (contents: string) => string;
     _beatLayout: GlobalBeatLayout;
-    constructor(rootElement: HTMLElement, config?: any | undefined);
+    private layoutChangeUnsubscribe;
+    constructor(rootElement: HTMLElement, config?: NotationViewConfig | undefined);
     get beatLayout(): GlobalBeatLayout;
     set beatLayout(beatLayout: GlobalBeatLayout);
     loadChildViews(): void;
@@ -27,6 +32,8 @@ export declare class NotationView {
     get currentLineView(): LineView;
     clear(): void;
     refreshLayout(): void;
+    protected processBlock(block: Block, lineViews: LineView[]): void;
+    protected processBlockItem(item: BlockItem, lineViews: LineView[]): void;
     renderBlock(raw: RawBlock): void;
     beatViews: Map<number, BeatView>;
     markerViews: Map<string, MarkerView>;

package/lib/cjs/carnatic/NotationView.js

@@ -36,16 +36,20 @@ 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) {
+        var _a;
         this.rootElement = rootElement;
         this.config = config;
         this.lineViews = [];
         this.currentSVGElement = null;
+        this.layoutChangeUnsubscribe = null;
         this.beatViews = new Map();
         this.markerViews = new Map();
         this.loadChildViews();
+        this.markdownParser = (_a = config === null || config === void 0 ? void 0 : config.markdownParser) !== null && _a !== void 0 ? _a : ((content) => content);
     }
     get beatLayout() {
         return this._beatLayout;
@@ -140,18 +144,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 +155,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    // Default to identity function if no markdown parser provided\n    this.markdownParser = config?.markdownParser ?? ((content) => content);\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,18 @@ 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);
+        container.resetLine();
     }
 }
 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 +67,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 +88,26 @@ 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);
+            roleDef = container.newRoleDef("Sw", true);
         }
-        const lpForLine = notation.currentLine.layoutParams;
+        const line = container.currentLine;
+        const lpForLine = line.layoutParams;
         if (lpForLine == null) {
-            notation.currentLine.layoutParams = notation.layoutParams;
+            line.layoutParams = container.layoutParams;
         }
         else {
-            TSU.assert(lpForLine == notation.layoutParams, "Layout parameters have changed so a new line should have been started");
+            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 +128,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 +147,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 +169,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 +197,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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAuC;AAEvC,mCAAqC;AACrC,yCAA2E;AAM3E,MAAa,YAAa,SAAQ,kBAAO;IAIvC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAMD,eAAe,CAAC,QAAkB;QAChC,MAAM,GAAG,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAhBD,oCAgBC;AAKD,MAAa,QAAS,SAAQ,kBAAO;IAKnC,eAAe,CAAC,QAAkB;QAEhC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,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;AA/BD,4BA+BC;AAKD,MAAa,YAAa,SAAQ,kBAAO;IAKvC,eAAe,CAAC,QAAkB;QAEhC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtC,CAAC;IAKD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF;AAjBD,oCAiBC;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,eAAe,CAAC,QAAkB;QAChC,IAAI,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC;QACnC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAEpB,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC;QACpD,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,QAAQ,CAAC,WAAW,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,MAAM,CACR,SAAS,IAAI,QAAQ,CAAC,YAAY,EAClC,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7B,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/E,CAAC;CACF;AApDD,4BAoDC;AAKD,MAAa,UAAW,SAAQ,kBAAO;IAKrC,eAAe,CAAC,QAAkB;QAIhC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChC,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;AAlCD,gCAkCC;AAKD,MAAa,UAAW,SAAQ,kBAAO;IAKrC,eAAe,CAAC,QAAkB;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,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;AAlBD,gCAkBC;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,eAAe,CAAC,QAAkB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnC,QAAQ,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;CACF;AAnBD,kCAmBC;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,eAAe,CAAC,QAAkB;QAChC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/B,CAAC;CACF;AA/BD,8BA+BC;AAKD,MAAa,QAAS,SAAQ,kBAAkB;IAK9C,eAAe,CAAC,QAAkB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEnC,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC;QAChC,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC;QAC9B,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/B,CAAC;CACF;AAZD,4BAYC;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,eAAe,CAAC,QAAkB;QAChC,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC;QACxC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/B,CAAC;CACF;AA1BD,0CA0BC","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":"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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, 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 and resets the current line\n   * so subsequent notation starts a new line.\n   */\n  applyToBlock(container: Block): void {\n    const raw = new RawBlock(this.rawContents);\n    container.addBlockItem(raw);\n    // Reset the current line so subsequent notation starts fresh\n    container.resetLine();\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    // Set layoutParams from the container's scope (Block or 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    // 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;