@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/mwl/hooks.d.ts

@@ -1,201 +0,0 @@
-import type { MwlCompiledGame, MwlCompiledNode } from './compiler.ts';
-import type { MwlDiagnostic, MwlLocation } from './grammar.ts';
-import { type MwlAttributeType, type MwlValueType } from './schema.ts';
-import type { MwlValue } from './runtime.ts';
-/**
- * The hook boundary described in the MWG architecture documentation. Hooks are the only
- * place JavaScript appears in MWL content. They are referenced by
- * `type:name`, resolved by the tooling, and bundled ahead of time; the runtime
- * never evaluates JavaScript from content.
- */
-export type BuiltinHookType = 'predicate' | 'modifier' | 'generator' | 'command' | 'ai' | 'migration';
-/** A built-in hook kind, or a domain kind declared by the game adapter. */
-export type HookType = BuiltinHookType | (string & {});
-/**
- * The hook kinds MWL content may reference, in the order the documentation lists them.
- *
- * @example
- * ```ts
- * import { hookTypes } from '@datamoc/mw_games/mwl';
- *
- * console.log(hookTypes.includes('predicate')); // true
- * ```
- */
-export declare const hookTypes: readonly HookType[];
-/** What a hook may read: a snapshot of the world, never engine internals. */
-export interface HookWorld {
-    readonly variables: Readonly<Record<string, MwlValue>>;
-    /**
-     * One variable by path, resolved by the same walker `[variable] name=` reads
-     * through, so a hook asks for `stored_naga.hitpoints` and gets what a
-     * scenario asking for `stored_naga.hitpoints` gets. Read here, write through
-     * `emit.setVariable`: both take a path, and neither is a flat dotted key.
-     */
-    variableAt(path: string): MwlValue | undefined;
-    readonly units: Readonly<Record<string, {
-        readonly hp: number;
-        readonly x: number;
-        readonly y: number;
-        readonly alive: boolean;
-        readonly type?: string;
-        /** the id `[side]` declared, the same key `world.sides` and `world.gold` use */
-        readonly side?: string;
-    }>>;
-    readonly sides: Readonly<Record<string, {
-        readonly gold: number;
-        readonly income: number;
-    }>>;
-    readonly turn: number;
-    /**
-     * A deterministic draw from the runtime's own seeded stream (`core.Generator`), so a
-     * `generator`/`ai`/domain hook that needs randomness never reaches for `Math.random()` and
-     * breaks save/replay determinism. Every draw advances the same stream the runtime persists.
-     */
-    readonly random: HookRandom;
-}
-/** The minimal draw surface a hook needs; never the `Generator` instance itself, which also
- * exposes state mutation a hook has no business performing. */
-export interface HookRandom {
-    /** a float in [0, 1), with 32 bits of resolution */
-    float(): number;
-    /** an integer in [0, bound), without modulo bias */
-    int(bound: number): number;
-}
-/** What a hook may ask the engine to do. This is the whole command surface. */
-export interface Emit {
-    move(unit: string, x: number, y: number): void;
-    attack(attacker: string, defender: string, weapon?: string): void;
-    spawn(type: string, side: string, x: number, y: number): void;
-    kill(unit: string): void;
-    gold(side: string, delta: number): void;
-    /** Writes one variable by path (`party[0].name`, `stored_naga.hitpoints`), the write
-     * `HookWorld.variableAt` reads back. Do not write `world.variables` directly. */
-    setVariable(name: string, value: MwlValue): void;
-    message(speaker: string, text: string): void;
-    endTurn(): void;
-    win(side: string): void;
-    lose(side: string): void;
-}
-export type HookContext = Readonly<Record<string, string>>;
-export type PredicateHook = (world: HookWorld, context: HookContext) => boolean;
-export type ModifierHook = (value: number, world: HookWorld, context: HookContext) => number;
-export type GeneratorHook = (world: HookWorld, context: HookContext) => unknown;
-export type CommandHook = (world: HookWorld, emit: Emit, context: HookContext) => void;
-export type AiHook = (world: HookWorld, emit: Emit, context: HookContext) => void;
-export type MigrationHook = (saved: unknown, context: HookContext) => unknown;
-/**
- * A game-owned hook. MWG transports and types the boundary, but does not know the domain
- * context, input, output, or rules behind it.
- */
-export type MwlDomainHook<Context = unknown, Input = unknown, Output = unknown> = (context: Context, input: Input) => Output;
-/** A typed declaration for a domain hook namespace supplied by the game adapter. */
-export interface MwlDomainHookDeclaration<Context = unknown, Input = unknown, Output = unknown> {
-    readonly id: `${string}:${string}`;
-    readonly run: MwlDomainHook<Context, Input, Output>;
-}
-/** The game-owned registry shape. The keys remain the MWL `type:name` references. */
-export type MwlDomainHookRegistry<Context = unknown, Input = unknown, Output = unknown> = Readonly<Record<string, MwlDomainHook<Context, Input, Output>>>;
-/** A game-owned hook state adapter. Its value must be JSON-serialisable. */
-export interface MwlSaveableHookState {
-    readonly save: () => unknown;
-    readonly restore: (state: unknown) => void;
-}
-export interface HookTypeMap {
-    predicate: PredicateHook;
-    modifier: ModifierHook;
-    generator: GeneratorHook;
-    command: CommandHook;
-    ai: AiHook;
-    migration: MigrationHook;
-}
-export interface HookReference {
-    readonly type: HookType;
-    readonly name: string;
-    readonly location?: MwlLocation;
-}
-/**
- * Parse a `type:name` hook reference, or null when it does not match.
- *
- * @example
- * ```ts
- * import { parseHookReference } from '@datamoc/mw_games/mwl';
- *
- * console.log(parseHookReference('predicate:holds')); // { type: 'predicate', name: 'holds' }
- * console.log(parseHookReference('not-a-reference')); // null
- * ```
- */
-export declare function parseHookReference(value: string): {
-    type: HookType;
-    name: string;
-} | null;
-/**
- * Every hook a compiled game references, deduplicated by `type:name` and
- * ordered so the output is stable.
- *
- * @example
- * ```ts
- * import { collectHookReferences, type MwlCompiledGame } from '@datamoc/mw_games/mwl';
- *
- * declare const game: MwlCompiledGame;
- * console.log(collectHookReferences(game).map((reference) => `${reference.type}:${reference.name}`));
- * ```
- */
-export declare function collectHookReferences(game: MwlCompiledGame, hookAttributeNames?: readonly string[]): HookReference[];
-/**
- * What a hook says about the attributes its own `[hook]` calls carry. A hook's *name* is checked
- * at compile time already; without this its attributes are not, so a typo in one of a
- * command hook's 18 modes is only discovered at the moment the scenario runs it.
- *
- * The declaration is the hook's, not the tag's: MWG checks `[hook]` invocations, where every
- * attribute but `name` belongs to the hook. A `hook=` attribute on a condition-bearing tag
- * (`[victory] hook=predicate:holds value=3`) keeps that tag's own schema and this does not
- * apply, since `value` there is the condition's to define.
- */
-export interface MwlHookDeclaration {
-    /** the `type:name` id, the same string `MwlHookRegistry` keys an implementation by */
-    readonly id: string;
-    /** fixed attributes, name -> value type; an attribute not named here is unknown */
-    readonly attributes?: Readonly<Record<string, MwlAttributeType>>;
-    /** when set, any attribute name is accepted and every value is checked as this type */
-    readonly openAttributes?: MwlValueType;
-}
-/**
- * Check one `[hook]` call's own attributes against its declaration. Returns nothing for a hook
- * the game declares without attributes: an undeclared shape is not this function's to invent.
- *
- * @example
- * ```ts
- * import { validateHookAttributes } from '@datamoc/mw_games/mwl';
- *
- * const node = { tag: 'hook', attributes: { name: 'command:mark', value: 'ok' }, children: [], location: undefined };
- * console.log(validateHookAttributes(node, { id: 'command:mark', attributes: { value: 'string' } })); // []
- * ```
- */
-export declare function validateHookAttributes(node: MwlCompiledNode, declaration: MwlHookDeclaration): MwlDiagnostic[];
-/**
- * Report a reference that has no implementation, using the same diagnostic
- * shape as the schema validator. `available` holds `type:name` keys.
- *
- * @example
- * ```ts
- * import { parseHookReference, validateHookReferences } from '@datamoc/mw_games/mwl';
- *
- * const reference = parseHookReference('predicate:holds');
- * console.log(validateHookReferences(reference ? [reference] : [], ['predicate:holds'])); // []
- * ```
- */
-export declare function validateHookReferences(references: readonly HookReference[], available: Iterable<string>): MwlDiagnostic[];
-/**
- * Emit the declaration a hooks module must satisfy, so a project typechecks its
- * hooks against the exact references its content uses.
- *
- * @example
- * ```ts
- * import { emitHooksDeclaration, parseHookReference } from '@datamoc/mw_games/mwl';
- *
- * const reference = parseHookReference('predicate:holds');
- * console.log(emitHooksDeclaration(reference ? [reference] : []).includes("'predicate:holds'"));
- * ```
- */
-export declare function emitHooksDeclaration(references: readonly HookReference[]): string;
-//# sourceMappingURL=hooks.d.ts.map

