@crowdedkingdoms/crowdyjs 17.13.0-dev.1 → 18.0.0-dev.1

package/dist/kit/combat.js

@@ -1,196 +0,0 @@
-import { combatNames } from './blueprints/index.js';
-import { kitContainerProperties, kitInvoke, } from './shared.js';
-/**
- * Runtime helpers for the {@link combatBlueprint} conventions: spawn
- * combatants, attack (server-side damage formula + death flip), arm status
- * effects the tick automation applies over time, respawn, and route
- * competitive realtime attacks through a compute referee. `hostSynced`
- * remains a low-stakes/legacy fallback for persisting elected-host state;
- * it is not an anti-cheat boundary. Denials resolve with `success: false`.
- *
- * Obtained via `client.kit(appId).combat`.
- */
-export class CombatKit {
-    constructor(appId, gameModel, options = {}, engines) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.engines = engines;
-        this.names = combatNames(options.typePrefix ?? '');
-        this.engineModuleName = options.engineModuleName ?? 'mob-engine';
-    }
-    /**
-     * Route an attack through the strongest available authority: the compute
-     * referee (`attack_mob` on the mob engine — presence/range validated
-     * server-side) when the engine is deployed (capability-detected, cached),
-     * else today's model attack function. One call, both deployments.
-     *
-     * @param input.targetId - The target container (engine mob slot or model
-     *   combatant).
-     * @param input.attackerId - The caller's combatant container — required
-     *   for the model path, ignored by the engine referee (it referees by the
-     *   caller's live actor position).
-     * @param input.amount - Engine-path damage (clamped by the referee).
-     */
-    async attackRouted(input) {
-        if (this.engines && (await this.engines.has(this.engineModuleName))) {
-            const result = await this.engines.invoke(this.engineModuleName, 'attack_mob', {
-                containerId: input.targetId,
-                amount: input.amount ?? 1,
-            });
-            return {
-                success: result.success,
-                health: typeof result.body.health === 'number' ? result.body.health : undefined,
-                killed: typeof result.body.killed === 'boolean' ? result.body.killed : undefined,
-                reason: result.reason,
-                via: 'engine',
-            };
-        }
-        if (!input.attackerId) {
-            return {
-                success: false,
-                reason: 'attackerId is required for the model combat path',
-                via: 'model',
-            };
-        }
-        const result = await this.attack(input.attackerId, input.targetId);
-        return {
-            success: result.success,
-            health: result.returnValue,
-            reason: result.errorMessage,
-            via: 'model',
-        };
-    }
-    /**
-     * Spawn a combatant with a unique `combat_key` (the status-effect join
-     * key) and the `owner_user_id` mirror.
-     */
-    async spawnCombatant(input) {
-        const combatKey = input.combatKey ?? `ck-${input.ownerUserId}-${Math.random().toString(16).slice(2, 10)}`;
-        const maxHp = input.maxHp ?? 100;
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.combatantType,
-            displayName: input.displayName,
-            ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
-            properties: [
-                { key: 'owner_user_id', valueType: 'int', valueJson: String(input.ownerUserId) },
-                { key: 'combat_key', valueType: 'string', valueJson: JSON.stringify(combatKey) },
-                { key: 'hp', valueType: 'int', valueJson: String(input.hp ?? maxHp) },
-                { key: 'max_hp', valueType: 'int', valueJson: String(maxHp) },
-                { key: 'attack', valueType: 'int', valueJson: String(input.attack ?? 10) },
-                { key: 'defense', valueType: 'int', valueJson: String(input.defense ?? 0) },
-                ...(input.properties ?? []),
-            ],
-        });
-    }
-    /** Read one combatant's state. */
-    async state(combatantId) {
-        const container = await this.gameModel.container({
-            appId: this.appId,
-            containerId: combatantId,
-        });
-        const props = await kitContainerProperties(this.gameModel, String(this.appId), combatantId);
-        return {
-            containerId: container.containerId,
-            displayName: container.displayName,
-            ownerUserId: container.ownerUserId != null ? String(container.ownerUserId) : null,
-            combatKey: String(props.combat_key ?? ''),
-            hp: Number(props.hp ?? 0),
-            maxHp: Number(props.max_hp ?? 0),
-            attack: Number(props.attack ?? 0),
-            defense: Number(props.defense ?? 0),
-            alive: props.alive === true,
-        };
-    }
-    /**
-     * Attack a target with your combatant. The damage formula and the death
-     * flip run server-side. Resolves with the target's remaining hp.
-     */
-    async attack(attackerId, targetId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.attackFn,
-            selfContainerId: attackerId,
-            params: { target_id: targetId },
-        });
-    }
-    /**
-     * Arm a status effect against a target's `combat_key`: creates the
-     * caller's StatusEffect container (when `effectContainerId` is omitted)
-     * and invokes the gated apply function; the interval automation then
-     * ticks it server-side.
-     */
-    async applyEffect(input) {
-        let effectId = input.effectContainerId;
-        if (!effectId) {
-            const created = await this.gameModel.createContainer({
-                appId: this.appId,
-                typeName: this.names.effectType,
-                displayName: `Effect ${input.effectId}`,
-                ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
-            });
-            effectId = created.containerId;
-        }
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.applyEffectFn,
-            selfContainerId: effectId,
-            params: {
-                target_key: input.targetKey,
-                effect_id: input.effectId,
-                magnitude: input.magnitude,
-                ticks: input.ticks,
-            },
-        });
-    }
-    /** List the active status effects targeting a combat_key. */
-    async effects(targetKey) {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.effectType,
-        });
-        const all = await Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            return {
-                containerId: c.containerId,
-                displayName: c.displayName,
-                ownerUserId: c.ownerUserId != null ? String(c.ownerUserId) : null,
-                effectId: String(props.effect_id ?? ''),
-                targetKey: String(props.target_key ?? ''),
-                magnitude: Number(props.magnitude ?? 0),
-                ticksLeft: Number(props.ticks_left ?? 0),
-            };
-        }));
-        return all.filter((e) => e.ticksLeft > 0 && (targetKey === undefined || e.targetKey === targetKey));
-    }
-    /** Respawn your downed combatant at full hp. */
-    async respawn(combatantId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.respawnFn,
-            selfContainerId: combatantId,
-            params: {},
-        });
-    }
-    /** Revive a downed combatant (blueprint deployed with `reviveGroup`). */
-    async revive(combatantId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.reviveFn,
-            selfContainerId: combatantId,
-            params: {},
-        });
-    }
-    /**
-     * Persist host-simulated hp (blueprint deployed with `hostSynced: true`;
-     * `is_host` enforced server-side). Resolves with the clamped hp.
-     */
-    async syncCombatant(combatantId, hp) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.syncFn,
-            selfContainerId: combatantId,
-            params: { hp },
-        });
-    }
-}

