@crowdedkingdoms/crowdyjs 17.14.0-dev.1 → 18.0.1-dev.1

package/dist/kit/blueprints/moderation.d.ts

@@ -1,32 +0,0 @@
-import { type KitBlueprint } from './core.js';
-/** Options for {@link moderationBlueprint}. */
-export interface ModerationBlueprintOptions {
-    /** Prefix for the type/function names. Defaults to none. */
-    typePrefix?: string;
-}
-/** Names derived by {@link moderationBlueprint} for a given prefix. */
-export interface ModerationNames {
-    reportType: string;
-    muteType: string;
-    fileReportFn: string;
-    resolveReportFn: string;
-}
-/** Compute the type/function names a moderation blueprint (and its runtime helper) uses. */
-export declare function moderationNames(typePrefix?: string): ModerationNames;
-/**
- * Blueprint for **moderation** (matrix P6) — MODEL + CLIENT, no compute:
- *
- * - `ModReport` containers are the escalation queue: any player files one
- *   against a subject (`file_report` is member-instantiable through the
- *   runtime helper — the caller's own report row); app admins read the
- *   open queue and `resolve_report` with a disposition.
- * - `ModMute` containers are per-player mute lists (client-enforced: the
- *   runtime helper filters chat client-side — mutes are personal, not
- *   punitive).
- * - ENFORCEMENT stays on existing platform surfaces: admins revoke access
- *   tiers / grid permissions; nothing new to trust here.
- *
- * Runtime counterpart: `client.kit(appId).moderation`.
- */
-export declare function moderationBlueprint(options?: ModerationBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=moderation.d.ts.map

package/dist/kit/blueprints/moderation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/moderation.ts"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnF,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,UAAU,SAAK,GAAG,eAAe,CAQhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,YAAY,CAqH1F"}

package/dist/kit/blueprints/moderation.js

@@ -1,140 +0,0 @@
-import { toSnakeCase, trustedAuthorityFields } from './core.js';
-/** Compute the type/function names a moderation blueprint (and its runtime helper) uses. */
-export function moderationNames(typePrefix = '') {
-    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
-    return {
-        reportType: `${typePrefix}ModReport`,
-        muteType: `${typePrefix}ModMute`,
-        fileReportFn: `${fnPrefix}file_report`,
-        resolveReportFn: `${fnPrefix}resolve_report`,
-    };
-}
-/**
- * Blueprint for **moderation** (matrix P6) — MODEL + CLIENT, no compute:
- *
- * - `ModReport` containers are the escalation queue: any player files one
- *   against a subject (`file_report` is member-instantiable through the
- *   runtime helper — the caller's own report row); app admins read the
- *   open queue and `resolve_report` with a disposition.
- * - `ModMute` containers are per-player mute lists (client-enforced: the
- *   runtime helper filters chat client-side — mutes are personal, not
- *   punitive).
- * - ENFORCEMENT stays on existing platform surfaces: admins revoke access
- *   tiers / grid permissions; nothing new to trust here.
- *
- * Runtime counterpart: `client.kit(appId).moderation`.
- */
-export function moderationBlueprint(options = {}) {
-    const { typePrefix = '' } = options;
-    const names = moderationNames(typePrefix);
-    const propertyDefinitions = [
-        {
-            containerTypeName: names.reportType,
-            key: 'reporter_user_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Who filed the report.',
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'subject_user_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Who the report is about.',
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'reason',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: "App-defined category ('harassment', 'cheating', 'spam', ...).",
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'detail',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Free-text context from the reporter (client-truncated).',
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'status',
-            valueType: 'string',
-            defaultValueJson: '"open"',
-            description: "Queue state: 'open' | 'actioned' | 'dismissed'.",
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'resolution',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Admin note recorded by resolve_report.',
-        },
-        {
-            containerTypeName: names.reportType,
-            key: 'filed_at_ms',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Client-reported epoch ms (informational; the event log holds server time).',
-        },
-        {
-            containerTypeName: names.muteType,
-            key: 'owner_user_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Whose mute list this row belongs to (kit owner mirror).',
-        },
-        {
-            containerTypeName: names.muteType,
-            key: 'muted_user_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'The muted player (client-side chat filtering).',
-        },
-    ];
-    const functions = [
-        {
-            name: names.resolveReportFn,
-            containerTypeName: names.reportType,
-            returnType: 'string',
-            parameters: [
-                {
-                    name: 'status',
-                    valueType: 'string',
-                    required: true,
-                    description: "'actioned' or 'dismissed'.",
-                },
-                {
-                    name: 'resolution',
-                    valueType: 'string',
-                    required: true,
-                    description: 'Admin disposition note.',
-                },
-            ],
-            mutations: [
-                { target: 'self', property: 'status', expression: '$status' },
-                { target: 'self', property: 'resolution', expression: '$resolution' },
-            ],
-            returnExpression: 'self.status',
-            ...trustedAuthorityFields('server'),
-            description: 'Close a report with a disposition (app admins). Enforcement happens on platform surfaces (tier revocation, grid permissions).',
-        },
-    ];
-    return {
-        name: 'moderation',
-        containerTypes: [
-            {
-                typeName: names.reportType,
-                displayName: 'Moderation report',
-                description: 'One player report in the escalation queue (open/actioned/dismissed).',
-            },
-            {
-                typeName: names.muteType,
-                displayName: 'Moderation mute',
-                description: 'One personal mute entry (client-enforced chat filtering).',
-            },
-        ],
-        propertyDefinitions,
-        functions,
-    };
-}

