@scenoco-three/core 0.1.0

package/dist/nodes/object3d/RectAreaLight.js

@@ -0,0 +1,34 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RectAreaLight } from 'three';
+import { Object3DNode } from '../base.js';
+import { node, property } from '../../core/decorators.js';
+let RectAreaLightNode = class RectAreaLightNode extends Object3DNode {
+    color = 0xffffff;
+    intensity = 1;
+    width = 10;
+    height = 10;
+    build() {
+        return new RectAreaLight(this.color, this.intensity, this.width, this.height);
+    }
+};
+__decorate([
+    property({ type: 'color', default: 0xffffff })
+], RectAreaLightNode.prototype, "color", void 0);
+__decorate([
+    property({ type: 'float', default: 1 })
+], RectAreaLightNode.prototype, "intensity", void 0);
+__decorate([
+    property({ type: 'float', default: 10 })
+], RectAreaLightNode.prototype, "width", void 0);
+__decorate([
+    property({ type: 'float', default: 10 })
+], RectAreaLightNode.prototype, "height", void 0);
+RectAreaLightNode = __decorate([
+    node({ name: 'RectAreaLight', description: 'Uniform light across a rectangle (works with MeshStandardMaterial)' })
+], RectAreaLightNode);
+export { RectAreaLightNode };

package/dist/nodes/object3d/Scene.d.ts

@@ -0,0 +1,5 @@
+import { Group } from 'three';
+import { Object3DNode } from '../base.js';
+export declare class SceneNode extends Object3DNode {
+    build(): Group;
+}

package/dist/nodes/object3d/Scene.js

@@ -0,0 +1,22 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Group } from 'three';
+import { Object3DNode } from '../base.js';
+import { node } from '../../core/decorators.js';
+let SceneNode = class SceneNode extends Object3DNode {
+    build() {
+        return new Group();
+    }
+};
+SceneNode = __decorate([
+    node({
+        name: 'Scene',
+        kind: 'scene',
+        description: 'Root of a scene file',
+    })
+], SceneNode);
+export { SceneNode };

package/dist/nodes/object3d/SkinnedMesh.d.ts

@@ -0,0 +1,5 @@
+import { SkinnedMesh } from 'three';
+import { Object3DNode } from '../base.js';
+export declare class SkinnedMeshNode extends Object3DNode {
+    build(): SkinnedMesh;
+}

package/dist/nodes/object3d/SkinnedMesh.js

@@ -0,0 +1,23 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { SkinnedMesh } from 'three';
+import { Object3DNode } from '../base.js';
+import { node } from '../../core/decorators.js';
+// The skeleton is bound at runtime (a component calls `.bind(skeleton)`); the
+// tag carries the geometry/material like a Mesh.
+let SkinnedMeshNode = class SkinnedMeshNode extends Object3DNode {
+    build() {
+        return new SkinnedMesh();
+    }
+};
+SkinnedMeshNode = __decorate([
+    node({
+        name: 'SkinnedMesh',
+        description: 'A mesh deformed by a skeleton; skeleton bound by a component',
+    })
+], SkinnedMeshNode);
+export { SkinnedMeshNode };

package/dist/nodes/object3d/SpotLight.d.ts

@@ -0,0 +1,11 @@
+import { SpotLight } from 'three';
+import { Object3DNode } from '../base.js';
+export declare class SpotLightNode extends Object3DNode {
+    color: number;
+    intensity: number;
+    distance: number;
+    angle: number;
+    penumbra: number;
+    decay: number;
+    build(): SpotLight;
+}

package/dist/nodes/object3d/SpotLight.js

