@pibbl/core 0.0.1

package/dist/features/physics/lib/2d/canvas/custom.js

@@ -0,0 +1,45 @@
+import {
+  pibblInternalRunPurePrimitiveResolver,
+  derivePrimitive
+} from "@pibbl/core/internal";
+import { requireShapeRecord2D } from "../shape-records.js";
+import { installCustomShapeResolver2D } from "./inference.js";
+function withPhysicsShape2D(component, options) {
+  if (typeof options.resolveShape !== "function") {
+    throw new TypeError("withPhysicsShape2D options.resolveShape must be a function.");
+  }
+  const derived = derivePrimitive(component);
+  installCustomShapeResolver2D(derived, (style) => {
+    const snapshot = immutableSnapshot(style);
+    const result = pibblInternalRunPurePrimitiveResolver(
+      () => options.resolveShape(snapshot)
+    );
+    if (isThenable(result)) {
+      throw new TypeError("A physics 2D shape resolver must return synchronously, not a Promise.");
+    }
+    try {
+      requireShapeRecord2D(result);
+    } catch {
+      throw new TypeError("A physics 2D shape resolver must return a Pibbl physics 2D shape.");
+    }
+    return result;
+  });
+  return derived;
+}
+function immutableSnapshot(value) {
+  if (Array.isArray(value)) return Object.freeze(value.map(immutableSnapshot));
+  if (typeof value !== "object" || value === null) return value;
+  if (typeof Path2D !== "undefined" && value instanceof Path2D || typeof CanvasGradient !== "undefined" && value instanceof CanvasGradient || typeof CanvasPattern !== "undefined" && value instanceof CanvasPattern) return value;
+  const copy = {};
+  for (const key of Reflect.ownKeys(value)) {
+    copy[key] = immutableSnapshot(value[key]);
+  }
+  return Object.freeze(copy);
+}
+function isThenable(value) {
+  return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+export {
+  withPhysicsShape2D
+};
+//# sourceMappingURL=custom.js.map

package/dist/features/physics/lib/2d/canvas/custom.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/features/physics/lib/2d/canvas/custom.ts"],
+  "sourcesContent": ["import type { PibblPrimitiveComponent } from '@pibbl/core';\nimport {\n  pibblInternalRunPurePrimitiveResolver,\n  derivePrimitive,\n} from '@pibbl/core/internal';\nimport type { PibblPhysicsShape2D } from '../../../2d-geometry.js';\nimport type {\n  PibblPhysicsAttachment2D,\n  PibblPhysicsPrimitiveProps2D,\n} from '../types.js';\nimport { requireShapeRecord2D } from '../shape-records.js';\nimport { installCustomShapeResolver2D } from './inference.js';\n\n/**\n * Adds physics-attachment support to a custom primitive using its resolved-style shape callback.\n *\n * @param component - Primitive whose rendered style determines its collision shape. See\n * {@link PibblPrimitiveComponent} .\n * @param options - Pure resolver deriving collision geometry from resolved style. See\n * {@link PibblPhysicsShape2D} .\n * @returns A derived primitive accepting the public physics attachment prop. See\n * {@link PibblPrimitiveComponent} , {@link PibblPhysicsPrimitiveProps2D} ,\n * {@link PibblPhysicsAttachment2D} .\n *\n * @see {@link PibblPrimitiveComponent}\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPrimitiveProps2D}\n * @see {@link PibblPhysicsAttachment2D}\n */\nexport function withPhysicsShape2D<P, I, ResolvedStyle>(\n  component: PibblPrimitiveComponent<P, I>,\n  options: Readonly<{\n    resolveShape(style: Readonly<ResolvedStyle>): PibblPhysicsShape2D;\n  }>,\n): PibblPrimitiveComponent<\n  P & PibblPhysicsPrimitiveProps2D,\n  I & { readonly physics?: PibblPhysicsAttachment2D }\n> {\n  if (typeof options.resolveShape !== 'function') {\n    throw new TypeError('withPhysicsShape2D options.resolveShape must be a function.');\n  }\n  const derived = derivePrimitive(component) as PibblPrimitiveComponent<\n    P & PibblPhysicsPrimitiveProps2D,\n    I & { readonly physics?: PibblPhysicsAttachment2D }\n  >;\n  installCustomShapeResolver2D(derived, style => {\n    const snapshot = immutableSnapshot(style) as Readonly<ResolvedStyle>;\n    const result = pibblInternalRunPurePrimitiveResolver(() =>\n      options.resolveShape(snapshot)\n    );\n    if (isThenable(result)) {\n      throw new TypeError('A physics 2D shape resolver must return synchronously, not a Promise.');\n    }\n    try {\n      requireShapeRecord2D(result);\n    } catch {\n      throw new TypeError('A physics 2D shape resolver must return a Pibbl physics 2D shape.');\n    }\n    return result;\n  });\n  return derived;\n}\n\nfunction immutableSnapshot(value: unknown): unknown {\n  if (Array.isArray(value)) return Object.freeze(value.map(immutableSnapshot));\n  if (typeof value !== 'object' || value === null) return value;\n  if (\n    (typeof Path2D !== 'undefined' && value instanceof Path2D) ||\n    (typeof CanvasGradient !== 'undefined' && value instanceof CanvasGradient) ||\n    (typeof CanvasPattern !== 'undefined' && value instanceof CanvasPattern)\n  ) return value;\n  const copy: Record<PropertyKey, unknown> = {};\n  for (const key of Reflect.ownKeys(value)) {\n    copy[key] = immutableSnapshot((value as Record<PropertyKey, unknown>)[key]);\n  }\n  return Object.freeze(copy);\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return typeof value === 'object' && value !== null &&\n    typeof (value as { then?: unknown }).then === 'function';\n}\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAMP,SAAS,4BAA4B;AACrC,SAAS,oCAAoC;AAkBtC,SAAS,mBACd,WACA,SAMA;AACA,MAAI,OAAO,QAAQ,iBAAiB,YAAY;AAC9C,UAAM,IAAI,UAAU,6DAA6D;AAAA,EACnF;AACA,QAAM,UAAU,gBAAgB,SAAS;AAIzC,+BAA6B,SAAS,WAAS;AAC7C,UAAM,WAAW,kBAAkB,KAAK;AACxC,UAAM,SAAS;AAAA,MAAsC,MACnD,QAAQ,aAAa,QAAQ;AAAA,IAC/B;AACA,QAAI,WAAW,MAAM,GAAG;AACtB,YAAM,IAAI,UAAU,uEAAuE;AAAA,IAC7F;AACA,QAAI;AACF,2BAAqB,MAAM;AAAA,IAC7B,QAAQ;AACN,YAAM,IAAI,UAAU,mEAAmE;AAAA,IACzF;AACA,WAAO;AAAA,EACT,CAAC;AACD,SAAO;AACT;AAEA,SAAS,kBAAkB,OAAyB;AAClD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,OAAO,OAAO,MAAM,IAAI,iBAAiB,CAAC;AAC3E,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,MACG,OAAO,WAAW,eAAe,iBAAiB,UAClD,OAAO,mBAAmB,eAAe,iBAAiB,kBAC1D,OAAO,kBAAkB,eAAe,iBAAiB,cAC1D,QAAO;AACT,QAAM,OAAqC,CAAC;AAC5C,aAAW,OAAO,QAAQ,QAAQ,KAAK,GAAG;AACxC,SAAK,GAAG,IAAI,kBAAmB,MAAuC,GAAG,CAAC;AAAA,EAC5E;AACA,SAAO,OAAO,OAAO,IAAI;AAC3B;AAEA,SAAS,WAAW,OAA+C;AACjE,SAAO,OAAO,UAAU,YAAY,UAAU,QAC5C,OAAQ,MAA6B,SAAS;AAClD;",
+  "names": []
+}

package/dist/features/physics/lib/2d/canvas/debug.d.ts

@@ -0,0 +1,23 @@
+import type { PibblPhysicsWorldHandle2D } from "../types.js";
+/**
+ * Authored inputs for PhysicsDebug2D, including the declared data and presentation options.
+ *
+ * @see {@link PibblPhysicsWorldHandle2D}
+ * @see {@link PhysicsDebug2D}
+ */
+export interface PibblPhysicsDebug2DProps {
+    /** World identity whose state is queried or drawn. See {@link PibblPhysicsWorldHandle2D}. */
+    readonly world: PibblPhysicsWorldHandle2D;
+    /** Color used by the mark or effect. See {@link PibblPhysicsDebug2DProps}. */
+    readonly color?: string;
+}
+/**
+ * Read-only authoritative bounds, mass centers and contact normals; no hit targets.
+ *
+ * @param props - Authored component inputs, supplied through JSX or createElement. See the linked
+ * props and style types.
+ * @throws When called directly; Pibbl mounts this component through JSX or createElement.
+ *
+ * @see {@link PibblPhysicsDebug2DProps}
+ */
+export declare const PhysicsDebug2D: import("@pibbl/core").PibblPrimitiveComponent<PibblPhysicsDebug2DProps, import("@pibbl/core").PrimitiveInput<PibblPhysicsDebug2DProps, import("@pibbl/core").SystemStyle>>;

package/dist/features/physics/lib/2d/canvas/debug.js

@@ -0,0 +1,53 @@
+import { definePrimitive } from "@pibbl/core";
+import { pibblInternalCurrentWorldTransform } from "@pibbl/core/internal";
+import { requirePhysicsWorld2DController } from "../runtime/controller.js";
+const PhysicsDebug2D = definePrimitive(
+  (props, _style, context) => {
+    props.world.revision.get();
+    const controller = requirePhysicsWorld2DController(props.world);
+    const snapshot = controller.inspect();
+    const transform = pibblInternalCurrentWorldTransform().inverse().multiply(controller.rootTransform(new DOMMatrix()));
+    context.save();
+    try {
+      context.transform(
+        transform.a,
+        transform.b,
+        transform.c,
+        transform.d,
+        transform.e,
+        transform.f
+      );
+      context.strokeStyle = props.color ?? "#16a34a";
+      context.fillStyle = props.color ?? "#16a34a";
+      context.lineWidth = 1;
+      for (const collider of snapshot.colliders) {
+        const { min, max } = collider.bounds;
+        context.strokeRect(min[0], min[1], max[0] - min[0], max[1] - min[1]);
+      }
+      context.beginPath();
+      for (const body of snapshot.bodies) {
+        const [x, y] = body.centerOfMass;
+        context.moveTo(x - 3, y);
+        context.lineTo(x + 3, y);
+        context.moveTo(x, y - 3);
+        context.lineTo(x, y + 3);
+      }
+      for (const contact of snapshot.contacts)
+        for (const point of contact.points) {
+          const [x, y] = point.pointOnFirst;
+          context.moveTo(x, y);
+          context.lineTo(
+            x + 12 * contact.normal[0],
+            y + 12 * contact.normal[1]
+          );
+        }
+      context.stroke();
+    } finally {
+      context.restore();
+    }
+  }
+);
+export {
+  PhysicsDebug2D
+};
+//# sourceMappingURL=debug.js.map

package/dist/features/physics/lib/2d/canvas/debug.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/features/physics/lib/2d/canvas/debug.ts"],
+  "sourcesContent": ["import { definePrimitive } from \"@pibbl/core\";\nimport { pibblInternalCurrentWorldTransform } from \"@pibbl/core/internal\";\nimport type { PibblPhysicsWorldHandle2D } from \"../types.js\";\nimport { requirePhysicsWorld2DController } from \"../runtime/controller.js\";\n\n/**\n * Authored inputs for PhysicsDebug2D, including the declared data and presentation options.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PhysicsDebug2D}\n */\nexport interface PibblPhysicsDebug2DProps {\n  /** World identity whose state is queried or drawn. See {@link PibblPhysicsWorldHandle2D}. */\n  readonly world: PibblPhysicsWorldHandle2D;\n  /** Color used by the mark or effect. See {@link PibblPhysicsDebug2DProps}. */\n  readonly color?: string;\n}\n\n/**\n * Read-only authoritative bounds, mass centers and contact normals; no hit targets.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link PibblPhysicsDebug2DProps}\n */\nexport const PhysicsDebug2D = definePrimitive<PibblPhysicsDebug2DProps>(\n  (props, _style, context) => {\n    props.world.revision.get();\n    const controller = requirePhysicsWorld2DController(props.world);\n    const snapshot = controller.inspect();\n    const transform = pibblInternalCurrentWorldTransform()\n      .inverse()\n      .multiply(controller.rootTransform(new DOMMatrix()));\n    context.save();\n    try {\n      context.transform(\n        transform.a,\n        transform.b,\n        transform.c,\n        transform.d,\n        transform.e,\n        transform.f,\n      );\n      context.strokeStyle = props.color ?? \"#16a34a\";\n      context.fillStyle = props.color ?? \"#16a34a\";\n      context.lineWidth = 1;\n      for (const collider of snapshot.colliders) {\n        const { min, max } = collider.bounds;\n        context.strokeRect(min[0], min[1], max[0] - min[0], max[1] - min[1]);\n      }\n      context.beginPath();\n      for (const body of snapshot.bodies) {\n        const [x, y] = body.centerOfMass;\n        context.moveTo(x - 3, y);\n        context.lineTo(x + 3, y);\n        context.moveTo(x, y - 3);\n        context.lineTo(x, y + 3);\n      }\n      for (const contact of snapshot.contacts)\n        for (const point of contact.points) {\n          const [x, y] = point.pointOnFirst;\n          context.moveTo(x, y);\n          context.lineTo(\n            x + 12 * contact.normal[0],\n            y + 12 * contact.normal[1],\n          );\n        }\n      context.stroke();\n    } finally {\n      context.restore();\n    }\n  },\n);\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,0CAA0C;AAEnD,SAAS,uCAAuC;AAwBzC,MAAM,iBAAiB;AAAA,EAC5B,CAAC,OAAO,QAAQ,YAAY;AAC1B,UAAM,MAAM,SAAS,IAAI;AACzB,UAAM,aAAa,gCAAgC,MAAM,KAAK;AAC9D,UAAM,WAAW,WAAW,QAAQ;AACpC,UAAM,YAAY,mCAAmC,EAClD,QAAQ,EACR,SAAS,WAAW,cAAc,IAAI,UAAU,CAAC,CAAC;AACrD,YAAQ,KAAK;AACb,QAAI;AACF,cAAQ;AAAA,QACN,UAAU;AAAA,QACV,UAAU;AAAA,QACV,UAAU;AAAA,QACV,UAAU;AAAA,QACV,UAAU;AAAA,QACV,UAAU;AAAA,MACZ;AACA,cAAQ,cAAc,MAAM,SAAS;AACrC,cAAQ,YAAY,MAAM,SAAS;AACnC,cAAQ,YAAY;AACpB,iBAAW,YAAY,SAAS,WAAW;AACzC,cAAM,EAAE,KAAK,IAAI,IAAI,SAAS;AAC9B,gBAAQ,WAAW,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AAAA,MACrE;AACA,cAAQ,UAAU;AAClB,iBAAW,QAAQ,SAAS,QAAQ;AAClC,cAAM,CAAC,GAAG,CAAC,IAAI,KAAK;AACpB,gBAAQ,OAAO,IAAI,GAAG,CAAC;AACvB,gBAAQ,OAAO,IAAI,GAAG,CAAC;AACvB,gBAAQ,OAAO,GAAG,IAAI,CAAC;AACvB,gBAAQ,OAAO,GAAG,IAAI,CAAC;AAAA,MACzB;AACA,iBAAW,WAAW,SAAS;AAC7B,mBAAW,SAAS,QAAQ,QAAQ;AAClC,gBAAM,CAAC,GAAG,CAAC,IAAI,MAAM;AACrB,kBAAQ,OAAO,GAAG,CAAC;AACnB,kBAAQ;AAAA,YACN,IAAI,KAAK,QAAQ,OAAO,CAAC;AAAA,YACzB,IAAI,KAAK,QAAQ,OAAO,CAAC;AAAA,UAC3B;AAAA,QACF;AACF,cAAQ,OAAO;AAAA,IACjB,UAAE;AACA,cAAQ,QAAQ;AAAA,IAClB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/features/physics/lib/2d/canvas/inference.d.ts

@@ -0,0 +1,9 @@
+import type { PibblPhysicsShape2D } from "../../../2d-geometry.js";
+export interface CanvasColliderInferenceInput2D {
+    readonly componentType: Function;
+    readonly componentName: string;
+    readonly style: Readonly<Record<PropertyKey, unknown>>;
+}
+export declare function installCustomShapeResolver2D(component: Function, resolver: (style: Readonly<Record<PropertyKey, unknown>>) => PibblPhysicsShape2D): void;
+export declare function inferCanvasColliderShape2D(input: CanvasColliderInferenceInput2D): PibblPhysicsShape2D;
+export declare function bakeCanvasShapeTransform2D(shape: PibblPhysicsShape2D, transform: DOMMatrixReadOnly): PibblPhysicsShape2D;