package/dist/kit/decks.d.ts

@@ -1,157 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { EngineDetector } from './engine.js';
-import type { Scalars } from '../generated/graphql.js';
-import { type KitInvokeResult } from './shared.js';
-/** Options for {@link DecksKit}. Must match the deployed decks blueprint. */
-export interface DecksKitOptions {
-    /**
-     * The compute module holding hidden hands when the app runs a deck
-     * engine. Defaults to `'deck-engine'`.
-     */
-    engineModuleName?: string;
-    /** The `typePrefix` the decks blueprint was deployed with. */
-    typePrefix?: string;
-}
-/** A parsed view of one card instance, as visible to the CALLER. */
-export interface KitCard {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    /**
-     * The hidden identity — non-empty only when the caller may see it (their
-     * own cards, or any revealed card via `revealedCardId`).
-     */
-    cardId: string;
-    /** The public identity (empty until played/discarded). */
-    revealedCardId: string;
-    zone: string;
-    position: number;
-}
-/**
- * Runtime helpers for the {@link decksBlueprint} conventions: deal
- * session-scoped cards, shuffle by dealing random positions (admin-run
- * automation), and draw/play/discard through the zone-guarded functions.
- * Hidden information is enforced by property visibility server-side: reads
- * go through `containerState`, which strips other players' `card_id`.
- *
- * Obtained via `client.kit(appId).decks`.
- */
-export declare class DecksKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines?;
-    private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: DecksKitOptions, engines?: EngineDetector | undefined);
-    private readonly engineModuleName;
-    /**
-     * Is a deck compute engine deployed + enabled (cached per session)? When
-     * true, hands and deck order live in MODULE state (server-held secrets);
-     * the blueprint's owner-visibility hands remain for model-only apps.
-     */
-    engineAvailable(): Promise<boolean>;
-    /** Create an engine table with seeded shuffle + hidden deals (creator seats itself). */
-    engineNewTable(input: {
-        tableId: string;
-        players: string[];
-        handSize?: number;
-        deckDef?: string;
-    }): Promise<Record<string, unknown>>;
-    /** YOUR hidden hand (the only read path; opponents can never see it). */
-    engineHand(tableId: string): Promise<string[]>;
-    /** Draw one card into your hidden hand. */
-    engineDraw(tableId: string): Promise<Record<string, unknown>>;
-    /** Play (reveal) a card from your hand into a public zone. */
-    enginePlay(tableId: string, card: string, zone?: string): Promise<Record<string, unknown>>;
-    /** Collect a public zone to the discard (trick taken). */
-    engineTakeZone(tableId: string, zone: string): Promise<Record<string, unknown>>;
-    /** The public table view (counts + zones — never hidden hands). */
-    engineTable(tableId: string): Promise<Record<string, unknown>>;
-    private engineInvoke;
-    /**
-     * Deal a deck to a player: creates one CardInstance per card id (zone
-     * `deck`), owned by the player. Run {@link shuffle} afterwards to deal
-     * random positions.
-     */
-    deal(input: {
-        ownerUserId: Scalars['BigInt']['input'];
-        cardIds: string[];
-        sessionId?: string;
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }[]>;
-    /**
-     * Shuffle every deck-zone card by running the manual `assign_position`
-     * automation (admin): each card gets a fresh `rand_int` position
-     * server-side.
-     */
-    shuffle(): Promise<{
-        __typename?: "GmAutomationRun";
-        runId: string;
-        appId: string;
-        flowId: string | null;
-        automationId: string | null;
-        automationName: string;
-        triggerSource: string;
-        triggerId: string | null;
-        parentRunId: string | null;
-        cascadeDepth: number;
-        startedAt: string;
-        finishedAt: string | null;
-        durationUs: number;
-        targets: number;
-        invocations: number;
-        mutations: number;
-        fnCalls: number;
-        gasUsed: number;
-        success: boolean;
-        errorMessage: string | null;
-        circuitAction: string | null;
-        computeUnits: number;
-    }>;
-    /** A player's cards in one zone, as visible to the caller. */
-    cards(ownerUserId: Scalars['BigInt']['input'] | null, options?: {
-        zone?: string;
-        sessionId?: string;
-    }): Promise<KitCard[]>;
-    /** Your hand (owner-visible card ids included by the server). */
-    myHand(ownerUserId: Scalars['BigInt']['input'], options?: {
-        sessionId?: string;
-    }): Promise<KitCard[]>;
-    /** Every card on the board (public: revealed ids). */
-    board(options?: {
-        sessionId?: string;
-    }): Promise<KitCard[]>;
-    /**
-     * Draw the top of your deck (lowest position — positions were dealt by
-     * the shuffle automation). The server enforces ownership, turn (when
-     * `turnBased`), and the deck→hand zone transition.
-     */
-    draw(ownerUserId: Scalars['BigInt']['input'], options?: {
-        sessionId?: string;
-    }): Promise<KitInvokeResult<string>>;
-    /** Draw one specific deck card (prefer {@link draw} for top-of-deck). */
-    drawCard(cardInstanceId: string, options?: {
-        sessionId?: string;
-    }): Promise<KitInvokeResult<string>>;
-    /**
-     * Play a card from your hand: the zone flip and the public reveal commit
-     * together. Resolves with the revealed card id.
-     */
-    play(cardInstanceId: string, options?: {
-        sessionId?: string;
-    }): Promise<KitInvokeResult<string>>;
-    /** Discard a card face-up. */
-    discard(cardInstanceId: string, options?: {
-        sessionId?: string;
-    }): Promise<KitInvokeResult<string>>;
-    private toCard;
-}
-//# sourceMappingURL=decks.d.ts.map

