@datamoc/mw_games 0.37.0 → 0.39.1

package/dist/mwl/presentation.d.ts

@@ -0,0 +1,70 @@
+import { type MwlSourceFile } from './compiler.ts';
+export type PresentationScalarType = 'string' | 'number' | 'boolean';
+export type PresentationValue = string | number | boolean;
+export type PresentationItem = Readonly<Record<string, PresentationValue>>;
+export interface PresentationCollection {
+    readonly type: 'items';
+    readonly fields: Readonly<Record<string, PresentationScalarType>>;
+}
+/** The game's TypeScript adapter declares these names and value types at build time. */
+export interface PresentationManifest {
+    readonly values: Readonly<Record<string, PresentationScalarType | PresentationCollection>>;
+    readonly actions: readonly string[];
+    readonly adapters?: readonly string[];
+    readonly assets?: readonly string[];
+}
+export type PresentationProperties = Readonly<Record<string, string>>;
+export interface PresentationNode {
+    readonly kind: string;
+    readonly id: string;
+    /** Authored definition path, shared by every instance of a reusable component. */
+    readonly source: string;
+    readonly properties: PresentationProperties;
+    readonly states: Readonly<Record<string, PresentationProperties>>;
+    readonly children: readonly PresentationNode[];
+}
+export interface PresentationTheme {
+    readonly tokens: Readonly<Record<string, number>>;
+    readonly properties: PresentationProperties;
+}
+export interface PresentationContext {
+    readonly theme: string;
+    readonly tokens: Readonly<Record<string, number>>;
+    readonly overrides: Readonly<Record<string, PresentationProperties>>;
+}
+export interface PresentationScene {
+    readonly theme: string;
+    readonly children: readonly PresentationNode[];
+}
+export interface CompiledPresentation {
+    readonly scenes: Readonly<Record<string, PresentationScene>>;
+    readonly themes: Readonly<Record<string, PresentationTheme>>;
+    readonly contexts: Readonly<Record<string, PresentationContext>>;
+    readonly variants: Readonly<Record<string, PresentationProperties>>;
+    readonly manifest: PresentationManifest;
+    readonly ids: readonly string[];
+    readonly assets: readonly string[];
+    readonly messages: readonly string[];
+}
+/**
+ * Compiles optional scene/UI definitions, validating every reference against the game's manifest.
+ * Reusable components are expanded at build time; emitted data contains no parser or executable content.
+ *
+ * @example
+ * ```ts
+ * import { compilePresentation, emitPresentationModule } from '@datamoc/mw_games/mwl/presentation';
+ * const data = compilePresentation([], { values: {}, actions: [] });
+ * console.log(emitPresentationModule(data).startsWith('export const presentationData')); // true
+ * ```
+ */
+export declare function compilePresentation(files: readonly MwlSourceFile[], manifest: PresentationManifest): CompiledPresentation;
+/**
+ * Emits data and literal ID types for a game's build script to write alongside its other MWL artifacts.
+ * @example
+ * ```ts
+ * import { compilePresentation, emitPresentationModule } from '@datamoc/mw_games/mwl/presentation';
+ * console.log(emitPresentationModule(compilePresentation([], { values: {}, actions: [] })));
+ * ```
+ */
+export declare function emitPresentationModule(data: CompiledPresentation): string;
+//# sourceMappingURL=presentation.d.ts.map

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

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

package/dist/mwl/presentation.js