package/dist/mwl/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/mwl/hooks.ts"],"names":[],"mappings":"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"}

package/dist/mwl/hooks.js

@@ -1,165 +0,0 @@
-import { attributeTypeDescription, validAttributeValue } from './schema.js';
-const hookNamePattern = /^[A-Za-z_][\w-]*$/;
-/**
- * The hook kinds MWL content may reference, in the order the documentation lists them.
- *
- * @example
- * ```ts
- * import { hookTypes } from '@datamoc/mw_games/mwl';
- *
- * console.log(hookTypes.includes('predicate')); // true
- * ```
- */
-export const hookTypes = ['predicate', 'modifier', 'generator', 'command', 'ai', 'migration'];
-/**
- * Parse a `type:name` hook reference, or null when it does not match.
- *
- * @example
- * ```ts
- * import { parseHookReference } from '@datamoc/mw_games/mwl';
- *
- * console.log(parseHookReference('predicate:holds')); // { type: 'predicate', name: 'holds' }
- * console.log(parseHookReference('not-a-reference')); // null
- * ```
- */
-export function parseHookReference(value) {
-    const separator = value.indexOf(':');
-    if (separator <= 0)
-        return null;
-    const type = value.slice(0, separator);
-    const name = value.slice(separator + 1).trim();
-    if (!hookNamePattern.test(type) || !hookNamePattern.test(name))
-        return null;
-    return { type, name };
-}
-/**
- * Every hook a compiled game references, deduplicated by `type:name` and
- * ordered so the output is stable.
- *
- * @example
- * ```ts
- * import { collectHookReferences, type MwlCompiledGame } from '@datamoc/mw_games/mwl';
- *
- * declare const game: MwlCompiledGame;
- * console.log(collectHookReferences(game).map((reference) => `${reference.type}:${reference.name}`));
- * ```
- */
-export function collectHookReferences(game, hookAttributeNames = ['hook', 'migration']) {
-    const found = new Map();
-    const attributes = new Set(hookAttributeNames);
-    const visit = (node) => {
-        for (const [key, value] of Object.entries(node.attributes)) {
-            if (attributes.has(key))
-                add(value, node.location);
-            // A `[hook]` call carries its reference in `name`.
-            if (node.tag === 'hook' && key === 'name')
-                add(value, node.location);
-        }
-        node.children.forEach(visit);
-    };
-    const add = (value, location) => {
-        const reference = parseHookReference(value);
-        if (!reference)
-            return;
-        const id = `${reference.type}:${reference.name}`;
-        if (!found.has(id))
-            found.set(id, { ...reference, location });
-    };
-    game.roots.forEach(visit);
-    return [...found.values()].sort((a, b) => a.type.localeCompare(b.type) || a.name.localeCompare(b.name));
-}
-/**
- * Check one `[hook]` call's own attributes against its declaration. Returns nothing for a hook
- * the game declares without attributes: an undeclared shape is not this function's to invent.
- *
- * @example
- * ```ts
- * import { validateHookAttributes } from '@datamoc/mw_games/mwl';
- *
- * const node = { tag: 'hook', attributes: { name: 'command:mark', value: 'ok' }, children: [], location: undefined };
- * console.log(validateHookAttributes(node, { id: 'command:mark', attributes: { value: 'string' } })); // []
- * ```
- */
-export function validateHookAttributes(node, declaration) {
-    // A hook declared by id alone claims nothing about its attributes, so there is nothing to
-    // check against: what a hook with no vocabulary would accept is its own business.
-    if (declaration.attributes === undefined && declaration.openAttributes === undefined)
-        return [];
-    const location = node.location ?? { file: '<hook>', line: 0, column: 0 };
-    const diagnostics = [];
-    for (const [name, value] of Object.entries(node.attributes)) {
-        if (name === 'name')
-            continue;
-        const type = declaration.attributes?.[name] ?? declaration.openAttributes;
-        if (type === undefined) {
-            diagnostics.push({
-                code: 'MWL_UNKNOWN_ATTRIBUTE',
-                message: `unknown attribute ${name} on hook ${declaration.id}`,
-                location,
-            });
-            continue;
-        }
-        if (!validAttributeValue(value, type))
-            diagnostics.push({
-                code: 'MWL_VALUE',
-                message: `${name} must be ${attributeTypeDescription(type)} on hook ${declaration.id}`,
-                location,
-            });
-    }
-    return diagnostics;
-}
-/**
- * Report a reference that has no implementation, using the same diagnostic
- * shape as the schema validator. `available` holds `type:name` keys.
- *
- * @example
- * ```ts
- * import { parseHookReference, validateHookReferences } from '@datamoc/mw_games/mwl';
- *
- * const reference = parseHookReference('predicate:holds');
- * console.log(validateHookReferences(reference ? [reference] : [], ['predicate:holds'])); // []
- * ```
- */
-export function validateHookReferences(references, available) {
-    const implemented = new Set(available);
-    const diagnostics = [];
-    for (const reference of references) {
-        const id = `${reference.type}:${reference.name}`;
-        if (!implemented.has(id))
-            diagnostics.push({
-                code: 'MWL_HOOK',
-                message: `hook ${id} is not implemented`,
-                location: reference.location ?? { file: '<hook>', line: 0, column: 0 },
-            });
-    }
-    return diagnostics;
-}
-/**
- * Emit the declaration a hooks module must satisfy, so a project typechecks its
- * hooks against the exact references its content uses.
- *
- * @example
- * ```ts
- * import { emitHooksDeclaration, parseHookReference } from '@datamoc/mw_games/mwl';
- *
- * const reference = parseHookReference('predicate:holds');
- * console.log(emitHooksDeclaration(reference ? [reference] : []).includes("'predicate:holds'"));
- * ```
- */
-export function emitHooksDeclaration(references) {
-    const lines = [];
-    lines.push('// Generated by mwl - do not edit.');
-    lines.push("import type { AiHook, CommandHook, GeneratorHook, MigrationHook, ModifierHook, PredicateHook } from '@datamoc/mw_games/mwl';");
-    lines.push('');
-    lines.push('export interface MwlHooks {');
-    for (const reference of references) {
-        const hookType = hookTypes.includes(reference.type)
-            ? `${reference.type[0].toUpperCase()}${reference.type.slice(1)}Hook`
-            : 'MwlDomainHook';
-        lines.push(`\t'${reference.type}:${reference.name}': ${hookType};`);
-    }
-    lines.push('}');
-    lines.push('');
-    return lines.join('\n');
-}
-//# sourceMappingURL=hooks.js.map