@@ -0,0 +1,42 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { SpotLight } from 'three';
+import { Object3DNode } from '../base.js';
+import { node, property } from '../../core/decorators.js';
+let SpotLightNode = class SpotLightNode extends Object3DNode {
+    color = 0xffffff;
+    intensity = 1;
+    distance = 0;
+    angle = Math.PI / 3;
+    penumbra = 0;
+    decay = 2;
+    build() {
+        return new SpotLight(this.color, this.intensity, this.distance, this.angle, this.penumbra, this.decay);
+    }
+};
+__decorate([
+    property({ type: 'color', default: 0xffffff })
+], SpotLightNode.prototype, "color", void 0);
+__decorate([
+    property({ type: 'float', default: 1 })
+], SpotLightNode.prototype, "intensity", void 0);
+__decorate([
+    property({ type: 'float', default: 0, description: 'Range; 0 = infinite' })
+], SpotLightNode.prototype, "distance", void 0);
+__decorate([
+    property({ type: 'float', default: Math.PI / 3, description: 'Cone half-angle in radians (max PI/2)' })
+], SpotLightNode.prototype, "angle", void 0);
+__decorate([
+    property({ type: 'float', default: 0, description: 'Soft-edge fraction 0..1' })
+], SpotLightNode.prototype, "penumbra", void 0);
+__decorate([
+    property({ type: 'float', default: 2 })
+], SpotLightNode.prototype, "decay", void 0);
+SpotLightNode = __decorate([
+    node({ name: 'SpotLight', description: 'Cone of light emitted from a point in a direction' })
+], SpotLightNode);
+export { SpotLightNode };

package/dist/nodes/object3d/Sprite.d.ts

@@ -0,0 +1,5 @@
+import { Sprite } from 'three';
+import { Object3DNode } from '../base.js';
+export declare class SpriteNode extends Object3DNode {
+    build(): Sprite;
+}

package/dist/nodes/object3d/Sprite.js

@@ -0,0 +1,21 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Sprite } from 'three';
+import { Object3DNode } from '../base.js';
+import { node } from '../../core/decorators.js';
+let SpriteNode = class SpriteNode extends Object3DNode {
+    build() {
+        return new Sprite();
+    }
+};
+SpriteNode = __decorate([
+    node({
+        name: 'Sprite',
+        description: 'A camera-facing textured quad: optional SpriteMaterial, no geometry',
+    })
+], SpriteNode);
+export { SpriteNode };

package/dist/nodes/setting/Background.d.ts

@@ -0,0 +1,6 @@
+import { Attachment } from '../base.js';
+import type { AttachContext } from '../../core/NodeRegistry.js';
+export declare class BackgroundAttachment extends Attachment {
+    color: number;
+    attach(ctx: AttachContext): void;
+}

package/dist/nodes/setting/Background.js

@@ -0,0 +1,22 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Color } from 'three';
+import { Attachment } from '../base.js';
+import { attachment, property } from '../../core/decorators.js';
+let BackgroundAttachment = class BackgroundAttachment extends Attachment {
+    color = 0xffffff;
+    attach(ctx) {
+        ctx.scene.background = new Color(this.color);
+    }
+};
+__decorate([
+    property({ type: 'color', default: 0xffffff })
+], BackgroundAttachment.prototype, "color", void 0);
+BackgroundAttachment = __decorate([
+    attachment({ name: 'Background', target: 'Scene', group: 'background', description: 'Solid background color for the scene' })
+], BackgroundAttachment);
+export { BackgroundAttachment };

package/dist/nodes/setting/Fog.d.ts

@@ -0,0 +1,8 @@
+import { Attachment } from '../base.js';
+import type { AttachContext } from '../../core/NodeRegistry.js';
+export declare class FogAttachment extends Attachment {
+    color: number;
+    near: number;
+    far: number;
+    attach(ctx: AttachContext): void;
+}

package/dist/nodes/setting/Fog.js