@@ -0,0 +1,419 @@
+import { compileSources } from './compiler.js';
+import { schema10 } from './schema.js';
+import { contrastRatio } from '../two-d/ui/contrast.js';
+const styleAttributes = {
+    color_token: 'id',
+    background_token: 'id',
+    border_token: 'id',
+    width: 'number',
+    height: 'number',
+    gap: 'number',
+    padding: 'number',
+    alpha: 'number',
+};
+const commonAttributes = {
+    id: 'id',
+    ...styleAttributes,
+    variant: 'id',
+    anchor: [
+        'top-left',
+        'top',
+        'top-right',
+        'left',
+        'center',
+        'right',
+        'bottom-left',
+        'bottom',
+        'bottom-right',
+        'fill',
+    ],
+    x: 'number',
+    y: 'number',
+    visible: 'boolean',
+    visible_binding: 'string',
+};
+const uiTags = [
+    'ui_container',
+    'ui_row',
+    'ui_column',
+    'ui_grid',
+    'ui_label',
+    'ui_button',
+    'ui_bar',
+    'ui_window',
+    'ui_repeat',
+    'ui_mount',
+    'ui_adapter',
+];
+const children = [...uiTags, 'ui_state'];
+const tree = { attributes: commonAttributes, required: ['id'], children };
+const vocabulary = {
+    theme_definition: {
+        attributes: { id: 'id', font_family: 'string', font_size: 'number', padding: 'number', spacing: 'number' },
+        required: ['id'],
+        children: ['theme_token'],
+    },
+    theme_token: { attributes: { id: 'id', value: 'number' }, required: ['id', 'value'], children: [] },
+    presentation_context: {
+        attributes: { id: 'id', theme: 'id' },
+        required: ['id', 'theme'],
+        children: ['theme_token', 'ui_override'],
+    },
+    ui_override: {
+        attributes: { target: 'string', ...styleAttributes, image: 'string' },
+        required: ['target'],
+        children: [],
+    },
+    component_variant: { attributes: { id: 'id', ...styleAttributes }, required: ['id'], children: [] },
+    ui_component: { attributes: { id: 'id', items_binding: 'id' }, required: ['id'], children: uiTags },
+    scene_definition: {
+        attributes: { id: 'id', theme: 'id' },
+        required: ['id', 'theme'],
+        children: ['scene_layer', 'scene_camera', ...uiTags],
+    },
+    scene_layer: {
+        ...tree,
+        attributes: { ...commonAttributes, space: ['world', 'screen'], adapter: 'id', image: 'string' },
+    },
+    scene_camera: {
+        attributes: { id: 'id', zoom: 'number', x: 'number', y: 'number', fit_width: 'number', fit_height: 'number' },
+        required: ['id'],
+        children: [],
+    },
+    ui_container: tree,
+    ui_row: { ...tree, attributes: { ...commonAttributes, wrap: 'boolean', align: ['start', 'center', 'end'] } },
+    ui_column: tree,
+    ui_grid: { ...tree, attributes: { ...commonAttributes, columns: 'integer' }, required: ['id', 'columns'] },
+    ui_label: {
+        ...tree,
+        attributes: { ...commonAttributes, text: 'string', text_binding: 'string' },
+        children: ['ui_state'],
+    },
+    ui_button: {
+        ...tree,
+        attributes: {
+            ...commonAttributes,
+            text: 'string',
+            text_binding: 'string',
+            action: 'id',
+            selected_binding: 'string',
+            disabled_binding: 'string',
+        },
+        children: ['ui_state'],
+    },
+    ui_bar: {
+        ...tree,
+        attributes: {
+            ...commonAttributes,
+            value: 'number',
+            max: 'number',
+            value_binding: 'string',
+            max_binding: 'string',
+            color_binding: 'string',
+        },
+        children: ['ui_state'],
+    },
+    ui_window: {
+        ...tree,
+        attributes: {
+            ...commonAttributes,
+            anchor: ['center', 'top', 'bottom'],
+            title: 'string',
+            title_binding: 'string',
+            modal: 'boolean',
+            closable: 'boolean',
+            close_action: 'id',
+        },
+    },
+    ui_repeat: {
+        ...tree,
+        attributes: { ...commonAttributes, items_binding: 'id', key: 'id' },
+        required: ['id', 'items_binding', 'key'],
+    },
+    ui_mount: {
+        ...tree,
+        attributes: { ...commonAttributes, component: 'id' },
+        required: ['id', 'component'],
+        children: [],
+    },
+    ui_adapter: {
+        ...tree,
+        attributes: { ...commonAttributes, adapter: 'id', image: 'string' },
+        required: ['id', 'adapter'],
+        children: [],
+    },
+    ui_state: {
+        attributes: { state: ['idle', 'hover', 'pressed', 'disabled', 'selected', 'focused'], ...styleAttributes },
+        required: ['state'],
+        children: [],
+    },
+};
+const bindingTypes = {
+    text_binding: 'string',
+    title_binding: 'string',
+    value_binding: 'number',
+    max_binding: 'number',
+    color_binding: 'number',
+    visible_binding: 'boolean',
+    selected_binding: 'boolean',
+    disabled_binding: 'boolean',
+};
+const semanticTokens = ['panel', 'text', 'accent', 'success', 'warning', 'danger', 'selection'];
+/** WCAG AA floor for body text, and for danger/selection indicators, against the panel. */
+const MIN_TEXT_CONTRAST = 4.5;
+const MIN_INDICATOR_CONTRAST = 3;
+/**
+ * Compiles optional scene/UI definitions, validating every reference against the game's manifest.
+ * Reusable components are expanded at build time; emitted data contains no parser or executable content.
+ *
+ * @example
+ * ```ts
+ * import { compilePresentation, emitPresentationModule } from '@datamoc/mw_games/mwl/presentation';
+ * const data = compilePresentation([], { values: {}, actions: [] });
+ * console.log(emitPresentationModule(data).startsWith('export const presentationData')); // true
+ * ```
+ */
+export function compilePresentation(files, manifest) {
+    const game = compileSources(files, { schemas: { ...schema10, ...vocabulary } });
+    const roots = game.roots;
+    const definitions = new Map();
+    const sources = new Map();
+    const mountedComponents = new Set();
+    const tokenUses = [];
+    const fail = (node, message) => {
+        const location = node.location;
+        throw new Error(`${location?.file ?? '<presentation>'}:${location?.line ?? 1}:${location?.column ?? 1}: ${message}`);
+    };
+    const keyOf = (tag, id) => `${tag}:${id}`;
+    const checkReferences = (node, attributes, fields) => {
+        if (attributes.variant)
+            find(node, 'component_variant', attributes.variant);
+        for (const name of ['action', 'close_action'])
+            if (attributes[name] && !manifest.actions.includes(attributes[name]))
+                fail(node, `unknown action "${attributes[name]}"`);
+        if (attributes.adapter && !manifest.adapters?.includes(attributes.adapter))
+            fail(node, `unknown adapter "${attributes.adapter}"`);
+        for (const [name, expected] of Object.entries(bindingTypes)) {
+            const binding = attributes[name];
+            if (!binding)
+                continue;
+            const actual = binding.startsWith('item.') ? fields?.[binding.slice(5)] : manifest.values[binding];
+            if (actual !== expected)
+                fail(node, `binding "${binding}" for ${name} must be ${expected}`);
+        }
+    };
+    for (const node of roots) {
+        if (node.attributes.id === '__proto__')
+            fail(node, 'reserved definition id "__proto__"');
+        if (![
+            'theme_definition',
+            'presentation_context',
+            'component_variant',
+            'ui_component',
+            'scene_definition',
+        ].includes(node.tag))
+            continue;
+        const key = keyOf(node.tag, node.attributes.id);
+        if (definitions.has(key))
+            fail(node, `duplicate ${key}`);
+        definitions.set(key, node);
+    }
+    const find = (node, tag, id) => definitions.get(keyOf(tag, id)) ?? fail(node, `unknown ${tag} "${id}"`);
+    const props = (node, excluded = ['id']) => Object.fromEntries(Object.entries(node.attributes).filter(([key]) => !excluded.includes(key)));
+    const validateStyle = (node) => {
+        if (node.attributes.image && !manifest.assets?.includes(node.attributes.image))
+            fail(node, `unknown asset "${node.attributes.image}"`);
+        for (const [name, value] of Object.entries(node.attributes)) {
+            if (name.endsWith('_token'))
+                tokenUses.push({ node, token: value });
+            if (['width', 'height', 'gap', 'padding'].includes(name) && Number(value) < 0)
+                fail(node, `${name} must be nonnegative`);
+            if (name === 'alpha' && (Number(value) < 0 || Number(value) > 1))
+                fail(node, 'alpha must be between 0 and 1');
+        }
+    };
+    const readTokens = (node) => {
+        const tokens = Object.create(null);
+        for (const child of node.children.filter((child) => child.tag === 'theme_token')) {
+            const { id, value } = child.attributes;
+            if (id === '__proto__')
+                fail(child, 'reserved token id "__proto__"');
+            const color = Number(value);
+            if (Object.hasOwn(tokens, id))
+                fail(child, `duplicate theme token "${id}"`);
+            if (!Number.isInteger(color) || color < 0 || color > 0xffffff)
+                fail(child, `token "${id}" must be a 24-bit color`);
+            tokens[id] = color;
+        }
+        return tokens;
+    };
+    const themes = Object.create(null);
+    const contexts = Object.create(null);
+    const variants = Object.create(null);
+    const scenes = Object.create(null);
+    for (const node of roots) {
+        const id = node.attributes.id;
+        if (node.tag === 'theme_definition') {
+            validateStyle(node);
+            if (node.attributes.font_size !== undefined && Number(node.attributes.font_size) <= 0)
+                fail(node, 'font_size must be positive');
+            const tokens = readTokens(node);
+            for (const token of semanticTokens)
+                if (!Object.hasOwn(tokens, token))
+                    fail(node, `missing semantic token "${token}"`);
+            themes[id] = { tokens, properties: props(node) };
+        }
+        else if (node.tag === 'component_variant') {
+            validateStyle(node);
+            variants[id] = props(node);
+        }
+    }
+    const buildTree = (nodes, prefix, fields, stack = []) => {
+        const siblings = new Set();
+        return nodes
+            .filter((node) => node.tag !== 'ui_state')
+            .map((node) => {
+            const id = node.attributes.id;
+            if (!id || siblings.has(id))
+                fail(node, `duplicate or missing component id "${id}" in ${prefix}`);
+            siblings.add(id);
+            const source = `${prefix}/${id}`;
+            sources.set(source, node);
+            validateStyle(node);
+            const attributes = node.attributes;
+            checkReferences(node, attributes, fields);
+            const states = Object.create(null);
+            for (const state of node.children.filter((child) => child.tag === 'ui_state')) {
+                if (Object.hasOwn(states, state.attributes.state))
+                    fail(state, `duplicate component state "${state.attributes.state}"`);
+                validateStyle(state);
+                states[state.attributes.state] = props(state, ['state']);
+            }
+            let childNodes;
+            if (node.tag === 'ui_mount') {
+                const name = attributes.component;
+                if (stack.includes(name))
+                    fail(node, `component cycle: ${[...stack, name].join(' -> ')}`);
+                mountedComponents.add(name);
+                const component = find(node, 'ui_component', name);
+                childNodes = buildTree(component.children, `component:${name}`, fields, [...stack, name]);
+            }
+            else if (node.tag === 'ui_repeat') {
+                const collection = manifest.values[attributes.items_binding];
+                if (!collection || typeof collection !== 'object' || collection.type !== 'items')
+                    fail(node, `unknown collection "${attributes.items_binding}"`);
+                const itemFields = collection.fields;
+                if (!['string', 'number'].includes(itemFields[attributes.key]))
+                    fail(node, `repeat key "${attributes.key}" must be a string or number field`);
+                if (node.children.filter((child) => child.tag !== 'ui_state').length !== 1)
+                    fail(node, 'ui_repeat needs exactly one template child');
+                childNodes = buildTree(node.children, source, itemFields, stack);
+            }
+            else
+                childNodes = buildTree(node.children, source, fields, stack);
+            if (node.tag === 'ui_grid' && Number(attributes.columns) < 1)
+                fail(node, 'grid columns must be positive');
+            if (node.tag === 'scene_camera') {
+                if (attributes.zoom !== undefined && Number(attributes.zoom) <= 0)
+                    fail(node, 'camera zoom must be positive');
+                if (Boolean(attributes.fit_width) !== Boolean(attributes.fit_height))
+                    fail(node, 'camera fit needs width and height');
+                if (attributes.fit_width &&
+                    (Number(attributes.fit_width) <= 0 || Number(attributes.fit_height) <= 0))
+                    fail(node, 'camera fit dimensions must be positive');
+            }
+            return { kind: node.tag, id, source, properties: props(node), states, children: childNodes };
+        });
+    };
+    function componentFields(node) {
+        if (!node.attributes.items_binding)
+            return undefined;
+        const collection = manifest.values[node.attributes.items_binding];
+        if (typeof collection !== 'object' || collection.type !== 'items')
+            fail(node, `unknown collection "${node.attributes.items_binding}"`);
+        return collection.fields;
+    }
+    for (const node of roots.filter((node) => node.tag === 'scene_definition')) {
+        find(node, 'theme_definition', node.attributes.theme);
+        if (node.children.filter((child) => child.tag === 'scene_camera').length > 1)
+            fail(node, 'a scene can have only one camera');
+        scenes[node.attributes.id] = {
+            theme: node.attributes.theme,
+            children: buildTree(node.children, `scene:${node.attributes.id}`),
+        };
+    }
+    // Validate unused reusable definitions too; an unmounted typo must not escape the build.
+    for (const node of roots.filter((node) => node.tag === 'ui_component')) {
+        if (!mountedComponents.has(node.attributes.id))
+            buildTree(node.children, `component:${node.attributes.id}`, componentFields(node), [node.attributes.id]);
+    }
+    for (const node of roots.filter((node) => node.tag === 'presentation_context')) {
+        find(node, 'theme_definition', node.attributes.theme);
+        const overrides = Object.create(null);
+        for (const override of node.children.filter((child) => child.tag === 'ui_override')) {
+            const target = override.attributes.target;
+            if (!sources.has(target))
+                fail(override, `unknown override target "${target}"`);
+            const targetNode = sources.get(target);
+            if (override.attributes.image && !['scene_layer', 'ui_adapter'].includes(targetNode.tag))
+                fail(override, 'image overrides require a scene layer or adapter');
+            if (Object.hasOwn(overrides, target))
+                fail(override, `duplicate override target "${target}"`);
+            validateStyle(override);
+            overrides[target] = props(override, ['target']);
+        }
+        const tokens = readTokens(node);
+        for (const token of Object.keys(tokens))
+            if (!Object.hasOwn(themes[node.attributes.theme].tokens, token))
+                fail(node, `unknown context token "${token}"`);
+        contexts[node.attributes.id] = { theme: node.attributes.theme, tokens, overrides };
+    }
+    const checkPalette = (node, tokens) => {
+        for (const use of tokenUses)
+            if (!Object.hasOwn(tokens, use.token))
+                fail(use.node, `unknown theme token "${use.token}" in ${node.attributes.id}`);
+        if (contrastRatio(tokens.text, tokens.panel) < MIN_TEXT_CONTRAST)
+            fail(node, 'text/panel contrast must reach 4.5');
+        for (const token of ['danger', 'selection'])
+            if (contrastRatio(tokens[token], tokens.panel) < MIN_INDICATOR_CONTRAST)
+                fail(node, `${token}/panel contrast must reach 3`);
+    };
+    for (const node of roots.filter((node) => node.tag === 'theme_definition'))
+        checkPalette(node, themes[node.attributes.id].tokens);
+    for (const node of roots.filter((node) => node.tag === 'presentation_context')) {
+        const context = contexts[node.attributes.id];
+        checkPalette(node, { ...themes[context.theme].tokens, ...context.tokens });
+    }
+    const ids = [];
+    const collect = (nodes, prefix) => {
+        for (const node of nodes) {
+            const path = `${prefix}/${node.id}`;
+            ids.push(path);
+            collect(node.children, node.kind === 'ui_repeat' ? `${path}/*` : path);
+        }
+    };
+    for (const [id, scene] of Object.entries(scenes))
+        collect(scene.children, id);
+    return {
+        scenes,
+        themes,
+        contexts,
+        variants,
+        manifest,
+        ids: ids.sort(),
+        assets: game.assets,
+        messages: game.messages,
+    };
+}
+/**
+ * Emits data and literal ID types for a game's build script to write alongside its other MWL artifacts.
+ * @example
+ * ```ts
+ * import { compilePresentation, emitPresentationModule } from '@datamoc/mw_games/mwl/presentation';
+ * console.log(emitPresentationModule(compilePresentation([], { values: {}, actions: [] })));
+ * ```
+ */
+export function emitPresentationModule(data) {
+    return `export const presentationData = ${JSON.stringify(data, null, '\t')} as const;\ntype ExpandRepeat<S extends string> = S extends \`\${infer Prefix}/*/\${infer Rest}\` ? \`\${Prefix}/\${string}/\${ExpandRepeat<Rest>}\` : S;\nexport type PresentationId = ExpandRepeat<typeof presentationData.ids[number]>;\nexport type PresentationSceneId = keyof typeof presentationData.scenes;\n`;
+}
+//# sourceMappingURL=presentation.js.map