package/dist/kit/decks.d.ts.map

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

package/dist/kit/decks.js

@@ -1,186 +0,0 @@
-import { decksNames } from './blueprints/index.js';
-import { kitContainerProperties, kitInvoke, } from './shared.js';
-/**
- * Runtime helpers for the {@link decksBlueprint} conventions: deal
- * session-scoped cards, shuffle by dealing random positions (admin-run
- * automation), and draw/play/discard through the zone-guarded functions.
- * Hidden information is enforced by property visibility server-side: reads
- * go through `containerState`, which strips other players' `card_id`.
- *
- * Obtained via `client.kit(appId).decks`.
- */
-export class DecksKit {
-    constructor(appId, gameModel, options = {}, engines) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.engines = engines;
-        this.names = decksNames(options.typePrefix ?? '');
-        this.engineModuleName = options.engineModuleName ?? 'deck-engine';
-    }
-    // -- Engine path (Wave 2): true hidden information over the deck engine --
-    /**
-     * Is a deck compute engine deployed + enabled (cached per session)? When
-     * true, hands and deck order live in MODULE state (server-held secrets);
-     * the blueprint's owner-visibility hands remain for model-only apps.
-     */
-    engineAvailable() {
-        if (!this.engines)
-            return Promise.resolve(false);
-        return this.engines.has(this.engineModuleName);
-    }
-    /** Create an engine table with seeded shuffle + hidden deals (creator seats itself). */
-    async engineNewTable(input) {
-        return this.engineInvoke('new_table', input);
-    }
-    /** YOUR hidden hand (the only read path; opponents can never see it). */
-    async engineHand(tableId) {
-        const body = await this.engineInvoke('hand', { tableId });
-        return Array.isArray(body.hand) ? body.hand.map(String) : [];
-    }
-    /** Draw one card into your hidden hand. */
-    async engineDraw(tableId) {
-        return this.engineInvoke('draw', { tableId });
-    }
-    /** Play (reveal) a card from your hand into a public zone. */
-    async enginePlay(tableId, card, zone = 'table') {
-        return this.engineInvoke('play', { tableId, card, zone });
-    }
-    /** Collect a public zone to the discard (trick taken). */
-    async engineTakeZone(tableId, zone) {
-        return this.engineInvoke('take_zone', { tableId, zone });
-    }
-    /** The public table view (counts + zones — never hidden hands). */
-    async engineTable(tableId) {
-        return this.engineInvoke('table', { tableId });
-    }
-    async engineInvoke(exportName, params) {
-        if (!this.engines) {
-            throw new Error('deck engine unavailable: compute domain not wired');
-        }
-        const result = await this.engines.invoke(this.engineModuleName, exportName, params);
-        if (!result.success) {
-            throw new Error(`decks.${exportName} failed: ${result.reason ?? 'unknown'}`);
-        }
-        return result.body;
-    }
-    /**
-     * Deal a deck to a player: creates one CardInstance per card id (zone
-     * `deck`), owned by the player. Run {@link shuffle} afterwards to deal
-     * random positions.
-     */
-    async deal(input) {
-        const created = [];
-        for (const [index, cardId] of input.cardIds.entries()) {
-            created.push(await this.gameModel.createContainer({
-                appId: this.appId,
-                typeName: this.names.cardType,
-                displayName: `Card ${index + 1}`,
-                ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
-                properties: [
-                    {
-                        key: 'owner_user_id',
-                        valueType: 'int',
-                        valueJson: String(input.ownerUserId),
-                    },
-                    { key: 'card_id', valueType: 'string', valueJson: JSON.stringify(cardId) },
-                    { key: 'position', valueType: 'int', valueJson: String(index) },
-                ],
-            }));
-        }
-        return created;
-    }
-    /**
-     * Shuffle every deck-zone card by running the manual `assign_position`
-     * automation (admin): each card gets a fresh `rand_int` position
-     * server-side.
-     */
-    async shuffle() {
-        return this.gameModel.runAutomation({
-            appId: this.appId,
-            name: this.names.shuffleAutomation,
-        });
-    }
-    /** A player's cards in one zone, as visible to the caller. */
-    async cards(ownerUserId, options = {}) {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.cardType,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-        });
-        const filtered = ownerUserId === null
-            ? containers
-            : containers.filter((c) => c.ownerUserId != null && String(c.ownerUserId) === String(ownerUserId));
-        const cards = await Promise.all(filtered.map((c) => this.toCard(c.containerId, c.displayName, c.ownerUserId != null ? String(c.ownerUserId) : null)));
-        return options.zone !== undefined
-            ? cards.filter((c) => c.zone === options.zone)
-            : cards;
-    }
-    /** Your hand (owner-visible card ids included by the server). */
-    async myHand(ownerUserId, options = {}) {
-        return this.cards(ownerUserId, { ...options, zone: 'hand' });
-    }
-    /** Every card on the board (public: revealed ids). */
-    async board(options = {}) {
-        return this.cards(null, { ...options, zone: 'board' });
-    }
-    /**
-     * Draw the top of your deck (lowest position — positions were dealt by
-     * the shuffle automation). The server enforces ownership, turn (when
-     * `turnBased`), and the deck→hand zone transition.
-     */
-    async draw(ownerUserId, options = {}) {
-        const deck = await this.cards(ownerUserId, { ...options, zone: 'deck' });
-        if (deck.length === 0) {
-            throw new Error('Deck is empty — nothing to draw');
-        }
-        const top = deck.reduce((a, b) => (b.position < a.position ? b : a));
-        return this.drawCard(top.containerId, options);
-    }
-    /** Draw one specific deck card (prefer {@link draw} for top-of-deck). */
-    async drawCard(cardInstanceId, options = {}) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.drawFn,
-            selfContainerId: cardInstanceId,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-            params: {},
-        });
-    }
-    /**
-     * Play a card from your hand: the zone flip and the public reveal commit
-     * together. Resolves with the revealed card id.
-     */
-    async play(cardInstanceId, options = {}) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.playFn,
-            selfContainerId: cardInstanceId,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-            params: {},
-        });
-    }
-    /** Discard a card face-up. */
-    async discard(cardInstanceId, options = {}) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.discardFn,
-            selfContainerId: cardInstanceId,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-            params: {},
-        });
-    }
-    async toCard(containerId, displayName, ownerUserId) {
-        // containerState filters properties by visibility: other players' hands
-        // come back WITHOUT card_id — the hidden-info guarantee is server-side.
-        const props = await kitContainerProperties(this.gameModel, String(this.appId), containerId);
-        return {
-            containerId,
-            displayName,
-            ownerUserId,
-            cardId: String(props.card_id ?? ''),
-            revealedCardId: String(props.revealed_card_id ?? ''),
-            zone: String(props.zone ?? ''),
-            position: Number(props.position ?? 0),
-        };
-    }
-}

