@thijshakkenberg/valkyrie-mom-mcp 1.0.0

package/dist/tools/upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../src/tools/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAmGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAE1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAEzG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAE1G;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAE1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAEzG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAE3G;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAEvG"}

package/dist/tools/upsert.js

@@ -0,0 +1,91 @@
+const COMPONENT_CONFIGS = {
+    Event: { prefix: 'Event', checkLocalization: true },
+    Tile: { prefix: 'Tile', requiredFields: ['side'] },
+    Token: { prefix: 'Token', requiredFields: ['type'] },
+    Spawn: { prefix: 'Spawn' },
+    QItem: { prefix: 'QItem' },
+    Puzzle: { prefix: 'Puzzle' },
+    UI: { prefix: 'UI' },
+};
+function prefixError(name, expected) {
+    return {
+        rule: 'prefix',
+        severity: 'error',
+        message: `Name "${name}" must start with "${expected}"`,
+        component: name,
+    };
+}
+function requiredFieldError(name, field) {
+    return {
+        rule: 'required_field',
+        severity: 'error',
+        message: `Field "${field}" is required for ${name}`,
+        component: name,
+        field,
+    };
+}
+function localizationWarning(name, key) {
+    return {
+        rule: 'localization',
+        severity: 'warning',
+        message: `Missing localization key "${key}" for ${name}`,
+        component: name,
+    };
+}
+function checkEventLocalization(model, name, data) {
+    const warnings = [];
+    const merged = model.get(name);
+    const display = data.display ?? merged?.data.display;
+    if (display === 'false')
+        return warnings;
+    const textKey = `${name}.text`;
+    if (!model.localization.has(textKey)) {
+        warnings.push(localizationWarning(name, textKey));
+    }
+    return warnings;
+}
+function upsertGeneric(model, name, data, config) {
+    const errors = [];
+    const warnings = [];
+    if (!name.startsWith(config.prefix)) {
+        errors.push(prefixError(name, config.prefix));
+        return { success: false, warnings, errors };
+    }
+    if (config.requiredFields) {
+        for (const field of config.requiredFields) {
+            const existing = model.get(name);
+            const mergedValue = data[field] ?? existing?.data[field];
+            if (!mergedValue) {
+                errors.push(requiredFieldError(name, field));
+                return { success: false, warnings, errors };
+            }
+        }
+    }
+    model.upsert(name, data);
+    if (config.checkLocalization) {
+        warnings.push(...checkEventLocalization(model, name, data));
+    }
+    return { success: true, warnings, errors };
+}
+export function upsertEvent(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.Event);
+}
+export function upsertTile(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.Tile);
+}
+export function upsertToken(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.Token);
+}
+export function upsertSpawn(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.Spawn);
+}
+export function upsertItem(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.QItem);
+}
+export function upsertPuzzle(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.Puzzle);
+}
+export function upsertUI(model, name, data) {
+    return upsertGeneric(model, name, data, COMPONENT_CONFIGS.UI);
+}
+//# sourceMappingURL=upsert.js.map

package/dist/tools/upsert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.js","sourceRoot":"","sources":["../../src/tools/upsert.ts"],"names":[],"mappings":"AAgBA,MAAM,iBAAiB,GAAoC;IACzD,KAAK,EAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE;IACpD,IAAI,EAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE;IACpD,KAAK,EAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE;IACrD,KAAK,EAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3B,KAAK,EAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3B,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5B,EAAE,EAAM,EAAE,MAAM,EAAE,IAAI,EAAE;CACzB,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY,EAAE,QAAgB;IACjD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,SAAS,IAAI,sBAAsB,QAAQ,GAAG;QACvD,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAa;IACrD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,UAAU,KAAK,qBAAqB,IAAI,EAAE;QACnD,SAAS,EAAE,IAAI;QACf,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,GAAW;IACpD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,6BAA6B,GAAG,SAAS,IAAI,EAAE;QACxD,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAoB,EACpB,IAAY,EACZ,IAA4B;IAE5B,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;IACrD,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IAEzC,MAAM,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CACpB,KAAoB,EACpB,IAAY,EACZ,IAA4B,EAC5B,MAAuB;IAEvB,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAEzB,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IAC1F,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IACzF,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IAC1F,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IAC1F,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IACzF,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IAC3F,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoB,EAAE,IAAY,EAAE,IAA4B;IACvF,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/validation/rules/catalog-references.d.ts