package/dist/mwl/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/mwl/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAA4C,MAAM,aAAa,CAAC;AAYtH,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AA6GnH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAa,CAAC;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAqB,EACrB,kBAAkB,GAAsB,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,IAAqB,EAAQ,EAAE;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,mDAAmD;YACnD,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM;gBAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,QAAsB,EAAQ,EAAE;QAC3D,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzG,CAAC;AAqBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAqB,EAAE,WAA+B;IAC5F,0FAA0F;IAC1F,kFAAkF;IAClF,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,IAAI,WAAW,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAChG,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACzE,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,IAAI,IAAI,KAAK,MAAM;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,cAAc,CAAC;QAC1E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,qBAAqB,IAAI,YAAY,WAAW,CAAC,EAAE,EAAE;gBAC9D,QAAQ;aACR,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;YACpC,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,GAAG,IAAI,YAAY,wBAAwB,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,EAAE,EAAE;gBACtF,QAAQ;aACR,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACrC,UAAoC,EACpC,SAA2B;IAE3B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,QAAQ,EAAE,qBAAqB;gBACxC,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;aACtE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAoC;IACxE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CACT,8HAA8H,CAC9H,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAuB,CAAC;YACrE,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;YACpE,CAAC,CAAC,eAAe,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/mwl/index.d.ts

