@doki-land/live2d-core 0.0.15 → 0.0.17

package/README.md

@@ -24,7 +24,8 @@ It does not fetch network resources, decode MOC binaries, create a canvas, or is
 pnpm add @doki-land/live2d-core
 ```
 
-Install this package directly only when implementing a compatible loader, renderer, diagnostic tool, or host integration.
+Install this package directly only when implementing a compatible loader, renderer, diagnostic tool, or host
+integration.
 
 ## 🧱 Design Principles
 
@@ -48,7 +49,8 @@ import type {
 } from "@doki-land/live2d-core";
 ```
 
-An asset resolver provides model-related resources without prescribing HTTP, file-system, CDN, or package-registry behavior:
+An asset resolver provides model-related resources without prescribing HTTP, file-system, CDN, or package-registry
+behavior:
 
 ```ts
 const resolver: AssetResolver = {
@@ -63,7 +65,8 @@ const resolver: AssetResolver = {
 };
 ```
 
-Use the exact exported interface as the source of truth; the example illustrates the ownership boundary rather than guaranteeing every method name across versions.
+Use the exact exported interface as the source of truth; the example illustrates the ownership boundary rather than
+guaranteeing every method name across versions.
 
 ## 🔄 Session Lifecycle
 
@@ -74,7 +77,8 @@ idle -> mounting -> ready -> loading -> live
                                \-> error
 ```
 
-Consumers should listen to phase and error events instead of inferring readiness from a non-null canvas or model reference.
+Consumers should listen to phase and error events instead of inferring readiness from a non-null canvas or model
+reference.
 
 ## 📸 Frame Data
 
@@ -95,11 +99,13 @@ pnpm --filter @doki-land/live2d-core typecheck
 pnpm --filter @doki-land/live2d-core test
 ```
 
-Contract changes should include compatibility notes in the change itself and update all workspace consumers in the same change set.
+Contract changes should include compatibility notes in the change itself and update all workspace consumers in the same
+change set.
 
 ## 🤝 Contributing
 
-Avoid adding convenience APIs that belong to the facade. A core abstraction should be shared by at least two implementation layers and remain meaningful without a browser UI framework.
+Avoid adding convenience APIs that belong to the facade. A core abstraction should be shared by at least two
+implementation layers and remain meaningful without a browser UI framework.
 
 ## 📄 License
 

package/dist/index.d.ts

@@ -392,6 +392,12 @@ interface Live2dStage {
 
 /**
  * `@doki-land/live2d-core` — types, events, session contracts.
+ *
+ * Layout:
+ * - `format/`  — settings JSON format detection
+ * - `model/`   — settings / asset / actor instance types
+ * - `stage/`   — stage + actor contracts
+ * - root       — contracts, events, frame, program, session
  */
 
 declare const LIVE2D_CORE_VERSION: "0.0.0";

package/dist/index.js

@@ -9,7 +9,7 @@ function modelSourceUrl(source) {
   return source.baseUrl;
 }
 
-// src/detect-format.ts
+// src/format/detect-format.ts
 function detectModelSettingsFormat(json) {
   if (!json || typeof json !== "object") return null;
   const o = json;
@@ -109,7 +109,7 @@ function createSessionStub() {
   };
 }
 
-// src/stage.ts
+// src/stage/stage.ts
 var DEFAULT_ACTOR_TRANSFORM = {
   x: 0.5,
   y: 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/live2d-core",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Shared TypeScript contracts for live2d.ts — ModelSource, Live2dStage/Actor, ModelAsset, events (no DOM/GPU).",
   "type": "module",
   "license": "MIT",

package/src/{detect-format.ts → format/detect-format.ts}

@@ -3,7 +3,7 @@
  * Shared by loader normalize and renderer backends — keep binary peek in renderer.
  */
 
-import type { ModelFormat } from "./model.js";
+import type { ModelFormat } from "../model/model.js";
 
 /** Detect moc2 vs moc3 from model settings JSON shape. Returns null if unknown. */
 export function detectModelSettingsFormat(json: unknown): ModelFormat | null {

package/src/index.ts

@@ -1,5 +1,11 @@
 /**
  * `@doki-land/live2d-core` — types, events, session contracts.
+ *
+ * Layout:
+ * - `format/`  — settings JSON format detection
+ * - `model/`   — settings / asset / actor instance types
+ * - `stage/`   — stage + actor contracts
+ * - root       — contracts, events, frame, program, session
  */
 
 export type {
@@ -10,7 +16,7 @@ export type {
     SessionState,
 } from "./contracts.js";
 export { modelSourceUrl } from "./contracts.js";
-export { detectModelSettingsFormat } from "./detect-format.js";
+export { detectModelSettingsFormat } from "./format/detect-format.js";
 export {
     EventEmitter,
     type FrameProfile,
@@ -32,12 +38,12 @@ export type {
     ModelFormat,
     ModelSettings,
     MotionDefinition,
-} from "./model.js";
+} from "./model/model.js";
 export type {
     ActorInstance,
     Live2dStageAssets,
     ModelAsset,
-} from "./model-asset.js";
+} from "./model/model-asset.js";
 export type {
     DrawableProgram,
     ModelInstance,
@@ -60,7 +66,7 @@ export type {
     PointerTrackingPolicy,
     StagePointerEvent,
     StageUpdateMode,
-} from "./stage.js";
-export { DEFAULT_ACTOR_TRANSFORM } from "./stage.js";
+} from "./stage/stage.js";
+export { DEFAULT_ACTOR_TRANSFORM } from "./stage/stage.js";
 
 export const LIVE2D_CORE_VERSION = "0.0.0" as const;

package/src/{model-asset.ts → model/model-asset.ts}

@@ -1,4 +1,4 @@
-import type { AssetResolver, ModelSource } from "./contracts.js";
+import type { AssetResolver, ModelSource } from "../contracts.js";
 import type { InternalModel, ModelSettings } from "./model.js";
 
 /**

package/src/session.ts

@@ -1,7 +1,7 @@
 import type { AssetResolver, ModelSource, SessionState } from "./contracts.js";
 import { EventEmitter } from "./events.js";
 import type { FrameSnapshot } from "./frame.js";
-import type { InternalModel } from "./model.js";
+import type { InternalModel } from "./model/model.js";
 
 /** High-level runtime session for one mounted surface. */
 export interface Live2DSession {

package/src/{stage.ts → stage/stage.ts}

@@ -1,6 +1,6 @@
-import type { AssetResolver, ModelSource } from "./contracts.js";
-import type { InternalModel, MotionDefinition } from "./model.js";
-import type { ModelAsset } from "./model-asset.js";
+import type { AssetResolver, ModelSource } from "../contracts.js";
+import type { InternalModel, MotionDefinition } from "../model/model.js";
+import type { ModelAsset } from "../model/model-asset.js";
 
 /** Normalized stage placement for one actor (0,0) top-left → (1,1) bottom-right. */
 export interface ActorTransform {
@@ -145,7 +145,7 @@ export interface Live2dStage {
     readonly actors: readonly Live2dActor[];
 
     /** Shared model resource cache for multi-actor reuse. */
-    readonly assets: import("./model-asset.js").Live2dStageAssets;
+    readonly assets: import("../model/model-asset.js").Live2dStageAssets;
 
     mount(canvas: HTMLCanvasElement): Promise<void>;