package/dist/kit/blueprints/npcs.d.ts

@@ -1,78 +0,0 @@
-import type { FunctionMutationInput, FunctionParamInput, Scalars, SeedPropertyDefInput } from '../../generated/graphql.js';
-import { type KitBlueprint, type KitSelectorSpec } from './core.js';
-/** A trigger for an NPC behavior: a schedule (interval or cron) or a model event. */
-export type NpcBehaviorTrigger = {
-    intervalMs: number;
-} | {
-    cronExpr: string;
-} | {
-    onEvent: 'function_invoked' | 'property_changed' | 'container_created';
-    functionName?: string;
-    containerTypeName?: string;
-    propertyKey?: string;
-    /**
-     * `property_changed` only: which writes wake the behavior. NPC state is
-     * written by behavior functions rather than by clients, so reacting to
-     * one needs `'function'` or `'any'` — the default `'direct'` sees only
-     * client `setProperty` calls.
-     */
-    writeSource?: 'direct' | 'function' | 'any';
-    debounceMs?: number;
-};
-/** One server-driven NPC behavior: a model function plus the automation that drives it. */
-export interface NpcBehaviorSpec {
-    /**
-     * Automation name (unique per app), e.g. `'npc-wander'`. Also derives the
-     * default function name (`npc_wander`).
-     */
-    name: string;
-    /** Entry-point function name. Defaults to the snake-cased behavior name. */
-    functionName?: string;
-    /** The property writes the behavior performs each tick. */
-    mutations: FunctionMutationInput[];
-    /** Typed parameters (bind them from a selector or static `paramsJson`). */
-    parameters?: FunctionParamInput[];
-    /** What makes the behavior run. */
-    trigger: NpcBehaviorTrigger;
-    /**
-     * Selector choosing/filtering targets and binding params (see the Game API
-     * "Autonomous Processes → Selectors" guide), including grid-permission
-     * predicates ({@link KitSelectorSpec}). JSON-encoded at deploy.
-     */
-    selector?: KitSelectorSpec;
-    /**
-     * Convenience: only NPCs whose `role` property equals this act (adds a
-     * `selfWhere` filter when no explicit `selector` is given).
-     */
-    role?: string;
-    /** Fan-out cap per run. Defaults to 8. */
-    maxTargets?: number;
-    /** Static params merged into every call. */
-    params?: Record<string, unknown>;
-    /** Identity the automation acts as; omit for a trusted server caller. */
-    runAsUserId?: Scalars['BigInt']['input'];
-}
-/** Options for {@link npcBlueprint}. */
-export interface NpcBlueprintOptions {
-    /** NPC container type name. Defaults to `'Npc'`. */
-    typeName?: string;
-    /**
-     * Extra property definitions beyond the defaults (`role`, `x`, `y`, `z`,
-     * `behavior_state`, `health`). `containerTypeName` is filled in.
-     */
-    extraProperties?: Omit<SeedPropertyDefInput, 'containerTypeName'>[];
-    /** The server-driven behaviors this NPC archetype has. */
-    behaviors: NpcBehaviorSpec[];
-}
-/** Compute the function/automation names an NPC behavior deploys under. */
-export declare function npcBehaviorFunctionName(behavior: NpcBehaviorSpec): string;
-/**
- * Blueprint for an **NPC archetype**: an admin-instantiable container type
- * holding the NPC's durable state, one `autonomousInvocable` model function
- * per behavior (gated `is_automation` so players cannot puppet them), and the
- * automations + event triggers that drive those behaviors on the server.
- *
- * Runtime counterpart: `client.kit(appId).npcs`.
- */
-export declare function npcBlueprint(options: NpcBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=npcs.d.ts.map

package/dist/kit/blueprints/npcs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/npcs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,OAAO,EAEP,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,WAAW,CAAC;AAEnB,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IACE,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,mCAAmC;IACnC,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,CAAC;IACpE,0DAA0D;IAC1D,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAsHvE"}

package/dist/kit/blueprints/npcs.js

@@ -1,125 +0,0 @@
-import { kitPolicyJson, toSnakeCase, } from './core.js';
-/** Compute the function/automation names an NPC behavior deploys under. */
-export function npcBehaviorFunctionName(behavior) {
-    return behavior.functionName ?? toSnakeCase(behavior.name);
-}
-/**
- * Blueprint for an **NPC archetype**: an admin-instantiable container type
- * holding the NPC's durable state, one `autonomousInvocable` model function
- * per behavior (gated `is_automation` so players cannot puppet them), and the
- * automations + event triggers that drive those behaviors on the server.
- *
- * Runtime counterpart: `client.kit(appId).npcs`.
- */
-export function npcBlueprint(options) {
-    const typeName = options.typeName ?? 'Npc';
-    if (options.behaviors.length === 0) {
-        throw new Error('npcBlueprint requires at least one behavior');
-    }
-    const propertyDefinitions = [
-        {
-            containerTypeName: typeName,
-            key: 'role',
-            valueType: 'string',
-            defaultValueJson: '""',
-        },
-        { containerTypeName: typeName, key: 'x', valueType: 'float', defaultValueJson: '0' },
-        { containerTypeName: typeName, key: 'y', valueType: 'float', defaultValueJson: '0' },
-        { containerTypeName: typeName, key: 'z', valueType: 'float', defaultValueJson: '0' },
-        {
-            containerTypeName: typeName,
-            key: 'behavior_state',
-            valueType: 'string',
-            defaultValueJson: '"idle"',
-        },
-        {
-            containerTypeName: typeName,
-            key: 'health',
-            valueType: 'int',
-            defaultValueJson: '100',
-        },
-        ...(options.extraProperties ?? []).map((p) => ({
-            ...p,
-            containerTypeName: typeName,
-        })),
-    ];
-    const functions = [];
-    const automations = [];
-    const automationTriggers = [];
-    for (const behavior of options.behaviors) {
-        const functionName = npcBehaviorFunctionName(behavior);
-        functions.push({
-            name: functionName,
-            containerTypeName: typeName,
-            parameters: behavior.parameters,
-            mutations: behavior.mutations,
-            invokePolicyJson: kitPolicyJson({ type: 'is_automation' }),
-            autonomousInvocable: true,
-            description: `Server-driven NPC behavior for the '${behavior.name}' automation.`,
-        });
-        const selector = behavior.selector ??
-            (behavior.role !== undefined
-                ? { selfWhere: [{ key: 'role', op: '==', value: behavior.role }] }
-                : undefined);
-        const automation = {
-            name: behavior.name,
-            functionName,
-            targetMode: 'type',
-            targetTypeName: typeName,
-            maxTargets: behavior.maxTargets ?? 8,
-            ...(selector ? { selectorJson: JSON.stringify(selector) } : {}),
-            ...(behavior.params ? { paramsJson: JSON.stringify(behavior.params) } : {}),
-            ...(behavior.runAsUserId !== undefined
-                ? { runAsUserId: behavior.runAsUserId }
-                : {}),
-        };
-        if ('intervalMs' in behavior.trigger) {
-            automation.triggerType = 'schedule';
-            automation.scheduleKind = 'interval';
-            automation.intervalMs = behavior.trigger.intervalMs;
-        }
-        else if ('cronExpr' in behavior.trigger) {
-            automation.triggerType = 'schedule';
-            automation.scheduleKind = 'cron';
-            automation.cronExpr = behavior.trigger.cronExpr;
-        }
-        else {
-            automation.triggerType = 'event';
-            automationTriggers.push({
-                automationName: behavior.name,
-                onEvent: behavior.trigger.onEvent,
-                ...(behavior.trigger.functionName !== undefined
-                    ? { functionName: behavior.trigger.functionName }
-                    : {}),
-                ...(behavior.trigger.containerTypeName !== undefined
-                    ? { containerTypeName: behavior.trigger.containerTypeName }
-                    : {}),
-                ...(behavior.trigger.propertyKey !== undefined
-                    ? { propertyKey: behavior.trigger.propertyKey }
-                    : {}),
-                ...(behavior.trigger.writeSource !== undefined
-                    ? { writeSource: behavior.trigger.writeSource }
-                    : {}),
-                ...(behavior.trigger.debounceMs !== undefined
-                    ? { debounceMs: behavior.trigger.debounceMs }
-                    : {}),
-            });
-        }
-        automations.push(automation);
-    }
-    return {
-        name: typeName,
-        containerTypes: [
-            {
-                typeName,
-                displayName: typeName,
-                instantiableBy: 'admin',
-                description: 'A server-driven non-player character.',
-            },
-        ],
-        propertyDefinitions,
-        functions,
-        automations,
-        automationTriggers,
-    };
-}

package/dist/kit/blueprints/plots.d.ts

@@ -1,63 +0,0 @@
-import { type KitBlueprint, type KitInvokePolicy, type KitOwnerIdKind } from './core.js';
-/** Options for {@link plotBlueprint}. */
-export interface PlotBlueprintOptions {
-    /** Plot container type name. Defaults to `'Plot'`. */
-    typeName?: string;
-    /**
-     * Runtime permission keys buying/renting grants on the plot's grid.
-     * Defaults to `['access', 'update_voxel_data']`.
-     */
-    permissionKeys?: string[];
-    /** Currency property on the wallet container. Defaults to `'gold'`. */
-    currencyProperty?: string;
-    /**
-     * Property on the wallet container mirroring its owner's user id (the
-     * standard kit convention, since expressions can't read container
-     * ownership). Defaults to `'owner_user_id'`.
-     */
-    walletOwnerProperty?: string;
-    /**
-     * Also generate `rent_plot`: a TTL grant priced by the plot's `rent_price`
-     * property, expiring after `rent_ttl_seconds`. Defaults to false.
-     */
-    rentable?: boolean;
-    /**
-     * Extra policy rule AND'ed into `buy_plot` — e.g.
-     * `featureGate('land_owner')` to sell land only to a paid tier.
-     */
-    buyPolicyExtra?: KitInvokePolicy;
-    /** Extra policy rule AND'ed into `rent_plot`. */
-    rentPolicyExtra?: KitInvokePolicy;
-    /**
-     * How the `owner_user_id` mirrors are typed on the plot AND the wallet
-     * (see the kit owner-mirroring convention). Defaults to `'int'` (the kit
-     * standard); set `'string'` for models that mirrored owners as strings
-     * (e.g. Blocks with Friends) — generated guards then compare via
-     * `to_string($caller_user_id)`, buying writes the owner as a string, and
-     * an empty string means "for sale".
-     */
-    ownerIdKind?: KitOwnerIdKind;
-}
-/** Names derived by {@link plotBlueprint} for a given plot type. */
-export interface PlotNames {
-    plotType: string;
-    buyFn: string;
-    rentFn: string;
-    evictFn: string;
-}
-/** Compute the type/function names a plot blueprint (and its runtime helper) uses. */
-export declare function plotNames(typeName?: string): PlotNames;
-/**
- * Blueprint for **sellable/rentable land**: a `Plot` container mapping a world
- * [grid](../../domains/gameApps.js) to a price, whose `buy`/`rent` functions
- * consume currency AND grant runtime grid permissions in one transaction (via
- * permission effects) — the canonical read+write permission loop. Buying sets
- * the plot's `owner_user_id`; renting grants with a TTL; `evict` revokes.
- * The grants are enforced by the replication layer on movement/voxel writes
- * immediately at commit. Requires game-api v0.13.11+ (effects) — pair with
- * chunk-permission locks (v0.13.12+) for doors that honor the purchase.
- *
- * Runtime counterpart: `client.kit(appId).plots`.
- */
-export declare function plotBlueprint(options?: PlotBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=plots.d.ts.map

package/dist/kit/blueprints/plots.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plots.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/plots.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,iDAAiD;IACjD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,QAAQ,SAAS,GAAG,SAAS,CAQtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,YAAY,CA+I9E"}

package/dist/kit/blueprints/plots.js

@@ -1,151 +0,0 @@
-import { andPolicies, kitPolicyJson, ownerEqualsCaller, toSnakeCase, } from './core.js';
-/** Compute the type/function names a plot blueprint (and its runtime helper) uses. */
-export function plotNames(typeName = 'Plot') {
-    const snake = toSnakeCase(typeName);
-    return {
-        plotType: typeName,
-        buyFn: `buy_${snake}`,
-        rentFn: `rent_${snake}`,
-        evictFn: `evict_${snake}`,
-    };
-}
-/**
- * Blueprint for **sellable/rentable land**: a `Plot` container mapping a world
- * [grid](../../domains/gameApps.js) to a price, whose `buy`/`rent` functions
- * consume currency AND grant runtime grid permissions in one transaction (via
- * permission effects) — the canonical read+write permission loop. Buying sets
- * the plot's `owner_user_id`; renting grants with a TTL; `evict` revokes.
- * The grants are enforced by the replication layer on movement/voxel writes
- * immediately at commit. Requires game-api v0.13.11+ (effects) — pair with
- * chunk-permission locks (v0.13.12+) for doors that honor the purchase.
- *
- * Runtime counterpart: `client.kit(appId).plots`.
- */
-export function plotBlueprint(options = {}) {
-    const names = plotNames(options.typeName);
-    const keys = options.permissionKeys ?? ['access', 'update_voxel_data'];
-    const currency = options.currencyProperty ?? 'gold';
-    const walletOwner = options.walletOwnerProperty ?? 'owner_user_id';
-    const rentable = options.rentable ?? false;
-    const kind = options.ownerIdKind ?? 'int';
-    const walletParam = [
-        { name: 'wallet_id', valueType: 'container_ref', required: true },
-    ];
-    const walletGuard = (priceExpr, extra) => kitPolicyJson(andPolicies({
-        type: 'condition',
-        expression: `${ownerEqualsCaller(`ref($wallet_id).${walletOwner}`, kind)} && ref($wallet_id).${currency} >= ${priceExpr}`,
-    }, extra));
-    const propertyDefinitions = [
-        { containerTypeName: names.plotType, key: 'grid_id', valueType: 'int' },
-        { containerTypeName: names.plotType, key: 'price', valueType: 'int', defaultValueJson: '0' },
-        {
-            containerTypeName: names.plotType,
-            key: 'owner_user_id',
-            valueType: kind,
-            defaultValueJson: kind === 'string' ? '""' : '0',
-        },
-    ];
-    if (rentable) {
-        propertyDefinitions.push({
-            containerTypeName: names.plotType,
-            key: 'rent_price',
-            valueType: 'int',
-            defaultValueJson: '0',
-        }, {
-            containerTypeName: names.plotType,
-            key: 'rent_ttl_seconds',
-            valueType: 'int',
-            defaultValueJson: '86400',
-        });
-    }
-    const functions = [
-        {
-            name: names.buyFn,
-            containerTypeName: names.plotType,
-            returnType: 'int',
-            parameters: walletParam,
-            mutations: [
-                {
-                    target: 'ref($wallet_id)',
-                    property: currency,
-                    expression: `ref($wallet_id).${currency} - self.price`,
-                },
-                {
-                    target: 'self',
-                    property: 'owner_user_id',
-                    expression: kind === 'string' ? 'to_string($caller_user_id)' : '$caller_user_id',
-                },
-            ],
-            permissionEffects: [
-                {
-                    action: 'grant',
-                    permissionKeys: keys,
-                    userExpression: '$caller_user_id',
-                    gridIdExpression: 'self.grid_id',
-                },
-            ],
-            returnExpression: `ref($wallet_id).${currency}`,
-            invokePolicyJson: walletGuard('self.price', options.buyPolicyExtra),
-            description: 'Buy this plot: spend the price AND receive grid permissions atomically.',
-        },
-        {
-            name: names.evictFn,
-            containerTypeName: names.plotType,
-            parameters: [{ name: 'target_user_id', valueType: 'int', required: true }],
-            mutations: [],
-            permissionEffects: [
-                {
-                    action: 'revoke',
-                    permissionKeys: keys,
-                    userExpression: '$target_user_id',
-                    gridIdExpression: 'self.grid_id',
-                },
-            ],
-            invokePolicyJson: kitPolicyJson({
-                type: 'condition',
-                expression: ownerEqualsCaller('self.owner_user_id', kind),
-            }),
-            description: "Revoke a user's permissions on this plot (owner-gated; admins bypass).",
-        },
-    ];
-    if (rentable) {
-        functions.push({
-            name: names.rentFn,
-            containerTypeName: names.plotType,
-            returnType: 'int',
-            parameters: walletParam,
-            mutations: [
-                {
-                    target: 'ref($wallet_id)',
-                    property: currency,
-                    expression: `ref($wallet_id).${currency} - self.rent_price`,
-                },
-            ],
-            permissionEffects: [
-                {
-                    action: 'grant',
-                    permissionKeys: keys,
-                    userExpression: '$caller_user_id',
-                    gridIdExpression: 'self.grid_id',
-                    ttlSecondsExpression: 'self.rent_ttl_seconds',
-                },
-            ],
-            returnExpression: `ref($wallet_id).${currency}`,
-            invokePolicyJson: walletGuard('self.rent_price', options.rentPolicyExtra),
-            description: 'Rent this plot: spend the rent AND receive an expiring grid grant atomically.',
-        });
-    }
-    return {
-        name: names.plotType,
-        containerTypes: [
-            {
-                typeName: names.plotType,
-                displayName: names.plotType,
-                instantiableBy: 'admin',
-                description: 'A sellable/rentable plot of land mapped to a world grid.',
-            },
-        ],
-        propertyDefinitions,
-        functions,
-    };
-}

package/dist/kit/blueprints/progression.d.ts

@@ -1,68 +0,0 @@
-import { type KitBlueprint, type KitOwnerIdKind, type KitTrustedAuthority } from './core.js';
-/** Options for {@link progressionBlueprint}. */
-export interface ProgressionBlueprintOptions {
-    /**
-     * Prefix applied to the container type names (`'Pvp'` → `PvpProgress` /
-     * `PvpSkillDef` / …) and, snake-cased, to the function names
-     * (`pvp_grant_xp`, …). Defaults to none.
-     */
-    typePrefix?: string;
-    /**
-     * Who may grant XP. Trusted grants should be `'server'` (the default),
-     * `'automation'` (e.g. an event automation on a `mob_died` function), or
-     * `'host'` — never plain players.
-     */
-    xpAuthority?: KitTrustedAuthority;
-    /**
-     * Who may adjust the competitive rating (the match layer's
-     * `applyMatchResult` calls this). Defaults to `'host'`.
-     */
-    ratingAuthority?: KitTrustedAuthority;
-    /**
-     * The XP curve: an expression over `$level` returning the TOTAL xp required
-     * to reach that level. Evaluated via the read-only `fn:` helper-call
-     * pattern (`fn:xp_for_level(self.level + 1)`), so the curve lives in ONE
-     * `internal` function and every reader stays in sync. Defaults to
-     * `'100 * $level * $level'`.
-     */
-    xpForLevelExpression?: string;
-    /** Skill points granted per level-up. Defaults to 1. */
-    skillPointsPerLevel?: number;
-    /** Initial competitive rating for new players. Defaults to 1000. */
-    initialRating?: number;
-    /** Owner-mirror typing (see the kit convention). Defaults to `'int'`. */
-    ownerIdKind?: KitOwnerIdKind;
-}
-/** Names derived by {@link progressionBlueprint} for a given prefix. */
-export interface ProgressionNames {
-    progressType: string;
-    skillDefType: string;
-    skillRankType: string;
-    achievementDefType: string;
-    achievementUnlockType: string;
-    xpForLevelFn: string;
-    grantXpFn: string;
-    buySkillFn: string;
-    unlockAchievementFn: string;
-    adjustRatingFn: string;
-}
-/** Compute the type/function names a progression blueprint (and its runtime helper) uses. */
-export declare function progressionNames(typePrefix?: string): ProgressionNames;
-/**
- * Blueprint for **character progression**: per-player `Progress` (xp / level /
- * skill points / rating), an admin `SkillDef` catalog with prerequisite
- * chains bought into per-player `SkillRank`s, threshold `AchievementDef`s
- * unlocked into `AchievementUnlock`s, and an ELO-style `adjust_rating` hook
- * for the match layer.
- *
- * Level-ups are computed server-side inside `grant_xp` using the `fn:`
- * helper pattern: the XP curve lives in ONE `internal` function
- * (`xp_for_level`, not directly invocable) that mutation expressions call as
- * `fn:xp_for_level(self.level + 1)`. Ordered mutations see earlier writes,
- * so xp is applied first, then the skill-point award, then the level bump —
- * one level per grant (call repeatedly for multi-level jumps).
- *
- * Runtime counterpart: `client.kit(appId).progression`.
- */
-export declare function progressionBlueprint(options?: ProgressionBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=progression.d.ts.map