@@ -1,51 +0,0 @@
-export { MwlSyntaxError, isGettext, parse, parseValue, preprocess } from './grammar.ts';
-export type { MwlDiagnostic, MwlLocation, MwlNode, MwlPreprocessOptions } from './grammar.ts';
-export { parseMapFile } from './MapFile.ts';
-export type { MwlMapFile } from './MapFile.ts';
-export { attributeTypeDescription, coerceTableValue, isMwlId, MWL_SCHEMA_01, MWL_SCHEMA_10, parseTableColumns, schema01, schema10, validAttributeValue, validate, } from './schema.ts';
-export type { MwlAttributeType, MwlTableColumn, MwlTagSchema, MwlValueType } from './schema.ts';
-export { compile, compileAndEmitSources, compileNodes, compileSources, emitArtifacts, emitModule, extractCatalog, } from './compiler.ts';
-export type { MwlArtifact, MwlCatalog, MwlCatalogOptions, MwlCompileOptions, MwlCompiledGame, MwlCompiledNode, MwlEmitOptions, MwlSourceFile, } from './compiler.ts';
-export { collectHookReferences, emitHooksDeclaration, hookTypes, parseHookReference, validateHookAttributes, validateHookReferences, } from './hooks.ts';
-export type { AiHook, CommandHook, Emit, GeneratorHook, HookContext, HookRandom, HookReference, HookType, HookTypeMap, HookWorld, BuiltinHookType, MwlDomainHook, MwlDomainHookDeclaration, MwlDomainHookRegistry, MwlSaveableHookState, MwlHookDeclaration, MigrationHook, ModifierHook, PredicateHook, } from './hooks.ts';
-export { createWorld, execute, MwlRuntime, parseTerrain, sideVisionGroups } from './runtime.ts';
-export type { MwlCommand, MwlDialogueChoice, MwlHookRegistry, MwlMap, MwlMapStart, MwlMessage, MwlRuntimeOptions, MwlRuntimeAction, MwlTraceEvent, MwlValue, MwlWorld, } from './runtime.ts';
-export { carryoverIntoScenario, endLevelCarryover, MWL_DEFAULT_CARRYOVER_PERCENTAGE } from './carryover.ts';
-export type { MwlCarryover, MwlEndLevel, MwlSideRef } from './carryover.ts';
-export { campaignChain } from './campaign.ts';
-export type { MwlCampaignChain, MwlScenarioRunner } from './campaign.ts';
-export { contentCatalog } from './content.ts';
-export { nodesToObjects } from './objects.ts';
-export type { MwlObject } from './objects.ts';
-export { emitTableTypes, typedRows } from './tables.ts';
-export type { EmitTableTypesOptions, MwlColumnValueType, MwlTypedRow } from './tables.ts';
-export type { MwlCampaignDefinition, MwlScenarioLink } from './content.ts';
-export type { MwlContentCatalog, MwlEffectDefinition, MwlAiDefinition, MwlBehaviorDefinition, MwlEvolutionDefinition, MwlItemDefinition, MwlLootDefinition, MwlMonsterDefinition, MwlMoveDefinition, MwlStatusDefinition, MwlTableDefinition, MwlTurnClockDefinition, MwlTypeMatchupDefinition, } from './content.ts';
-export { evaluateExpression, parseExpression } from './expression.ts';
-export type { MwlExpression, MwlExpressionContext } from './expression.ts';
-export { composeEffects, effectToModifier, inventoryItem, itemDefinition } from './actors.ts';
-export type { MwlActorItem, MwlEquipment } from './actors.ts';
-export { validateCatalog, validateCatalogNodes } from './catalog.ts';
-export type { MwlTableReference, MwlValidationOptions } from './catalog.ts';
-export { decodeSave, decodeSaveEnvelope, encodeSave, validateWorld } from './persistence.ts';
-export type { MwlMigration, MwlPersistenceOptions, MwlSaveEnvelope } from './persistence.ts';
-export { contentReport, loadContent } from './report.ts';
-export type { MwlContentDiagnostic, MwlContentLoadReport, MwlContentReport } from './report.ts';
-export { readAttributes, readChildren, readTableIndex, readTableMap, tableKey } from './readers.ts';
-export type { MwlFieldSpec, MwlReadResult, MwlReaderType, MwlTableKey, MwlTableKeyPart, MwlTableMapOptions, } from './readers.ts';
-export { createExpressionScriptHost } from './scripts.ts';
-export type { ScriptContext, ScriptEmit, ScriptHost, ScriptValue } from './scripts.ts';
-export { evaluateCondition } from './conditions.ts';
-export type { MwlConditionContext, MwlConditionHelper, MwlConditionOptions, MwlConditionValue } from './conditions.ts';
-export { checkConditionSyntax } from './conditions.ts';
-export { checkPackagePath, decodePackage, DEFAULT_PACKAGE_LIMITS, encodePackage, PackageError, PackageFormatError, PackageIntegrityError, PackageLimitError, PackagePathError, sha256Hex, } from './package-container.ts';
-export type { DecodedPackage, PackageDirectoryEntry, PackageFile, PackageLimits } from './package-container.ts';
-export { compareVersions, KNOWN_PACKAGE_CAPABILITIES, PACKAGE_ASSET_KINDS, PACKAGE_MEDIA_KINDS, PACKAGE_SCRIPT_ACTIONS, PACKAGE_TAGS, parsePackageDocument, satisfiesVersionRange, } from './package-document.ts';
-export type { PackageAction, PackageAnimation, PackageAsset, PackageAssetKind, PackageCharacter, PackageDocument, PackageImport, PackageMeta, PackageMusic, PackageRequires, PackageScript, PackageSoundEffect, PackageValue, } from './package-document.ts';
-export { checkPackagePolicy, compilePackages, generateCredits, loadPackage, mergePackage, packageContent, PackageConflictError, packageRef, parsePackageRef, requestedCapabilities, } from './package.ts';
-export type { LoadedPackage, PackageContent, PackagePolicy, PackageSet } from './package.ts';
-export { detectRomImage, registerRomDigest } from './package-rom.ts';
-export type { RomDetection } from './package-rom.ts';
-export { verifyPackage } from './package-verify.ts';
-export type { PackageReport, VerifyPackageOptions } from './package-verify.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/mwl/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mwl/index.ts"],"names":[],"mappings":"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"}