@@ -0,0 +1,30 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Fog } from 'three';
+import { Attachment } from '../base.js';
+import { attachment, property } from '../../core/decorators.js';
+let FogAttachment = class FogAttachment extends Attachment {
+    color = 0xffffff;
+    near = 1;
+    far = 1000;
+    attach(ctx) {
+        ctx.scene.fog = new Fog(this.color, this.near, this.far);
+    }
+};
+__decorate([
+    property({ type: 'color', default: 0xffffff })
+], FogAttachment.prototype, "color", void 0);
+__decorate([
+    property({ type: 'float', default: 1 })
+], FogAttachment.prototype, "near", void 0);
+__decorate([
+    property({ type: 'float', default: 1000 })
+], FogAttachment.prototype, "far", void 0);
+FogAttachment = __decorate([
+    attachment({ name: 'Fog', target: 'Scene', group: 'fog', description: 'Linear fog that fades distant objects between near and far' })
+], FogAttachment);
+export { FogAttachment };

package/dist/nodes/setting/FogExp2.d.ts

@@ -0,0 +1,7 @@
+import { Attachment } from '../base.js';
+import type { AttachContext } from '../../core/NodeRegistry.js';
+export declare class FogExp2Attachment extends Attachment {
+    color: number;
+    density: number;
+    attach(ctx: AttachContext): void;
+}

package/dist/nodes/setting/FogExp2.js

@@ -0,0 +1,27 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { FogExp2 } from 'three';
+import { Attachment } from '../base.js';
+import { attachment, property } from '../../core/decorators.js';
+// Shares group 'fog' with <Fog>, so a scene can declare at most one of them.
+let FogExp2Attachment = class FogExp2Attachment extends Attachment {
+    color = 0xffffff;
+    density = 0.00025;
+    attach(ctx) {
+        ctx.scene.fog = new FogExp2(this.color, this.density);
+    }
+};
+__decorate([
+    property({ type: 'color', default: 0xffffff })
+], FogExp2Attachment.prototype, "color", void 0);
+__decorate([
+    property({ type: 'float', default: 0.00025 })
+], FogExp2Attachment.prototype, "density", void 0);
+FogExp2Attachment = __decorate([
+    attachment({ name: 'FogExp2', target: 'Scene', group: 'fog', description: 'Exponential-squared fog (denser, distance-based)' })
+], FogExp2Attachment);
+export { FogExp2Attachment };

package/dist/nodes/targets.d.ts

@@ -0,0 +1,5 @@
+import { Line, Mesh, Points, Sprite } from 'three';
+/** Nodes that accept a geometry attachment (mesh family + lines + points). */
+export declare const GEOMETRY_TARGETS: (typeof Mesh | typeof Line | typeof Points)[];
+/** Nodes that accept a material attachment (geometry-bearing nodes + sprites). */
+export declare const MATERIAL_TARGETS: (typeof Mesh | typeof Line | typeof Points | typeof Sprite)[];

package/dist/nodes/targets.js

@@ -0,0 +1,5 @@
+import { Line, Mesh, Points, Sprite } from 'three';
+/** Nodes that accept a geometry attachment (mesh family + lines + points). */
+export const GEOMETRY_TARGETS = [Mesh, Line, Points];
+/** Nodes that accept a material attachment (geometry-bearing nodes + sprites). */
+export const MATERIAL_TARGETS = [Mesh, Line, Points, Sprite];

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@scenoco-three/core",
+  "version": "0.1.0",
+  "description": "SceNoCo runtime: a component-based scene framework for Three.js (Engine, Component, registry, bundle loader)",
+  "type": "module",
+  "license": "MIT",
+  "keywords": ["three", "threejs", "scene", "components", "ecs", "gamedev", "engine"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
+    },
+    "./nodes": {
+      "types": "./dist/nodes/index.d.ts",
+      "import": "./dist/nodes/index.js"
+    },
+    "./nodes/*": "./dist/nodes/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "//sideEffects": "Only the built-in node modules self-register on import; everything else is pure, so bundlers can tree-shake unused node tags (and their three classes) when scenes import only the ones they use.",
+  "sideEffects": [
+    "./dist/nodes/**"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0"
+  }
+}