@sebastianwessel/isostate 0.1.0

package/dist/types/scene.d.ts

@@ -0,0 +1,94 @@
+import type { ConnectionPatch, ConnectionPlacement, ConnectionRemoval, ElementPatch, ElementPlacement, ElementRemoval, RuntimeConnectorState, RuntimeElementState } from "./node.ts";
+/** Scene grid configuration */
+export interface GridConfig {
+    /** Cell size in projected units (default: 64) */
+    cellSize?: number;
+}
+/** Asset declared in an authored scene document header. */
+export interface AssetCatalogEntry {
+    /** Unique asset id used by scene elements. */
+    id: string;
+    /** Optional relative SVG path. Defaults to `id` when omitted. */
+    path?: string;
+    /**
+     * Normalized point inside the asset viewport that sits on the element's
+     * projected footprint anchor. Defaults to bottom-center `[0.5, 1]`.
+     */
+    anchor?: [number, number];
+}
+/** Logical ground plane and stable layout bounds. */
+export interface FloorConfig {
+    size?: [number, number];
+    origin?: [number, number];
+    layer?: string;
+    visible?: boolean;
+    asset?: string;
+}
+export type LayoutFit = "contain" | "none";
+export type LayoutBounds = "floor" | "content" | "union";
+/** Resolved layout emitted to runtime bundles. */
+export interface ResolvedLayoutConfig {
+    fit: LayoutFit;
+    align: [number, number];
+    padding: {
+        x: number;
+        y: number;
+    };
+    bounds: LayoutBounds;
+}
+/** Layer definition for render order and grouping */
+export interface LayerDefinition {
+    /** Unique layer name (kebab-case) */
+    name: string;
+    /** Render order (lower = behind). Defaults to declaration order. */
+    order?: number;
+}
+/** Scene document header. */
+export interface SceneHeader {
+    version?: string;
+    name?: string;
+    className?: string;
+    assetBaseUrl?: string;
+    assets: AssetCatalogEntry[];
+    grid?: GridConfig;
+    floor?: FloorConfig;
+    theme?: string;
+    layers: LayerDefinition[];
+}
+/** Authored scene timeline stop. */
+export interface SceneAddDelta {
+    elements?: ElementPlacement[];
+    connections?: ConnectionPlacement[];
+}
+/** Authored scene update operation section. */
+export interface SceneUpdateDelta {
+    elements?: ElementPatch[];
+    connections?: ConnectionPatch[];
+}
+/** Authored scene remove operation section. */
+export interface SceneRemoveDelta {
+    elements?: ElementRemoval[];
+    connections?: ConnectionRemoval[];
+}
+/** Authored scene timeline stop. */
+export interface SceneStep {
+    id: string;
+    elements?: ElementPlacement[];
+    connections?: ConnectionPlacement[];
+    add?: SceneAddDelta;
+    update?: SceneUpdateDelta;
+    remove?: SceneRemoveDelta;
+}
+/** Full authored scene document parsed from YAML. */
+export interface SceneDocument {
+    header: SceneHeader;
+    scenes: SceneStep[];
+}
+/** Compiled runtime scene stop. */
+export interface RuntimeSceneStop {
+    id: string;
+    progress: number;
+    elements: RuntimeElementState[];
+    connectors: RuntimeConnectorState[];
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/types/scene.d.ts.map

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

package/dist/types/validation.d.ts

@@ -0,0 +1,40 @@
+/** Validation error detail */
+export interface ValidationError {
+    /** Machine-readable error code */
+    code: string;
+    /** Descriptive error message */
+    message: string;
+    /** Element ID involved (if applicable) */
+    elementId?: string;
+    /** State name involved (if applicable) */
+    stateName?: string;
+    /** Scene ID involved (if applicable) */
+    sceneId?: string;
+    /** Asset name involved (if applicable) */
+    assetName?: string;
+    /** Layer name involved (if applicable) */
+    layerName?: string;
+    /** Source location (if applicable) */
+    location?: {
+        file?: string;
+        line?: number;
+        column?: number;
+    };
+    /** Previous lifecycle state (if applicable) */
+    fromState?: string;
+    /** Next lifecycle state (if applicable) */
+    toState?: string;
+}
+/** Validation warning detail */
+export interface ValidationWarning extends ValidationError {
+}
+/** Complete validation report */
+export interface ValidationReport {
+    /** Blocking errors */
+    errors: ValidationError[];
+    /** Non-blocking warnings */
+    warnings: ValidationWarning[];
+    /** True when no errors are present */
+    isValid: boolean;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAkB,SAAQ,eAAe;CAAG;AAE7D,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAChC,sBAAsB;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;CACjB"}

package/dist/utils/easing.d.ts

@@ -0,0 +1,25 @@
+/** Easing function type */
+export type EasingFn = (t: number) => number;
+/** Easing configuration type */
+export type EasingType = "linear" | "easeInCubic" | "easeInOutCubic" | "easeOutCubic";
+/**
+ * Linear easing (no interpolation).
+ */
+export declare function linear(t: number): number;
+/**
+ * Cubic ease-in: starts slowly, accelerates.
+ */
+export declare function easeInCubic(t: number): number;
+/**
+ * Cubic ease-out: starts fast, decelerates.
+ */
+export declare function easeOutCubic(t: number): number;
+/**
+ * Cubic ease-in-out: slow start, fast middle, slow end.
+ */
+export declare function easeInOutCubic(t: number): number;
+/**
+ * Resolve an easing type string to a function.
+ */
+export declare function resolveEasing(type: EasingType): EasingFn;
+//# sourceMappingURL=easing.d.ts.map

package/dist/utils/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/utils/easing.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE7C,gCAAgC;AAChC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEtF;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAWxD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { type EasingFn, type EasingType, easeInCubic, easeInOutCubic, easeOutCubic, linear, resolveEasing, } from "./easing.ts";
+export { calculateTransform, calculateVisualSize, DEFAULT_CELL_SIZE, projectToScreen, } from "./projection.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,MAAM,EACN,aAAa,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/projection.d.ts

@@ -0,0 +1,22 @@
+/** Default cell size in pixels */
+export declare const DEFAULT_CELL_SIZE = 64;
+/**
+ * Calculate raw scene-space coordinates from isometric grid position.
+ * Layout is applied separately by subtracting resolved bounds and adding padding.
+ */
+export declare function projectToRaw(gridX: number, gridY: number, cellSize: number): {
+    rawX: number;
+    rawY: number;
+};
+/**
+ * Calculate screen coordinates from raw isometric projection and resolved bounds.
+ */
+export declare function projectToScreen(gridX: number, gridY: number, cellSize: number, boundsMinX?: number, boundsMinY?: number, paddingX?: number, paddingY?: number): {
+    screenX: number;
+    screenY: number;
+};
+/** Calculate the screen size for an element based on its grid size. */
+export declare function calculateVisualSize(gridSize: number, cellSize: number): number;
+/** Calculate the element transform string for positioning and scaling. */
+export declare function calculateTransform(screenX: number, screenY: number, visualSize: number, cellSize: number): string;
+//# sourceMappingURL=projection.d.ts.map

package/dist/utils/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/utils/projection.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAK3G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAI,EACd,UAAU,SAAI,EACd,QAAQ,SAAI,EACZ,QAAQ,SAAI,GACV;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMtC;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjH"}

package/package.json

@@ -0,0 +1,63 @@
+{
+	"name": "@sebastianwessel/isostate",
+	"version": "0.1.0",
+	"description": "Isometric scene engine — SVG rendering, animation, and YAML DSL for browser-based isometric scenes.",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./runtime": {
+			"types": "./dist/runtime/index.d.ts",
+			"import": "./dist/runtime/index.js"
+		},
+		"./dsl": {
+			"types": "./dist/dsl/index.d.ts",
+			"import": "./dist/dsl/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"sideEffects": false,
+	"scripts": {
+		"clean": "rm -rf dist",
+		"build": "cd ../.. && bun run build",
+		"lint": "biome check src/",
+		"format": "biome format --write src/",
+		"test": "bun test",
+		"prepublishOnly": "cd ../.. && bun run build && bun run lint"
+	},
+	"devDependencies": {
+		"typescript": "^6.0.3",
+		"@biomejs/biome": "^2.4.15",
+		"yaml": "^2.9.0",
+		"publint": "^0.3.21",
+		"size-limit": "^12.1.0"
+	},
+	"peerDependencies": {
+		"yaml": "^2.9.0"
+	},
+	"peerDependenciesMeta": {
+		"yaml": {
+			"optional": true
+		}
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"author": "Sebastian Wessel",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+ssh://git@github.com/sebastianwessel/isostate.git",
+		"directory": "packages/core"
+	}
+}