package/dist/mwl/index.js

@@ -1,26 +0,0 @@
-export { MwlSyntaxError, isGettext, parse, parseValue, preprocess } from './grammar.js';
-export { parseMapFile } from './MapFile.js';
-export { attributeTypeDescription, coerceTableValue, isMwlId, MWL_SCHEMA_01, MWL_SCHEMA_10, parseTableColumns, schema01, schema10, validAttributeValue, validate, } from './schema.js';
-export { compile, compileAndEmitSources, compileNodes, compileSources, emitArtifacts, emitModule, extractCatalog, } from './compiler.js';
-export { collectHookReferences, emitHooksDeclaration, hookTypes, parseHookReference, validateHookAttributes, validateHookReferences, } from './hooks.js';
-export { createWorld, execute, MwlRuntime, parseTerrain, sideVisionGroups } from './runtime.js';
-export { carryoverIntoScenario, endLevelCarryover, MWL_DEFAULT_CARRYOVER_PERCENTAGE } from './carryover.js';
-export { campaignChain } from './campaign.js';
-export { contentCatalog } from './content.js';
-export { nodesToObjects } from './objects.js';
-export { emitTableTypes, typedRows } from './tables.js';
-export { evaluateExpression, parseExpression } from './expression.js';
-export { composeEffects, effectToModifier, inventoryItem, itemDefinition } from './actors.js';
-export { validateCatalog, validateCatalogNodes } from './catalog.js';
-export { decodeSave, decodeSaveEnvelope, encodeSave, validateWorld } from './persistence.js';
-export { contentReport, loadContent } from './report.js';
-export { readAttributes, readChildren, readTableIndex, readTableMap, tableKey } from './readers.js';
-export { createExpressionScriptHost } from './scripts.js';
-export { evaluateCondition } from './conditions.js';
-export { checkConditionSyntax } from './conditions.js';
-export { checkPackagePath, decodePackage, DEFAULT_PACKAGE_LIMITS, encodePackage, PackageError, PackageFormatError, PackageIntegrityError, PackageLimitError, PackagePathError, sha256Hex, } from './package-container.js';
-export { compareVersions, KNOWN_PACKAGE_CAPABILITIES, PACKAGE_ASSET_KINDS, PACKAGE_MEDIA_KINDS, PACKAGE_SCRIPT_ACTIONS, PACKAGE_TAGS, parsePackageDocument, satisfiesVersionRange, } from './package-document.js';
-export { checkPackagePolicy, compilePackages, generateCredits, loadPackage, mergePackage, packageContent, PackageConflictError, packageRef, parsePackageRef, requestedCapabilities, } from './package.js';
-export { detectRomImage, registerRomDigest } from './package-rom.js';
-export { verifyPackage } from './package-verify.js';
-//# sourceMappingURL=index.js.map