package/dist/kit/director.d.ts

@@ -1,88 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars } from '../generated/graphql.js';
-import type { EngineDetector } from './engine.js';
-/** Options for {@link DirectorKit}. */
-export interface DirectorKitOptions {
-    /** The director module name. Defaults to `'director'`. */
-    moduleName?: string;
-    /** The encounter-definition container type. Defaults to `'EncounterDef'`. */
-    defTypeName?: string;
-}
-/** One wave of an encounter definition. */
-export interface KitWaveSpec {
-    units: Array<{
-        mobId: string;
-        count: number;
-    }>;
-    delayMs?: number;
-    /** Boss wave: hp + phase thresholds (descending hp percentages). */
-    boss?: {
-        hp: number;
-        phases?: number[];
-    };
-}
-/** A director run's state. */
-export interface KitDirectorRun {
-    runId: string;
-    encounterId: string;
-    players: number;
-    phase: Record<string, unknown>;
-    pending: number;
-    wavesCleared: number;
-    wavesTotal: number;
-    boss: {
-        hp: number;
-        maxHp: number;
-        phase: number;
-        thresholds: number[];
-    } | null;
-    finished: boolean;
-    outcome: string;
-}
-/**
- * Runtime helpers for the director engine (Wave 2): data-driven encounter
- * direction — wave schedules, spawn budgets, boss phases, party scaling.
- * The director emits `director_spawn` compute events; the mob layer
- * simulates and reports kills back.
- *
- * Obtained via `client.kit(appId).director`.
- */
-export declare class DirectorKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines;
-    private readonly moduleName;
-    private readonly defTypeName;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: DirectorKitOptions);
-    /** Is the director deployed + enabled (cached per session)? */
-    engineAvailable(): Promise<boolean>;
-    /** STUDIO (admin) — create an encounter definition container. */
-    defineEncounter(input: {
-        encounterId: string;
-        displayName?: string;
-        waves: KitWaveSpec[];
-        spawnBudget?: number;
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** Start a run (party size scales unit counts server-side). */
-    startRun(encounterId: string, players?: number): Promise<KitDirectorRun>;
-    /** Report kills toward the live wave (trusted callers/engines). */
-    reportKill(runId: string, count?: number): Promise<KitDirectorRun>;
-    /** Report boss hp; phase transitions announce on the compute bus. */
-    reportBossHp(runId: string, hp: number): Promise<KitDirectorRun>;
-    /** Force-clear the live wave (run creator only). */
-    skipWave(runId: string): Promise<KitDirectorRun>;
-    /** One run's state (or engine totals without an id). */
-    runState(runId?: string): Promise<KitDirectorRun | Record<string, unknown>>;
-    private invoke;
-}
-//# sourceMappingURL=director.d.ts.map

package/dist/kit/director.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"director.d.ts","sourceRoot":"","sources":["../../src/kit/director.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1C;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD;;;;;;;GAOG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGlB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,kBAAuB;IAMlC,+DAA+D;IAC/D,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,iEAAiE;IAC3D,eAAe,CAAC,KAAK,EAAE;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IAeD,+DAA+D;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzE,mEAAmE;IAC7D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,qEAAqE;IAC/D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAItE,oDAAoD;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAItD,wDAAwD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAKnE,MAAM;CAOrB"}