notations 1.0.2 → 1.0.6

package/lib/cjs/block.d.ts

@@ -3,6 +3,7 @@ import { Entity } from "./entity";
 import { Cycle } from "./cycle";
 import { Line } from "./core";
 import { LayoutParams } from "./layouts";
+import { BlockObserver } from "./events";
 export declare class RoleDef {
     name: string;
     notesOnly: boolean;
@@ -31,7 +32,10 @@ export declare class Block extends Entity {
     private _parentBlock;
     protected _currRoleDef: TSU.Nullable<RoleDef>;
     protected _currentLine: TSU.Nullable<Line>;
+    private _observers;
     constructor(blockType: string, parent?: TSU.Nullable<Block>, name?: TSU.Nullable<string>);
+    addObserver(observer: BlockObserver<BlockItem, Block>): () => void;
+    removeObserver(observer: BlockObserver<BlockItem, Block>): void;
     children(): BlockItem[];
     get parentBlock(): TSU.Nullable<Block>;
     get cycle(): TSU.Nullable<Cycle>;

package/lib/cjs/block.js

@@ -49,6 +49,7 @@ class Block extends entity_1.Entity {
         this._parentBlock = null;
         this._currRoleDef = null;
         this._currentLine = null;
+        this._observers = [];
         this._unnamedLayoutParams = [];
         this._namedLayoutParams = new Map();
         this._layoutParams = null;
@@ -59,6 +60,16 @@ class Block extends entity_1.Entity {
             this.setParent(parent);
         }
     }
+    addObserver(observer) {
+        this._observers.push(observer);
+        return () => this.removeObserver(observer);
+    }
+    removeObserver(observer) {
+        const index = this._observers.indexOf(observer);
+        if (index >= 0) {
+            this._observers.splice(index, 1);
+        }
+    }
     children() {
         return this.blockItems;
     }
@@ -204,14 +215,27 @@ class Block extends entity_1.Entity {
         return rd;
     }
     addBlockItem(item) {
+        var _a;
+        const index = this.blockItems.length;
         item.setParent(this);
         this.blockItems.push(item);
+        if (this._eventsEnabled) {
+            for (const observer of this._observers) {
+                (_a = observer.onItemAdded) === null || _a === void 0 ? void 0 : _a.call(observer, this, item, index);
+            }
+        }
     }
     removeBlockItem(item) {
+        var _a;
         const index = this.blockItems.indexOf(item);
         if (index >= 0) {
             this.blockItems.splice(index, 1);
             item.setParent(null);
+            if (this._eventsEnabled) {
+                for (const observer of this._observers) {
+                    (_a = observer.onItemRemoved) === null || _a === void 0 ? void 0 : _a.call(observer, this, item, index);
+                }
+            }
         }
         return index;
     }

package/lib/cjs/block.js.map

@@ -1 +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"]}
+{"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\";\nimport { BlockObserver } from \"./events\";\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   * Observers that receive notifications when block items change.\n   */\n  private _observers: BlockObserver<BlockItem, Block>[] = [];\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   * Adds an observer to receive block item change notifications.\n   * @param observer The observer to add\n   * @returns A function to remove the observer\n   */\n  addObserver(observer: BlockObserver<BlockItem, Block>): () => void {\n    this._observers.push(observer);\n    return () => this.removeObserver(observer);\n  }\n\n  /**\n   * Removes an observer.\n   * @param observer The observer to remove\n   */\n  removeObserver(observer: BlockObserver<BlockItem, Block>): void {\n    const index = this._observers.indexOf(observer);\n    if (index >= 0) {\n      this._observers.splice(index, 1);\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    const index = this.blockItems.length;\n    item.setParent(this);\n    this.blockItems.push(item);\n\n    // Notify observers of added item\n    if (this._eventsEnabled) {\n      for (const observer of this._observers) {\n        observer.onItemAdded?.(this, item, index);\n      }\n    }\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      // Notify observers of removed item\n      if (this._eventsEnabled) {\n        for (const observer of this._observers) {\n          observer.onItemRemoved?.(this, item, index);\n        }\n      }\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/core.d.ts

@@ -1,6 +1,7 @@
 import * as TSU from "@panyam/tsutils";
 import { Entity, TimedEntity } from "./entity";
 import { LayoutParams } from "./layouts";
+import { GroupObserver, RoleObserver, LineObserver } from "./events";
 type Fraction = TSU.Num.Fraction;
 export declare const ZERO: TSU.Num.Fraction;
 export declare const ONE: TSU.Num.Fraction;
@@ -89,7 +90,11 @@ export declare class Group extends Atom {
     readonly TYPE = "Group";
     durationIsMultiplier: boolean;
     readonly atoms: TSU.Lists.ValueList<Atom>;
+    private _observers;
     constructor(...atoms: Atom[]);
+    addObserver(observer: GroupObserver<Atom, Group>): () => void;
+    removeObserver(observer: GroupObserver<Atom, Group>): void;
+    private notifyObservers;
     equals(another: this, expect?: boolean): boolean;
     copyTo(another: this): void;
     get duration(): Fraction;
@@ -108,12 +113,16 @@ export declare class Line extends Entity {
     roles: Role[];
     marginText: string;
     layoutParams: LayoutParams;
+    private _observers;
+    addObserver(observer: LineObserver<Role, Line>): () => void;
+    removeObserver(observer: LineObserver<Role, Line>): void;
     indexOfRole(name: string): number;
     get isEmpty(): boolean;
     debugValue(): any;
     copyTo(another: this): void;
     addAtoms(roleName: string, defaultToNotes: boolean, ...atoms: Atom[]): this;
     ensureRole(roleName: string, defaultToNotes: boolean): Role;
+    removeRole(roleName: string): boolean;
     get duration(): Fraction;
 }
 export declare class Role extends Entity {
@@ -122,10 +131,16 @@ export declare class Role extends Entity {
     readonly TYPE = "Role";
     defaultToNotes: boolean;
     atoms: Atom[];
+    private _observers;
     constructor(line: Line, name: string);
+    addObserver(observer: RoleObserver<Atom, Role>): () => void;
+    removeObserver(observer: RoleObserver<Atom, Role>): void;
+    private notifyObservers;
     get isEmpty(): boolean;
     debugValue(): any;
     addAtoms(...atoms: Atom[]): void;
+    insertAtomsAt(index: number, ...atoms: Atom[]): void;
+    removeAtoms(...atoms: Atom[]): void;
     copyTo(another: Role): void;
     get duration(): Fraction;
 }

package/lib/cjs/core.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Role = exports.Line = exports.Group = exports.Note = exports.Syllable = exports.Literal = exports.Space = exports.Rest = exports.Marker = exports.LeafAtom = exports.Atom = exports.AtomType = exports.ONE = exports.ZERO = void 0;
 const TSU = __importStar(require("@panyam/tsutils"));
 const entity_1 = require("./entity");
+const events_1 = require("./events");
 exports.ZERO = TSU.Num.Fraction.ZERO;
 exports.ONE = TSU.Num.Fraction.ONE;
 var AtomType;
@@ -247,8 +248,37 @@ class Group extends Atom {
         this.TYPE = "Group";
         this.durationIsMultiplier = false;
         this.atoms = new TSU.Lists.ValueList();
+        this._observers = [];
         this.addAtoms(false, ...atoms);
     }
+    addObserver(observer) {
+        this._observers.push(observer);
+        return () => this.removeObserver(observer);
+    }
+    removeObserver(observer) {
+        const index = this._observers.indexOf(observer);
+        if (index >= 0) {
+            this._observers.splice(index, 1);
+        }
+    }
+    notifyObservers(type, atoms, index) {
+        var _a, _b, _c;
+        if (!this._eventsEnabled)
+            return;
+        for (const observer of this._observers) {
+            switch (type) {
+                case events_1.AtomChangeType.ADD:
+                    (_a = observer.onAtomsAdded) === null || _a === void 0 ? void 0 : _a.call(observer, this, atoms, index);
+                    break;
+                case events_1.AtomChangeType.INSERT:
+                    (_b = observer.onAtomsInserted) === null || _b === void 0 ? void 0 : _b.call(observer, this, atoms, index);
+                    break;
+                case events_1.AtomChangeType.REMOVE:
+                    (_c = observer.onAtomsRemoved) === null || _c === void 0 ? void 0 : _c.call(observer, this, atoms);
+                    break;
+            }
+        }
+    }
     equals(another, expect = false) {
         if (!super.equals(another))
             return false;
@@ -257,7 +287,9 @@ class Group extends Atom {
     copyTo(another) {
         super.copyTo(another);
         another.durationIsMultiplier = this.durationIsMultiplier;
-        this.atoms.forEach((atom) => another.atoms.add(atom.clone()));
+        for (const atom of this.atoms.values()) {
+            another.atoms.add(atom.clone());
+        }
     }
     get duration() {
         if (this.durationIsMultiplier) {
@@ -330,12 +362,27 @@ class Group extends Atom {
     }
     get totalChildDuration() {
         let out = exports.ZERO;
-        this.atoms.forEach((atom) => (out = out.plus(atom.duration)));
+        for (const atom of this.atoms.values()) {
+            out = out.plus(atom.duration);
+        }
         return out;
     }
     insertAtomsAt(beforeAtom, adjustDuration = false, ...atoms) {
         adjustDuration = adjustDuration && !this.durationIsMultiplier;
         const oldChildDuration = adjustDuration ? this.totalChildDuration : exports.ONE;
+        let insertIndex;
+        if (beforeAtom) {
+            insertIndex = 0;
+            for (const a of this.atoms.values()) {
+                if (a === beforeAtom)
+                    break;
+                insertIndex++;
+            }
+        }
+        else {
+            insertIndex = this.atoms.size;
+        }
+        const addedAtoms = [];
         for (const atom of atoms) {
             if (atom.parentGroup != null) {
                 if (atom.parentGroup != this) {
@@ -352,6 +399,7 @@ class Group extends Atom {
             else {
                 atom.parentGroup = this;
                 this.atoms.add(atom, beforeAtom);
+                addedAtoms.push(atom);
             }
         }
         if (adjustDuration) {
@@ -365,6 +413,10 @@ class Group extends Atom {
                 this._duration = this._duration.times(scaleFactor, true);
             }
         }
+        if (addedAtoms.length > 0) {
+            const type = beforeAtom ? events_1.AtomChangeType.INSERT : events_1.AtomChangeType.ADD;
+            this.notifyObservers(type, addedAtoms, insertIndex);
+        }
         return this;
     }
     addAtoms(adjustDuration = false, ...atoms) {
@@ -373,10 +425,12 @@ class Group extends Atom {
     removeAtoms(adjustDuration = false, ...atoms) {
         adjustDuration = adjustDuration && !this.durationIsMultiplier;
         const oldChildDuration = adjustDuration ? this.totalChildDuration : exports.ONE;
+        const removedAtoms = [];
         for (const atom of atoms) {
             if (atom.parentGroup == this) {
                 this.atoms.remove(atom);
                 atom.parentGroup = null;
+                removedAtoms.push(atom);
             }
             else if (atom.parentGroup != null) {
                 throw new Error("Atom cannot be removed as it does not belong to this group");
@@ -393,6 +447,9 @@ class Group extends Atom {
                 this._duration = this._duration.times(scaleFactor, true);
             }
         }
+        if (removedAtoms.length > 0) {
+            this.notifyObservers(events_1.AtomChangeType.REMOVE, removedAtoms, -1);
+        }
         return this;
     }
 }
@@ -404,6 +461,17 @@ class Line extends entity_1.Entity {
         this.offset = exports.ZERO;
         this.roles = [];
         this.marginText = "";
+        this._observers = [];
+    }
+    addObserver(observer) {
+        this._observers.push(observer);
+        return () => this.removeObserver(observer);
+    }
+    removeObserver(observer) {
+        const index = this._observers.indexOf(observer);
+        if (index >= 0) {
+            this._observers.splice(index, 1);
+        }
     }
     indexOfRole(name) {
         for (let i = 0; i < this.roles.length; i++) {
@@ -435,15 +503,35 @@ class Line extends entity_1.Entity {
         return this;
     }
     ensureRole(roleName, defaultToNotes) {
+        var _a;
         let ri = this.roles.findIndex((r) => r.name == roleName);
         if (ri < 0) {
             ri = this.roles.length;
             const role = new Role(this, roleName);
             role.defaultToNotes = defaultToNotes;
             this.roles.push(role);
+            if (this._eventsEnabled) {
+                for (const observer of this._observers) {
+                    (_a = observer.onRoleAdded) === null || _a === void 0 ? void 0 : _a.call(observer, this, roleName, role);
+                }
+            }
         }
         return this.roles[ri];
     }
+    removeRole(roleName) {
+        var _a;
+        const ri = this.roles.findIndex((r) => r.name == roleName);
+        if (ri >= 0) {
+            this.roles.splice(ri, 1);
+            if (this._eventsEnabled) {
+                for (const observer of this._observers) {
+                    (_a = observer.onRoleRemoved) === null || _a === void 0 ? void 0 : _a.call(observer, this, roleName);
+                }
+            }
+            return true;
+        }
+        return false;
+    }
     get duration() {
         let max = exports.ZERO;
         for (const role of this.roles) {
@@ -461,6 +549,35 @@ class Role extends entity_1.Entity {
         this.TYPE = "Role";
         this.defaultToNotes = true;
         this.atoms = [];
+        this._observers = [];
+    }
+    addObserver(observer) {
+        this._observers.push(observer);
+        return () => this.removeObserver(observer);
+    }
+    removeObserver(observer) {
+        const index = this._observers.indexOf(observer);
+        if (index >= 0) {
+            this._observers.splice(index, 1);
+        }
+    }
+    notifyObservers(type, atoms, index) {
+        var _a, _b, _c;
+        if (!this._eventsEnabled)
+            return;
+        for (const observer of this._observers) {
+            switch (type) {
+                case events_1.AtomChangeType.ADD:
+                    (_a = observer.onAtomsAdded) === null || _a === void 0 ? void 0 : _a.call(observer, this, atoms, index);
+                    break;
+                case events_1.AtomChangeType.INSERT:
+                    (_b = observer.onAtomsInserted) === null || _b === void 0 ? void 0 : _b.call(observer, this, atoms, index);
+                    break;
+                case events_1.AtomChangeType.REMOVE:
+                    (_c = observer.onAtomsRemoved) === null || _c === void 0 ? void 0 : _c.call(observer, this, atoms);
+                    break;
+            }
+        }
     }
     get isEmpty() {
         return this.atoms.length == 0;
@@ -469,7 +586,11 @@ class Role extends entity_1.Entity {
         return { name: this.name, atoms: this.atoms.map((a) => a.debugValue()) };
     }
     addAtoms(...atoms) {
-        let last = null;
+        this.insertAtomsAt(this.atoms.length, ...atoms);
+    }
+    insertAtomsAt(index, ...atoms) {
+        const addedAtoms = [];
+        let last = index > 0 ? this.atoms[index - 1] : null;
         for (const atom of atoms) {
             if (atom.TYPE == AtomType.REST) {
                 if (last && last.TYPE != AtomType.GROUP && last.TYPE != AtomType.LABEL) {
@@ -477,10 +598,29 @@ class Role extends entity_1.Entity {
                 }
             }
             else {
-                this.atoms.push(atom);
+                this.atoms.splice(index + addedAtoms.length, 0, atom);
+                addedAtoms.push(atom);
             }
             last = atom;
         }
+        if (addedAtoms.length > 0) {
+            const isAppend = index >= this.atoms.length - addedAtoms.length;
+            const type = isAppend ? events_1.AtomChangeType.ADD : events_1.AtomChangeType.INSERT;
+            this.notifyObservers(type, addedAtoms, index);
+        }
+    }
+    removeAtoms(...atoms) {
+        const removedAtoms = [];
+        for (const atom of atoms) {
+            const idx = this.atoms.indexOf(atom);
+            if (idx >= 0) {
+                this.atoms.splice(idx, 1);
+                removedAtoms.push(atom);
+            }
+        }
+        if (removedAtoms.length > 0) {
+            this.notifyObservers(events_1.AtomChangeType.REMOVE, removedAtoms, -1);
+        }
     }
     copyTo(another) {
         another.addAtoms(...this.atoms);