package/dist/mwl/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mwl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,QAAQ,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,OAAO,EACP,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,GACd,MAAM,eAAe,CAAC;AAWvB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,YAAY,CAAC;AAsBpB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAchG,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAE5G,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkBxD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AASpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACT,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,GACrB,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,qBAAqB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mwl/objects.d.ts

@@ -1,31 +0,0 @@
-import type { MwlCompiledNode } from './compiler.ts';
-import type { MwlReadResult } from './readers.ts';
-import { type MwlTagSchema } from './schema.ts';
-/** Plain JSON output of a schema-directed node conversion. Child tags become fields. */
-export interface MwlObject {
-    [key: string]: string | number | boolean | MwlObject | MwlObject[];
-}
-/**
- * Converts compiled nodes into plain objects using the same schema as `compile`.
- * Attributes become fields; numbers and booleans are converted by their declared types.
- * Children are grouped by tag in source order. A tag with `cardinality.max: 1` becomes
- * one object, otherwise an array. Absent children and optional attributes stay absent.
- * Strings, references, enum values and coordinates stay strings. The result carries no
- * parser metadata and can be written directly as JSON. Diagnostics must be checked before use.
- *
- * @example
- * ```ts
- * import { compile, nodesToObjects } from '@datamoc/mw_games/mwl';
- * import type { MwlTagSchema } from '@datamoc/mw_games/mwl';
- * const schemas = {
- *   bridge: { attributes: { budget: 'number' }, children: ['anchor'] },
- *   anchor: { attributes: { x: 'number', fixed: 'boolean' }, children: [] },
- * } satisfies Record<string, MwlTagSchema>;
- * const game = compile("[{ tag: 'bridge', budget: 120, children: [{ tag: 'anchor', x: 4, fixed: true }] }]", { schemas });
- * const result = nodesToObjects(game.roots, schemas);
- * if (result.diagnostics.length) throw new Error(JSON.stringify(result.diagnostics));
- * console.log(result.value[0].budget); // 120 as a number
- * ```
- */
-export declare function nodesToObjects(nodes: readonly MwlCompiledNode[], schemas: Readonly<Record<string, MwlTagSchema>>): MwlReadResult<MwlObject[]>;
-//# sourceMappingURL=objects.d.ts.map

