@coderline/alphatab-monaco 1.8.0-alpha.1669 → 1.8.0-alpha.1671

package/dist/alphaTab.monaco.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/alphatex.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/lsp.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/lspMonacoMappings.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/textmate.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/types.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *

package/dist/worker.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab Monaco v1.8.0-alpha.1669 (develop, build 1669)
+ * alphaTab Monaco v1.8.0-alpha.1671 (develop, build 1671)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -60,7 +60,8 @@ const ac = {
     BarLineStyle: alphaTab.model.BarLineStyle,
     SimileMark: alphaTab.model.SimileMark,
     Direction: alphaTab.model.Direction,
-    TremoloPickingStyle: alphaTab.model.TremoloPickingStyle
+    TremoloPickingStyle: alphaTab.model.TremoloPickingStyle,
+    BarNumberDisplay: alphaTab.model.BarNumberDisplay
 });
 const alphaTexMappedEnumMapping = {
     WhammyType: {
@@ -451,6 +452,11 @@ const alphaTexMappedEnumMapping = {
     TremoloPickingStyle: {
         Default: { snippet: 'default', shortDescription: 'Default tremolo' },
         BuzzRoll: { snippet: 'buzzRoll', shortDescription: 'Buzz roll tremolo' }
+    },
+    BarNumberDisplay: {
+        AllBars: { snippet: 'allBars', shortDescription: 'All bars' },
+        FirstOfSystem: { snippet: 'firstOfSystem', shortDescription: 'First bar of every system' },
+        Hide: { snippet: 'hide', shortDescription: 'Hide' }
     }
 };
 function enumParameter(type) {
@@ -5148,6 +5154,56 @@ const voiceMode = {
     ]
 };
 
+const defaultBarNumberDisplay = {
+    tag: '\\defaultBarNumberDisplay',
+    snippet: '\\defaultBarNumberDisplay ${1:allBars}$0',
+    shortDescription: 'Sets the display mode for bar numbers on all bars.',
+    signatures: [
+        {
+            parameters: [
+                {
+                    name: 'mode',
+                    shortDescription: 'The mode to use',
+                    parseMode: alphaTab.importer.alphaTex.ArgumentListParseTypesMode.Required,
+                    ...enumParameter('BarNumberDisplay')
+                }
+            ]
+        }
+    ],
+    examples: [
+        {
+            options: { display: { layoutMode: 'Parchment' } },
+            tex: `
+            \\defaultBarNumberDisplay allBars
+            \\title "All Bars"
+                \\track { defaultsystemslayout 3 }
+                C4.1 | C4.1 | C4.1 |
+                C4.1 | C4.1 | C4.1 
+            `
+        },
+        {
+            options: { display: { layoutMode: 'Parchment' } },
+            tex: `
+            \\defaultBarNumberDisplay firstOfSystem
+            \\title "First of System"
+                \\track { defaultsystemslayout 3 }
+                C4.1 | C4.1 | C4.1 |
+                C4.1 | C4.1 | C4.1 
+            `
+        },
+        {
+            options: { display: { layoutMode: 'Parchment' } },
+            tex: `
+            \\defaultBarNumberDisplay hide
+            \\title "Hide"
+                \\track { defaultsystemslayout 3 }
+                C4.1 | C4.1 | C4.1 |
+                C4.1 | C4.1 | C4.1 
+            `
+        }
+    ]
+};
+
 const chordDiagramsInScore = {
     tag: '\\chordDiagramsInScore',
     snippet: '\\chordDiagramsInScore',
@@ -5301,10 +5357,105 @@ const instrumentMeta = {
     examples: ``
 };
 
+const barNumberDisplay = {
+    tag: '\\barNumberDisplay',
+    snippet: '\\barNumberDisplay ${1:allBars}$0',
+    shortDescription: 'Sets the display mode for bar numbers.',
+    signatures: [
+        {
+            parameters: [
+                {
+                    name: 'mode',
+                    shortDescription: 'The mode to use',
+                    parseMode: alphaTab.importer.alphaTex.ArgumentListParseTypesMode.Required,
+                    ...enumParameter('BarNumberDisplay')
+                }
+            ]
+        }
+    ],
+    examples: [
+        {
+            options: { display: { layoutMode: 'Parchment' } },
+            tex: `
+            \\defaultBarNumberDisplay hide
+            \\track { defaultsystemslayout 3 }
+                C4.1 | \\barNumberDisplay allBars C4.1 | C4.1 |
+                \\barNumberDisplay firstOfSystem C4.1 | \\barNumberDisplay firstOfSystem C4.1 | C4.1 
+            `
+        },
+        {
+            options: { display: { layoutMode: 'Parchment' } },
+            tex: `
+            \\defaultBarNumberDisplay firstOfSystem
+            \\track { defaultsystemslayout 3 }
+                C4.1 | \\barNumberDisplay allBars C4.1 | C4.1 |
+                \\barNumberDisplay hide C4.1 | C4.1 | C4.1 
+            `
+        }
+    ]
+};
+
+const beaming = {
+    tag: '\\beaming',
+    snippet: '\\beaming ($1 $2) $0',
+    shortDescription: 'Set the time signature',
+    longDescription: `
+    Defines a custom beaming rule defining how beams of certain durations should be beamed.
+
+    To define how beats should be beamed we need 2 parts:
+
+    1. A duration with which we splitup the bars
+    2. A list of group sizes defining how many split-parts should be beamed together. 
+
+    The beaming rules go hand-in-hand with the time signature as the rules need to properly
+    define the groups for the whole beat. 
+
+    Let's take a simple example of a 4/4 time signature. If we want to ensure that the beats within the quarter notes are 
+    beamed together we can write variants like this:
+
+    a. \`\\beaming (4 1 1 1 1)\`
+    b. \`\\beaming (8 2 2 2 2)\`
+    c. \`\\beaming (16 4 4 4 4)\`
+
+    We slice the bar into 4, 8 or 16 parts. Then we add "groups" to those parts. If two beats start in the same group, they can be beamed together.
+    Simple as that. 
+
+    There are some common guidelines on how beaming "should be done" and alphaTab ships a wide range of defaults. But in case of more specialized time signatures,
+    you can also customize the beaming as you need by slicing the bar and grouping the beats as needed.
+    `,
+    signatures: [
+        {
+            parameters: [
+                {
+                    name: 'duration',
+                    shortDescription: 'The note duration defining the smallest group size',
+                    parseMode: alphaTab.importer.alphaTex.ArgumentListParseTypesMode.Required,
+                    type: alphaTab.importer.alphaTex.AlphaTexNodeType.Number
+                },
+                {
+                    name: 'groups',
+                    shortDescription: 'For every group the number of notes contained in the group.',
+                    parseMode: alphaTab.importer.alphaTex.ArgumentListParseTypesMode.ValueListWithoutParenthesis,
+                    type: alphaTab.importer.alphaTex.AlphaTexNodeType.Number
+                }
+            ]
+        }
+    ],
+    examples: `
+        \\ts (4 4)
+        \\beaming (8 4 2 2)
+        C4.8 * 8 |
+
+        \\ts (4 4)
+        \\beaming (8 4 4)
+        C4.8 * 8
+        `
+};
+
 const structuralMetaData = metadata(track, staff, voice);
-const scoreMetaData = metadata(title, subtitle, artist, album, words, music, wordsAndMusic, copyright, copyright2, instructions, notices, tab, systemsLayout, defaultSystemsLayout, showDynamics, hideDynamics, useSystemSignSeparator, multiBarRest, bracketExtendMode, singleTrackTrackNamePolicy, multiTrackTrackNamePolicy, firstSystemTrackNameMode, otherSystemsTrackNameMode, firstSystemTrackNameOrientation, otherSystemsTrackNameOrientation, extendBarLines, chordDiagramsInScore, hideEmptyStaves, hideEmptyStavesInFirstSystem, showSingleStaffBrackets);
+const scoreMetaData = metadata(title, subtitle, artist, album, words, music, wordsAndMusic, copyright, copyright2, instructions, notices, tab, systemsLayout, defaultSystemsLayout, showDynamics, hideDynamics, useSystemSignSeparator, multiBarRest, bracketExtendMode, singleTrackTrackNamePolicy, multiTrackTrackNamePolicy, firstSystemTrackNameMode, otherSystemsTrackNameMode, firstSystemTrackNameOrientation, otherSystemsTrackNameOrientation, extendBarLines, chordDiagramsInScore, hideEmptyStaves, hideEmptyStavesInFirstSystem, showSingleStaffBrackets, defaultBarNumberDisplay);
 const staffMetaData = metadata(tuning, chord, capo, lyrics, articulation, displayTranspose, transpose, instrumentMeta);
-const barMetaData = metadata(ts, ro, rc, ae, ks, clef, ottava, tempo, tf, ac, section, jump, ft, simile, barlineLeft, barlineRight, scale, width, sync, accidentals, spd, sph, spu, db, voiceMode);
+const barMetaData = metadata(ts, ro, rc, ae, ks, clef, ottava, tempo, tf, ac, section, jump, ft, simile, barlineLeft, barlineRight, scale, width, sync, accidentals, spd, sph, spu, db, voiceMode, barNumberDisplay, beaming);
 const allMetadata = new Map([
     ...structuralMetaData.entries(),
     ...scoreMetaData.entries(),
@@ -5490,11 +5641,11 @@ function setupCompletion(connection, documents) {
         if (!bar) {
             return sortCompletions(createMetaDataCompletions(barIndex, undefined, offset, Number.MAX_SAFE_INTEGER), connection.console);
         }
-        const endOfBar = bar.pipe?.start.offset ??
+        const endOfBar = bar.pipe?.start?.offset ??
             (barIndex === document.ast.bars.length - 1
                 ? Number.MAX_SAFE_INTEGER
                 : document.ast.bars[barIndex + 1].start.offset);
-        const endOfBarMetaData = bar.beats[0]?.start.offset ?? endOfBar;
+        const endOfBarMetaData = bar.beats[0]?.start?.offset ?? endOfBar;
         const metaData = bar ? binaryNodeSearch(bar.metaData, offset, endOfBarMetaData) : undefined;
         if (metaData) {
             const metaDataIndex = bar.metaData.indexOf(metaData);
@@ -5550,14 +5701,14 @@ function createBeatCompletions(beat, offset, endOfBeat) {
     if (beat.durationChange &&
         beat.durationChange.start.offset < offset &&
         offset <= beat.durationChange.end.offset) {
-        const endOfDurationChange = beat.notes?.start.offset ?? endOfBeat;
+        const endOfDurationChange = beat.notes?.start?.offset ?? endOfBeat;
         return createDurationChangeCompletions(beat.durationChange, offset, endOfDurationChange);
     }
     if (beat.notes && beat.notes.start.offset < offset && offset <= beat.notes.end.offset) {
-        const endOfNotes = beat.notes?.closeParenthesis?.start.offset ??
-            beat.durationDot?.start.offset ??
-            beat.beatEffects?.start.offset ??
-            beat.beatMultiplier?.start.offset ??
+        const endOfNotes = beat.notes?.closeParenthesis?.start?.offset ??
+            beat.durationDot?.start?.offset ??
+            beat.beatEffects?.start?.offset ??
+            beat.beatMultiplier?.start?.offset ??
             endOfBeat;
         const note = binaryNodeSearch(beat.notes.notes, offset, endOfNotes);
         if (note) {
@@ -5588,7 +5739,7 @@ function createBeatCompletions(beat, offset, endOfBeat) {
         })));
     }
     if (beat.beatEffects && beat.beatEffects.start.offset < offset && beat.beatEffects.end.offset) {
-        const endOfProperties = beat.beatEffects?.closeBrace?.start.offset ?? beat.beatMultiplier?.start.offset ?? endOfBeat;
+        const endOfProperties = beat.beatEffects?.closeBrace?.start?.offset ?? beat.beatMultiplier?.start?.offset ?? endOfBeat;
         completions.splice(0, 0, ...createPropertiesCompletions(beat.beatEffects, offset, beatProperties, endOfProperties));
     }
     return completions;
@@ -5619,7 +5770,7 @@ function createDurationChangeCompletions(durationChange, offset, endOfDurationCh
     else if (durationChange.properties &&
         durationChange.properties.start.offset < offset &&
         durationChange.properties.end.offset) {
-        const endOfProperties = durationChange.properties?.closeBrace?.start.offset ?? endOfDurationChange;
+        const endOfProperties = durationChange.properties?.closeBrace?.start?.offset ?? endOfDurationChange;
         completions.push(...createPropertiesCompletions(durationChange.properties, offset, durationChangeProperties, endOfProperties));
     }
     return completions;
@@ -5627,7 +5778,7 @@ function createDurationChangeCompletions(durationChange, offset, endOfDurationCh
 function createNoteCompletions(beat, note, offset, endOfNote) {
     const completions = [];
     if (note.noteEffects && note.noteEffects.start.offset < offset && note.noteEffects.end.offset) {
-        const endOfProperties = note.noteEffects.closeBrace?.start.offset ?? endOfNote;
+        const endOfProperties = note.noteEffects.closeBrace?.start?.offset ?? endOfNote;
         if (beat.notes.notes.length === 1) {
             completions.splice(0, 0, ...createPropertiesCompletions(note.noteEffects, offset, beatProperties, endOfProperties));
         }
@@ -5741,13 +5892,13 @@ function createMetaDataCompletions(barIndex, metaData, offset, endOfMetaData) {
     if (!metaDataDocs) {
         return completions;
     }
-    const endOfArguments = metaData.arguments?.closeParenthesis?.start.offset ??
-        metaData.arguments?.end.offset ??
-        metaData.properties?.start.offset ??
+    const endOfArguments = metaData.arguments?.closeParenthesis?.start?.offset ??
+        metaData.arguments?.end?.offset ??
+        metaData.properties?.start?.offset ??
         endOfMetaData;
     completions.splice(0, 0, ...createArgumentCompletions(metaDataDocs.signatures, metaData.arguments, offset, endOfArguments));
     if (metaDataDocs?.properties) {
-        const endOfProperties = metaData.properties?.closeBrace?.start.offset ?? endOfMetaData;
+        const endOfProperties = metaData.properties?.closeBrace?.start?.offset ?? endOfMetaData;
         completions.splice(0, 0, ...createPropertiesCompletions(metaData.properties, offset, metaDataDocs.properties, endOfProperties));
     }
     return completions;
@@ -6192,7 +6343,7 @@ function createMetaDataSignatureHelp(metaData, offset) {
     if (!metaDataDocs) {
         return null;
     }
-    const endOfValues = metaData.arguments?.end.offset ?? metaData.properties?.start.offset ?? metaData.end.offset;
+    const endOfValues = metaData.arguments?.end?.offset ?? metaData.properties?.start?.offset ?? metaData.end.offset;
     if (metaData.start.offset <= offset && offset < endOfValues) {
         return createArgumentsSignatureHelp(`\\${metaData.tag.tag.text}`, metaDataDocs, metaData.arguments, offset);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@coderline/alphatab-monaco",
-    "version": "1.8.0-alpha.1669",
+    "version": "1.8.0-alpha.1671",
     "description": "A Monaco editor integration for alphaTab providing coding assistance for alphaTex.",
     "keywords": [
         "guitar",
@@ -31,15 +31,15 @@
         "test": "mocha"
     },
     "dependencies": {
-        "@coderline/alphatab": "^1.8.0-alpha.1669",
-        "@coderline/alphatab-language-server": "^1.8.0-alpha.1669",
+        "@coderline/alphatab": "^1.8.0-alpha.1671",
+        "@coderline/alphatab-language-server": "^1.8.0-alpha.1671",
         "monaco-editor": "^0.55.1",
         "vscode-languageserver-types": "^3.17.5",
         "vscode-oniguruma": "^2.0.1",
         "vscode-textmate": "^9.3.0"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.2.6",
+        "@biomejs/biome": "^2.3.11",
         "@microsoft/api-extractor": "^7.55.2",
         "@types/chai": "^5.2.2",
         "@types/mocha": "^10.0.10",