package/dist/mwl/presentation.js.map

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

package/dist/physics/PhysicsWorld.d.ts

@@ -1,7 +1,6 @@
-import Matter from 'matter-js';
 import { Signal } from '../core/Signal.ts';
 export interface PhysicsOptions {
-    /** gravity strength per axis; y grows downward. { x: 0, y: 9.8 } (the default) matches matter-js's own default pull */
+    /** gravity strength per axis; y grows downward. The default matches matter-js's historical default pull */
     gravity?: {
         x: number;
         y: number;
@@ -17,8 +16,9 @@ export interface BodyOptions {
     /** 0 to 1, how much of its speed a bounce keeps; 0 when omitted */
     restitution?: number;
     friction?: number;
-    /** mass per unit area; matter-js's default when omitted */
+    /** mass per unit area; 1 when omitted */
     density?: number;
+    /** initial rotation in radians; bodies never spin, this is a display offset for sprites */
     angle?: number;
     /** a name for collision callbacks and lookups */
     label?: string;
@@ -26,6 +26,7 @@ export interface BodyOptions {
 export interface ConstraintOptions {
     /** 0 to 1, how rigidly the ends are held: 1 is a rod, a small value a spring; 1 when omitted */
     stiffness?: number;
+    /** 0 to 1, the share of radial oscillation removed per step; 0 when omitted */
     damping?: number;
     /** rest length; the distance between the attachment points when omitted */
     length?: number;
@@ -48,19 +49,45 @@ export interface ConstraintOptions {
      */
     maxStretch?: number;
 }
-export type PhysicsBody = Matter.Body;
-export type PhysicsConstraint = Matter.Constraint;
+/** a rigid body: a circle or an axis-aligned box with mutable position and velocity */
+export interface PhysicsBody {
+    /** centre in world units; assign to teleport (velocity is left untouched) */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** world units per second; assign to shove */
+    velocity: {
+        x: number;
+        y: number;
+    };
+    /** rotation in radians; never integrated, a display offset for sprites */
+    angle: number;
+    /** collision name, '' when unnamed */
+    label: string;
+    /** true for ground and anchors: infinite mass, never moves */
+    readonly isStatic: boolean;
+}
+/** a distance joint between two bodies, or a body and a fixed world point */
+export interface PhysicsConstraint {
+    /** rest length both ends are held at */
+    readonly length: number;
+}
 /**
- * Rigid bodies and constraints through matter-js, stepped on a fixed clock.
+ * Rigid bodies and constraints in plain TypeScript, stepped on a fixed clock.
+ *
+ * The framework side of game physics in a mwg game: it owns the solver, steps it with a
+ * `FixedStepper` so the simulation is the same at any display refresh rate, and reports
+ * contacts through a `Signal`, while leaving the bodies themselves as plain objects a game
+ * reads `position` and `angle` from to place its sprites. It is renderer-free, so a game's
+ * headless tests can run the same world. No third-party engine: semi-implicit Euler,
+ * impulse contacts with restitution and Coulomb friction, and projected distance joints.
  *
- * The adapter is the framework side of using matter-js in a mwg game: it owns the `Engine`,
- * steps it with a `FixedStepper` so the simulation is the same at any display refresh rate,
- * and reports contacts through a `Signal`, while leaving the bodies themselves as plain
- * matter-js objects a game reads `position` and `angle` from to place its sprites. It is
- * renderer-free, so a game's headless tests can run the same world.
+ * Bodies never spin: `angle` stays where a game puts it (a display offset), collisions use
+ * the unrotated shape, and joints rotate their attachment points by it. Circles and
+ * axis-aligned boxes collide with each other in every pairing; that is the whole shape
+ * catalogue, by design rather than by omission - a game needing polygons brings its own.
  *
- * `matter-js` is an optional peer dependency (`npm install matter-js`), imported only by this
- * module (`@datamoc/mw_games/physics`), so a game that never simulates physics never bundles it.
  * Constraints are springs and rods. Give one a `maxStretch` and it breaks when pulled that far
  * past its rest length (`onBreak`); a game with a different stress rule reads `stretchOf` itself
  * and calls `remove`.
@@ -77,8 +104,7 @@ export type PhysicsConstraint = Matter.Constraint;
  * ```
  */
 export declare class PhysicsWorld {
-    readonly engine: Matter.Engine;
-    /** fires once per new contact between two bodies, with the matter-js bodies of the pair */
+    /** fires once per new contact between two bodies, with the bodies of the pair */
     readonly onContact: Signal<{
         a: PhysicsBody;
         b: PhysicsBody;
@@ -89,7 +115,11 @@ export declare class PhysicsWorld {
         stretch: number;
     }>;
     private readonly stepper;
-    private readonly breakable;
+    private readonly gravity;
+    private readonly bodies_;
+    private readonly constraints_;
+    private touching;
+    private nextId;
     constructor(options?: PhysicsOptions);
     get bodies(): readonly PhysicsBody[];
     get constraints(): readonly PhysicsConstraint[];
@@ -103,7 +133,7 @@ export declare class PhysicsWorld {
         x: number;
         y: number;
     }, options?: ConstraintOptions): PhysicsConstraint;
-    /** removes a body, or a constraint, from the simulation */
+    /** removes a body (with its joints), or a constraint, from the simulation */
     remove(item: PhysicsBody | PhysicsConstraint): void;
     /**
      * How far a constraint is stretched past its rest length, as a fraction of it (0.1 is 10%
@@ -117,6 +147,8 @@ export declare class PhysicsWorld {
      * @returns how many fixed steps ran
      */
     update(dt: number): number;
+    private step;
+    private collide;
     private breakOverstretched;
     private add;
 }