package/dist/mwl/objects.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/mwl/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAErE,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;CACnE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAC7C,aAAa,CAAC,SAAS,EAAE,CAAC,CAwD5B"}

package/dist/mwl/objects.js

@@ -1,83 +0,0 @@
-import { validAttributeValue } from './schema.js';
-/**
- * Converts compiled nodes into plain objects using the same schema as `compile`.
- * Attributes become fields; numbers and booleans are converted by their declared types.
- * Children are grouped by tag in source order. A tag with `cardinality.max: 1` becomes
- * one object, otherwise an array. Absent children and optional attributes stay absent.
- * Strings, references, enum values and coordinates stay strings. The result carries no
- * parser metadata and can be written directly as JSON. Diagnostics must be checked before use.
- *
- * @example
- * ```ts
- * import { compile, nodesToObjects } from '@datamoc/mw_games/mwl';
- * import type { MwlTagSchema } from '@datamoc/mw_games/mwl';
- * const schemas = {
- *   bridge: { attributes: { budget: 'number' }, children: ['anchor'] },
- *   anchor: { attributes: { x: 'number', fixed: 'boolean' }, children: [] },
- * } satisfies Record<string, MwlTagSchema>;
- * const game = compile("[{ tag: 'bridge', budget: 120, children: [{ tag: 'anchor', x: 4, fixed: true }] }]", { schemas });
- * const result = nodesToObjects(game.roots, schemas);
- * if (result.diagnostics.length) throw new Error(JSON.stringify(result.diagnostics));
- * console.log(result.value[0].budget); // 120 as a number
- * ```
- */
-export function nodesToObjects(nodes, schemas) {
-    const diagnostics = [];
-    function report(node, message) {
-        diagnostics.push({
-            code: 'MWL_OBJECT',
-            message,
-            location: node.location ?? { file: '<mwl>', line: 1, column: 1 },
-        });
-    }
-    function convert(node) {
-        const fields = {};
-        const schema = Object.hasOwn(schemas, node.tag) ? schemas[node.tag] : undefined;
-        if (!schema) {
-            report(node, `no object schema for tag "${node.tag}"`);
-            return fields;
-        }
-        for (const [key, raw] of Object.entries(node.attributes)) {
-            const type = (schema.attributes && Object.hasOwn(schema.attributes, key) ? schema.attributes[key] : undefined) ??
-                schema.openAttributes;
-            if (!type || !validAttributeValue(raw, type)) {
-                report(node, `invalid or undeclared attribute "${key}" on "${node.tag}"`);
-                continue;
-            }
-            let value = raw;
-            if (type === 'number' || type === 'integer')
-                value = Number(raw);
-            else if (type === 'boolean')
-                value = raw === 'true' || raw === 'yes';
-            Object.defineProperty(fields, key, { value, enumerable: true, writable: true, configurable: true });
-        }
-        for (const key of schema.required ?? []) {
-            if (!Object.hasOwn(node.attributes, key))
-                report(node, `missing required attribute "${key}" on "${node.tag}"`);
-        }
-        const children = new Map();
-        for (const child of node.children) {
-            const group = children.get(child.tag) ?? [];
-            group.push(convert(child));
-            children.set(child.tag, group);
-        }
-        for (const [tag, group] of children) {
-            if (Object.hasOwn(fields, tag)) {
-                report(node, `attribute and child tag "${tag}" collide on "${node.tag}"`);
-                continue;
-            }
-            const single = schema.cardinality?.[tag]?.max === 1;
-            if (single && group.length > 1)
-                report(node, `multiple "${tag}" children on "${node.tag}"`);
-            Object.defineProperty(fields, tag, {
-                value: single ? group[0] : group,
-                enumerable: true,
-                writable: true,
-                configurable: true,
-            });
-        }
-        return fields;
-    }
-    return { value: nodes.map(convert), diagnostics };
-}
-//# sourceMappingURL=objects.js.map

package/dist/mwl/objects.js.map

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