@toonstrip/pack-example 0.1.0

package/NOTICE

@@ -0,0 +1,9 @@
+@toonstrip/pack-example
+
+All art in this package (characters/pip, backdrops/meadow) is original,
+procedurally generated for this project by scripts/generate.mjs — plain
+canvas-drawing code, not AI image generation and not derived from Microsoft
+Comic Chat or any other third-party asset. No third-party attribution is
+required for this pack.
+
+Licensed under the MIT License (see the repository root LICENSE).

package/characters/pip/pip.json

@@ -0,0 +1,108 @@
+{
+  "name": "Pip",
+  "type": "COMPLEX",
+  "torsoFirst": false,
+  "sheet": "sheet.png",
+  "sheetWidth": 240,
+  "sheetHeight": 160,
+  "torsos": [
+    {
+      "kind": "torso",
+      "index": 0,
+      "emotion": "NEUTRAL",
+      "angle": 0,
+      "intensity": 0,
+      "cx": 40,
+      "cy": 8,
+      "cxDelta": 0,
+      "cyDelta": 0,
+      "x": 40,
+      "figure": {
+        "x": 0,
+        "y": 0,
+        "width": 80,
+        "height": 90
+      },
+      "aura": null
+    },
+    {
+      "kind": "torso",
+      "index": 1,
+      "emotion": "WAVE",
+      "angle": 1001,
+      "intensity": 1,
+      "cx": 40,
+      "cy": 8,
+      "cxDelta": 0,
+      "cyDelta": 0,
+      "x": 40,
+      "figure": {
+        "x": 80,
+        "y": 0,
+        "width": 80,
+        "height": 90
+      },
+      "aura": null
+    },
+    {
+      "kind": "torso",
+      "index": 2,
+      "emotion": "SHRUG",
+      "angle": 1005,
+      "intensity": 1,
+      "cx": 40,
+      "cy": 8,
+      "cxDelta": 0,
+      "cyDelta": 0,
+      "x": 40,
+      "figure": {
+        "x": 160,
+        "y": 0,
+        "width": 80,
+        "height": 90
+      },
+      "aura": null
+    }
+  ],
+  "faces": [
+    {
+      "kind": "face",
+      "index": 0,
+      "emotion": "NEUTRAL",
+      "angle": 0,
+      "intensity": 0,
+      "cx": 35,
+      "cy": 40,
+      "cxDelta": 0,
+      "cyDelta": 0,
+      "x": 35,
+      "figure": {
+        "x": 0,
+        "y": 90,
+        "width": 70,
+        "height": 70
+      },
+      "aura": null
+    },
+    {
+      "kind": "face",
+      "index": 1,
+      "emotion": "HAPPY",
+      "angle": 0,
+      "intensity": 1,
+      "cx": 35,
+      "cy": 40,
+      "cxDelta": 0,
+      "cyDelta": -2,
+      "x": 35,
+      "figure": {
+        "x": 70,
+        "y": 90,
+        "width": 70,
+        "height": 70
+      },
+      "aura": null
+    }
+  ],
+  "bodies": []
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { CastManifest, PackJson } from "./types.js";
+export type { CastManifest, PackedAvatar, PackedBackdrop, PackedPart, SheetRect, PackJson } from "./types.js";
+/** Absolute path to this pack's root directory (where `pack.json` lives). */
+export declare function packRoot(): string;
+/** This pack's `pack.json`, unmodified. */
+export declare function loadPackJson(): PackJson;
+/**
+ * Assembles a `CastManifest` (the shape `packages/core` consumes) from
+ * `pack.json` plus each character's per-character manifest. `sheet` paths are
+ * rewritten to absolute paths so a caller can load them from any cwd.
+ */
+export declare function loadCastManifest(): CastManifest;

package/dist/index.js

@@ -0,0 +1,30 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const PACK_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+/** Absolute path to this pack's root directory (where `pack.json` lives). */
+export function packRoot() {
+    return PACK_ROOT;
+}
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+/** This pack's `pack.json`, unmodified. */
+export function loadPackJson() {
+    return readJson(join(PACK_ROOT, "pack.json"));
+}
+/**
+ * Assembles a `CastManifest` (the shape `packages/core` consumes) from
+ * `pack.json` plus each character's per-character manifest. `sheet` paths are
+ * rewritten to absolute paths so a caller can load them from any cwd.
+ */
+export function loadCastManifest() {
+    const pack = loadPackJson();
+    const cast = {};
+    for (const entry of pack.characters) {
+        const avatar = readJson(join(PACK_ROOT, entry.manifest));
+        cast[entry.id] = { ...avatar, sheet: join(PACK_ROOT, entry.sheet) };
+    }
+    const backdrops = pack.backdrops.map((b) => ({ ...b, file: join(PACK_ROOT, b.file) }));
+    return { version: 1, cast, backdrops };
+}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Local copies of the pack contract shapes, kept independent of
+ * `@toonstrip/core` (see dev plan §2: "asset packs depend on schema only").
+ * Identical in shape to `@toonstrip/pack-comic-chat`'s own `src/types.ts` —
+ * every pack carries its own copy rather than importing a shared one, which
+ * is itself part of what this pack exists to prove (see docs/packs.md and
+ * NOTES.md "M5").
+ */
+export interface SheetRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PackedPart {
+    kind: "face" | "torso" | "body";
+    index: number;
+    emotion: string;
+    angle: number;
+    intensity: number;
+    cx: number;
+    cy: number;
+    cxDelta: number;
+    cyDelta: number;
+    x: number;
+    figure: SheetRect;
+    aura: SheetRect | null;
+}
+export interface PackedAvatar {
+    name: string;
+    type: string;
+    torsoFirst: boolean;
+    sheet: string;
+    sheetWidth: number;
+    sheetHeight: number;
+    faces: PackedPart[];
+    torsos: PackedPart[];
+    bodies: PackedPart[];
+}
+export interface PackedBackdrop {
+    id: string;
+    file: string;
+    width: number;
+    height: number;
+}
+export interface CastManifest {
+    version: 1;
+    cast: Record<string, PackedAvatar>;
+    backdrops: PackedBackdrop[];
+}
+export interface PackJson {
+    name: string;
+    version: string;
+    license: string;
+    characters: {
+        id: string;
+        name: string;
+        manifest: string;
+        sheet: string;
+    }[];
+    backdrops: PackedBackdrop[];
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Local copies of the pack contract shapes, kept independent of
+ * `@toonstrip/core` (see dev plan §2: "asset packs depend on schema only").
+ * Identical in shape to `@toonstrip/pack-comic-chat`'s own `src/types.ts` —
+ * every pack carries its own copy rather than importing a shared one, which
+ * is itself part of what this pack exists to prove (see docs/packs.md and
+ * NOTES.md "M5").
+ */
+export {};

package/pack.json

@@ -0,0 +1,21 @@
+{
+  "name": "example",
+  "version": "0.1.0",
+  "license": "MIT",
+  "characters": [
+    {
+      "id": "pip",
+      "name": "Pip",
+      "manifest": "characters/pip/pip.json",
+      "sheet": "characters/pip/sheet.png"
+    }
+  ],
+  "backdrops": [
+    {
+      "id": "meadow",
+      "file": "backdrops/meadow.png",
+      "width": 240,
+      "height": 240
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@toonstrip/pack-example",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "pack.json",
+    "characters",
+    "backdrops",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "generate": "node scripts/generate.mjs",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@napi-rs/canvas": "^0.1.65",
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}