@sudobility/music_types 0.11.4 → 0.11.7

package/dist/platform/index.d.ts

@@ -8,4 +8,5 @@ export * from './playback.js';
 export * from './xml.js';
 export * from './file.js';
 export * from './midi.js';
+export * from './mod.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/platform/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/platform/index.js

@@ -8,4 +8,5 @@ export * from './playback.js';
 export * from './xml.js';
 export * from './file.js';
 export * from './midi.js';
+export * from './mod.js';
 //# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/platform/mod.d.ts

@@ -0,0 +1,49 @@
+/**
+ * A neutral model of an Amiga tracker module, shaped by exactly what the
+ * `.MOD` importer in music_lib reads — so that music_lib carries no byte
+ * handling of its own, the same split `MidiFile` uses.
+ *
+ * Decoding stops at this shape deliberately. Turning periods into pitches and
+ * speed/tempo into a `TempoMap` is musical work, so it lives in music_lib;
+ * only the byte reading is platform-shaped, and even that is shared by all
+ * three `MusicIo` implementations rather than reimplemented per platform.
+ */
+/** A sampled instrument slot. Names are free text and often decorative or empty. */
+export type ModSample = {
+    index: number;
+    name: string;
+};
+/**
+ * One channel's cell in one row.
+ *
+ * `period` is the Amiga period value, not a pitch: 0 means "no note here",
+ * which is why this is not an optional field. `sample` is 0 for "keep
+ * whatever this channel was already playing".
+ */
+export type ModCell = {
+    sample: number;
+    period: number;
+    effect: number;
+    param: number;
+};
+export type ModFile = {
+    title: string;
+    channels: number;
+    samples: ModSample[];
+    /** Pattern indices in playback order; a pattern played three times appears three times. */
+    order: number[];
+    /** `patterns[pattern][row][channel]`. */
+    patterns: ModCell[][][];
+};
+/**
+ * Reading a `.MOD` file.
+ *
+ * A capability for surface consistency — the app reaches every file format
+ * through `getAppServices().io` — even though nothing about parsing is
+ * platform-bound. All three implementations delegate to one shared module.
+ */
+export interface ModCodec {
+    /** Decode a ProTracker module. Throws on anything that is not one, rather than returning a garbage file that looks imported. */
+    decode(bytes: ArrayBuffer): ModFile;
+}
+//# sourceMappingURL=mod.d.ts.map

package/dist/platform/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/platform/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,gIAAgI;IAChI,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;CACrC"}

package/dist/platform/mod.js

@@ -0,0 +1,12 @@
+/**
+ * A neutral model of an Amiga tracker module, shaped by exactly what the
+ * `.MOD` importer in music_lib reads — so that music_lib carries no byte
+ * handling of its own, the same split `MidiFile` uses.
+ *
+ * Decoding stops at this shape deliberately. Turning periods into pitches and
+ * speed/tempo into a `TempoMap` is musical work, so it lives in music_lib;
+ * only the byte reading is platform-shaped, and even that is shared by all
+ * three `MusicIo` implementations rather than reimplemented per platform.
+ */
+export {};
+//# sourceMappingURL=mod.js.map

package/dist/platform/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/platform/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,61 +1,61 @@
 {
-  "name": "@sudobility/music_types",
-  "version": "0.11.4",
-  "description": "TypeScript types and Zod schemas for the ScoreSmith music API - scores, generation contracts, project payloads",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.esm.json",
-    "clean": "rimraf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src",
-    "typecheck": "tsc --noEmit",
-    "verify": "bun run typecheck && bun run lint && bun run test && bun run build",
-    "prepublishOnly": "bun run clean && bun run verify"
-  },
-  "files": [
-    "dist/**/*",
-    "CLAUDE.md"
-  ],
-  "keywords": [
-    "typescript",
-    "types",
-    "music",
-    "scoresmith",
-    "api"
-  ],
-  "author": "Sudobility",
-  "license": "BUSL-1.1",
-  "dependencies": {
-    "zod": "^4.0.0"
-  },
-  "peerDependencies": {
-    "@sudobility/types": "^1.9.64"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.38.0",
-    "@sudobility/types": "^1.9.64",
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    "eslint": "^9.38.0",
-    "globals": "^16.4.0",
-    "rimraf": "^6.0.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/johnqh/music_types.git"
-  }
+	"name": "@sudobility/music_types",
+	"version": "0.11.7",
+	"description": "TypeScript types and Zod schemas for the ScoreSmith music API - scores, generation contracts, project payloads",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.esm.json",
+		"clean": "rimraf dist",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "eslint src",
+		"typecheck": "tsc --noEmit",
+		"verify": "bun run typecheck && bun run lint && bun run test && bun run build",
+		"prepublishOnly": "bun run clean && bun run verify"
+	},
+	"files": [
+		"dist/**/*",
+		"CLAUDE.md"
+	],
+	"keywords": [
+		"typescript",
+		"types",
+		"music",
+		"scoresmith",
+		"api"
+	],
+	"author": "Sudobility",
+	"license": "BUSL-1.1",
+	"dependencies": {
+		"zod": "^4.0.0"
+	},
+	"peerDependencies": {
+		"@sudobility/types": "^1.9.64"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.38.0",
+		"@sudobility/types": "^1.9.64",
+		"@typescript-eslint/eslint-plugin": "^8.46.2",
+		"@typescript-eslint/parser": "^8.46.2",
+		"eslint": "^9.38.0",
+		"globals": "^16.4.0",
+		"rimraf": "^6.0.1",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.15"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/johnqh/music_types.git"
+	}
 }