@@ -0,0 +1,14 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks that game content references exist in the catalog.
+ * - Tile `side` field -> must be a valid TileSide ID
+ * - Spawn `monster` field -> must be a valid Monster ID (or a CustomMonster defined in the scenario)
+ * - Any component `audio` field -> must be a valid Audio ID
+ *
+ * All issues are **warnings** (not errors) because custom scenarios may define
+ * their own content names that aren't in the standard catalogs.
+ * Exception: invalid tile sides are **errors** because they crash Valkyrie.
+ */
+export declare function checkCatalogReferences(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=catalog-references.d.ts.map

package/dist/validation/rules/catalog-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-references.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/catalog-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CA+E/E"}

package/dist/validation/rules/catalog-references.js

@@ -0,0 +1,90 @@
+import { parseRefList } from '../../model/component-types.js';
+import { getSharedCatalog } from '../../catalogs/catalog-store.js';
+/**
+ * Checks that game content references exist in the catalog.
+ * - Tile `side` field -> must be a valid TileSide ID
+ * - Spawn `monster` field -> must be a valid Monster ID (or a CustomMonster defined in the scenario)
+ * - Any component `audio` field -> must be a valid Audio ID
+ *
+ * All issues are **warnings** (not errors) because custom scenarios may define
+ * their own content names that aren't in the standard catalogs.
+ * Exception: invalid tile sides are **errors** because they crash Valkyrie.
+ */
+export function checkCatalogReferences(model) {
+    const results = [];
+    const catalog = getSharedCatalog();
+    const tileIds = catalog.getAllIds('tile');
+    const monsterIds = catalog.getAllIds('monster');
+    const audioIds = catalog.getAllIds('audio');
+    const itemIds = catalog.getAllIds('item');
+    // Collect CustomMonster names defined in the scenario
+    const customMonsterNames = new Set(model.getByType('CustomMonster').map(c => c.name));
+    // Check tile side fields
+    for (const comp of model.getByType('Tile')) {
+        const side = comp.data.side;
+        if (!side)
+            continue;
+        if (!tileIds.has(side)) {
+            results.push({
+                rule: 'catalog-references',
+                severity: 'error',
+                message: `Tile "${comp.name}" references unknown tile side "${side}" — invalid sides crash Valkyrie`,
+                component: comp.name,
+                field: 'side',
+            });
+        }
+    }
+    // Check spawn monster fields (space-separated list)
+    for (const comp of model.getByType('Spawn')) {
+        const monsterField = comp.data.monster;
+        if (!monsterField)
+            continue;
+        for (const name of parseRefList(monsterField)) {
+            if (monsterIds.has(name))
+                continue;
+            if (customMonsterNames.has(name))
+                continue;
+            results.push({
+                rule: 'catalog-references',
+                severity: 'warning',
+                message: `Spawn "${comp.name}" references unknown monster "${name}"`,
+                component: comp.name,
+                field: 'monster',
+            });
+        }
+    }
+    // Check audio fields on all components
+    for (const comp of model.getAll()) {
+        const audio = comp.data.audio;
+        if (!audio)
+            continue;
+        if (!audioIds.has(audio)) {
+            results.push({
+                rule: 'catalog-references',
+                severity: 'warning',
+                message: `Component "${comp.name}" references unknown audio "${audio}"`,
+                component: comp.name,
+                field: 'audio',
+            });
+        }
+    }
+    // Check QItem itemname fields (space-separated list of item catalog IDs)
+    for (const comp of model.getByType('QItem')) {
+        const itemname = comp.data.itemname;
+        if (!itemname)
+            continue;
+        for (const name of parseRefList(itemname)) {
+            if (!itemIds.has(name)) {
+                results.push({
+                    rule: 'catalog-references',
+                    severity: 'warning',
+                    message: `Item "${comp.name}" references unknown itemname "${name}" — use catalog IDs like ItemCommonKnife, ItemCommonKeroseneLantern`,
+                    component: comp.name,
+                    field: 'itemname',
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=catalog-references.js.map

package/dist/validation/rules/catalog-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-references.js","sourceRoot":"","sources":["../../../src/validation/rules/catalog-references.ts"],"names":[],"mappings":"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"}

package/dist/validation/rules/cross-references.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks that all component references point to existing components.
+ * Space-separated values are split and each ref checked individually.
+ * References to built-in game content (Monster*, Audio*, TileSide*) are skipped.
+ */
+export declare function checkCrossReferences(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=cross-references.d.ts.map

package/dist/validation/rules/cross-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-references.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/cross-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AASnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAyB7E"}

package/dist/validation/rules/cross-references.js

@@ -0,0 +1,37 @@
+import { REFERENCE_FIELDS, parseRefList } from '../../model/component-types.js';
+/** Prefixes for built-in game content that should not be flagged as missing */
+const BUILTIN_PREFIXES = ['Monster', 'Audio', 'TileSide'];
+function isBuiltin(ref) {
+    return BUILTIN_PREFIXES.some(prefix => ref.startsWith(prefix));
+}
+/**
+ * Checks that all component references point to existing components.
+ * Space-separated values are split and each ref checked individually.
+ * References to built-in game content (Monster*, Audio*, TileSide*) are skipped.
+ */
+export function checkCrossReferences(model) {
+    const results = [];
+    for (const comp of model.getAll()) {
+        for (const field of REFERENCE_FIELDS) {
+            const value = comp.data[field];
+            if (value === undefined || value.trim() === '')
+                continue;
+            const refs = parseRefList(value);
+            for (const ref of refs) {
+                if (isBuiltin(ref))
+                    continue;
+                if (!model.get(ref)) {
+                    results.push({
+                        rule: 'cross-references',
+                        severity: 'error',
+                        message: `"${comp.name}" field "${field}" references non-existent component "${ref}"`,
+                        component: comp.name,
+                        field,
+                    });
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=cross-references.js.map

package/dist/validation/rules/cross-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-references.js","sourceRoot":"","sources":["../../../src/validation/rules/cross-references.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGhF,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAE1D,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACvD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAS;YAEzD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,SAAS,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,kBAAkB;wBACxB,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,YAAY,KAAK,wCAAwC,GAAG,GAAG;wBACrF,SAAS,EAAE,IAAI,CAAC,IAAI;wBACpB,KAAK;qBACN,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/validation/rules/event-chain-utils.d.ts

@@ -0,0 +1,8 @@
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Walk the event chain from a starting event, collecting all events reachable
+ * via event1..event6 references (BFS). Stops after visiting maxNodes to prevent
+ * infinite loops in cyclic graphs.
+ */
+export declare function collectEventChain(model: ScenarioModel, startEventName: string, maxNodes?: number): string[];
+//# sourceMappingURL=event-chain-utils.d.ts.map

package/dist/validation/rules/event-chain-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-chain-utils.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/event-chain-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CAsBvG"}

package/dist/validation/rules/event-chain-utils.js

@@ -0,0 +1,30 @@
+import { EVENT_FIELDS, parseRefList } from '../../model/component-types.js';
+/**
+ * Walk the event chain from a starting event, collecting all events reachable
+ * via event1..event6 references (BFS). Stops after visiting maxNodes to prevent
+ * infinite loops in cyclic graphs.
+ */
+export function collectEventChain(model, startEventName, maxNodes = 10) {
+    const visited = new Set();
+    const queue = [startEventName];
+    while (queue.length > 0 && visited.size < maxNodes) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const comp = model.get(current);
+        if (!comp)
+            continue;
+        for (const field of EVENT_FIELDS) {
+            const val = comp.data[field];
+            if (!val)
+                continue;
+            for (const ref of parseRefList(val)) {
+                if (!visited.has(ref))
+                    queue.push(ref);
+            }
+        }
+    }
+    return [...visited];
+}
+//# sourceMappingURL=event-chain-utils.js.map

package/dist/validation/rules/event-chain-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-chain-utils.js","sourceRoot":"","sources":["../../../src/validation/rules/event-chain-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG5E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,cAAsB,EAAE,QAAQ,GAAG,EAAE;IAC3F,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QACnC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC"}

package/dist/validation/rules/event-flow.d.ts

@@ -0,0 +1,14 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks that the event chain from EventStart doesn't lead to a
+ * non-display dead-end where the player would be stuck with no
+ * visible interaction.
+ *
+ * Walks the "default path": follows event1 when no vartests,
+ * follows event2 (else/default branch) when vartests are present.
+ * Warns if the chain terminates at a display:false event with no
+ * outgoing event refs and no $end operation.
+ */
+export declare function checkEventFlow(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=event-flow.d.ts.map

package/dist/validation/rules/event-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-flow.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/event-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CA8EvE"}

package/dist/validation/rules/event-flow.js

@@ -0,0 +1,83 @@
+import { parseRefList } from '../../model/component-types.js';
+/**
+ * Checks that the event chain from EventStart doesn't lead to a
+ * non-display dead-end where the player would be stuck with no
+ * visible interaction.
+ *
+ * Walks the "default path": follows event1 when no vartests,
+ * follows event2 (else/default branch) when vartests are present.
+ * Warns if the chain terminates at a display:false event with no
+ * outgoing event refs and no $end operation.
+ */
+export function checkEventFlow(model) {
+    const results = [];
+    // Find the event with trigger=EventStart
+    const startComp = model.getAll().find(c => c.data.trigger === 'EventStart');
+    if (!startComp)
+        return results; // No start trigger — already caught by event-graph rule
+    const visited = new Set();
+    let current = startComp.name;
+    while (current && !visited.has(current)) {
+        visited.add(current);
+        const comp = model.get(current);
+        if (!comp)
+            break;
+        const hasEnd = comp.data.operations?.includes('$end');
+        if (hasEnd)
+            return results; // Scenario ends intentionally
+        const display = comp.data.display;
+        const isDisplayTrue = display === undefined || display.toLowerCase() !== 'false';
+        // Determine next event on the default path
+        let nextEvent = null;
+        if (comp.data.vartests) {
+            // When vartests present, event2 is the else/default path
+            const event2 = comp.data.event2;
+            if (event2) {
+                const refs = parseRefList(event2);
+                nextEvent = refs.length > 0 ? refs[0] : null;
+            }
+        }
+        else {
+            // No vartests — follow event1
+            const event1 = comp.data.event1;
+            if (event1) {
+                const refs = parseRefList(event1);
+                nextEvent = refs.length > 0 ? refs[0] : null;
+            }
+        }
+        if (!nextEvent) {
+            // Chain ends here
+            if (!isDisplayTrue) {
+                results.push({
+                    rule: 'event-flow',
+                    severity: 'warning',
+                    message: `Event chain from start reaches "${comp.name}" which is a non-display dead-end — player may be stuck with no visible interaction`,
+                    component: comp.name,
+                });
+            }
+            return results;
+        }
+        current = nextEvent;
+    }
+    // If we exited due to a cycle, check if we ever reached a display:true event
+    // Walk through visited events to see if any were display:true
+    if (current && visited.has(current)) {
+        // We hit a cycle — check the last event before the cycle
+        // The cycle itself means the player is stuck in a loop of non-display events
+        const comp = model.get(current);
+        if (comp) {
+            const display = comp.data.display;
+            const isDisplayTrue = display === undefined || display.toLowerCase() !== 'false';
+            if (!isDisplayTrue) {
+                results.push({
+                    rule: 'event-flow',
+                    severity: 'warning',
+                    message: `Event chain from start reaches "${comp.name}" which is a non-display dead-end — player may be stuck with no visible interaction`,
+                    component: comp.name,
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=event-flow.js.map

package/dist/validation/rules/event-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-flow.js","sourceRoot":"","sources":["../../../src/validation/rules/event-flow.ts"],"names":[],"mappings":"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"}

package/dist/validation/rules/event-graph.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks the event graph for structural issues:
+ * - Error: No component with trigger=EventStart
+ * - Warning: Unreachable events (no incoming refs and no trigger)
+ * - Warning: Dead-end events (no next-event refs and no $end operation)
+ */
+export declare function checkEventGraph(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=event-graph.d.ts.map

package/dist/validation/rules/event-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-graph.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/event-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAmDxE"}

package/dist/validation/rules/event-graph.js

@@ -0,0 +1,51 @@
+import { EVENT_FIELDS } from '../../model/component-types.js';
+/**
+ * Checks the event graph for structural issues:
+ * - Error: No component with trigger=EventStart
+ * - Warning: Unreachable events (no incoming refs and no trigger)
+ * - Warning: Dead-end events (no next-event refs and no $end operation)
+ */
+export function checkEventGraph(model) {
+    const results = [];
+    const allComponents = model.getAll();
+    // Check for EventStart trigger
+    const hasEventStart = allComponents.some(c => c.data.trigger === 'EventStart');
+    if (!hasEventStart) {
+        results.push({
+            rule: 'event-graph',
+            severity: 'error',
+            message: 'No component has trigger=EventStart; scenario cannot begin',
+        });
+    }
+    // Only check Event and Spawn components for graph analysis
+    const eventLikeComponents = allComponents.filter(c => c.name.startsWith('Event') || c.name.startsWith('Spawn'));
+    for (const comp of eventLikeComponents) {
+        // Check unreachable: no incoming refs AND no trigger
+        if (!comp.data.trigger) {
+            const incomingRefs = model.getReferencesTo(comp.name);
+            if (incomingRefs.length === 0) {
+                results.push({
+                    rule: 'event-graph',
+                    severity: 'warning',
+                    message: `"${comp.name}" is unreachable: no incoming references and no trigger`,
+                    component: comp.name,
+                });
+            }
+        }
+        // Check dead-end: only for Event components (not Spawn)
+        if (comp.name.startsWith('Event')) {
+            const hasEnd = comp.data.operations?.includes('$end');
+            const hasAnyEventField = EVENT_FIELDS.some(f => comp.data[f] !== undefined);
+            if (!hasEnd && !hasAnyEventField) {
+                results.push({
+                    rule: 'event-graph',
+                    severity: 'warning',
+                    message: `"${comp.name}" is a dead-end: no next-event references and no $end operation`,
+                    component: comp.name,
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=event-graph.js.map

package/dist/validation/rules/event-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-graph.js","sourceRoot":"","sources":["../../../src/validation/rules/event-graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAErC,+BAA+B;IAC/B,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC;IAC/E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,4DAA4D;SACtE,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAC9D,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,qDAAqD;QACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,yDAAyD;oBAC/E,SAAS,EAAE,IAAI,CAAC,IAAI;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAE5E,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,iEAAiE;oBACvF,SAAS,EAAE,IAAI,CAAC,IAAI;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/validation/rules/explore-token-pattern.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks explore token conventions from the MoM rulebook:
+ * - Warning: Explore token without event1
+ * - Warning: Explore token's event chain doesn't remove the token itself
+ * - Warning: Explore token's event chain doesn't add any Tile component
+ */
+export declare function checkExploreTokenPattern(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=explore-token-pattern.d.ts.map

package/dist/validation/rules/explore-token-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-token-pattern.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/explore-token-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAiEjF"}

package/dist/validation/rules/explore-token-pattern.js

@@ -0,0 +1,70 @@
+import { parseRefList } from '../../model/component-types.js';
+import { collectEventChain } from './event-chain-utils.js';
+/**
+ * Checks explore token conventions from the MoM rulebook:
+ * - Warning: Explore token without event1
+ * - Warning: Explore token's event chain doesn't remove the token itself
+ * - Warning: Explore token's event chain doesn't add any Tile component
+ */
+export function checkExploreTokenPattern(model) {
+    const results = [];
+    const tokens = model.getAll().filter(c => c.name.startsWith('Token') && c.data.type === 'TokenExplore');
+    for (const token of tokens) {
+        const event1 = token.data.event1;
+        // Check: explore token must have event1
+        if (!event1) {
+            results.push({
+                rule: 'explore-token-pattern',
+                severity: 'warning',
+                message: `"${token.name}" is an explore token without event1 — nothing happens on exploration`,
+                component: token.name,
+                field: 'event1',
+            });
+            continue;
+        }
+        // Walk the event chain from event1
+        const chain = collectEventChain(model, event1);
+        // Check: event chain should remove the token itself
+        let removesToken = false;
+        for (const eventName of chain) {
+            const comp = model.get(eventName);
+            if (!comp)
+                continue;
+            if (parseRefList(comp.data.remove ?? '').includes(token.name)) {
+                removesToken = true;
+                break;
+            }
+        }
+        if (!removesToken) {
+            results.push({
+                rule: 'explore-token-pattern',
+                severity: 'warning',
+                message: `"${token.name}" explore event chain does not remove the token — token stays after exploration`,
+                component: token.name,
+                field: 'remove',
+            });
+        }
+        // Check: event chain should add at least one Tile
+        let addsTile = false;
+        for (const eventName of chain) {
+            const comp = model.get(eventName);
+            if (!comp)
+                continue;
+            if (parseRefList(comp.data.add ?? '').some(r => r.startsWith('Tile'))) {
+                addsTile = true;
+                break;
+            }
+        }
+        if (!addsTile) {
+            results.push({
+                rule: 'explore-token-pattern',
+                severity: 'warning',
+                message: `"${token.name}" explore event chain does not add any Tile — explore tokens typically reveal new tiles`,
+                component: token.name,
+                field: 'add',
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=explore-token-pattern.js.map

package/dist/validation/rules/explore-token-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-token-pattern.js","sourceRoot":"","sources":["../../../src/validation/rules/explore-token-pattern.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoB;IAC3D,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IAExG,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAEjC,wCAAwC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,uBAAuB;gBAC7B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,uEAAuE;gBAC9F,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,mCAAmC;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE/C,oDAAoD;QACpD,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,uBAAuB;gBAC7B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,iFAAiF;gBACxG,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;QAED,kDAAkD;QAClD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACtE,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,uBAAuB;gBAC7B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,yFAAyF;gBAChH,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/validation/rules/format-rules.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from '../../model/component-types.js';
+import type { ScenarioModel } from '../../model/scenario-model.js';
+/**
+ * Checks format-level rules:
+ * - format must be in range 4-19
+ * - type must be 'MoM'
+ * - tile rotation must be in {0, 90, 180, 270}
+ */
+export declare function checkFormatRules(model: ScenarioModel): ValidationResult[];
+//# sourceMappingURL=format-rules.d.ts.map

package/dist/validation/rules/format-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-rules.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/format-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAInE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAyDzE"}