@dilemmagx/orchestra 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# @dilemmagx/orchestra
+
+Orchestra is a programmable, node-based image synthesis and processing toolkit.
+It focuses on deterministic, pixel-accurate workflows with simple composable nodes.
+
+## Install
+
+```bash
+npm i @dilemmagx/orchestra
+```
+
+## Quick Start
+
+```ts
+import { Pipeline, createNoiseNode, createInvertNode, sourceFromEmpty } from '@dilemmagx/orchestra';
+
+const pipeline = new Pipeline().add(createNoiseNode({ grayscale: true })).add(createInvertNode());
+
+const image = await pipeline.run(sourceFromEmpty(256, 256, 'rgba8'), { seed: 42 });
+```
+
+## Resize & Palette Mapping
+
+```ts
+import {
+  Pipeline,
+  createResizeNode,
+  createPaletteMapNode,
+  saveImage,
+  sourceFromUrl,
+} from '@dilemmagx/orchestra';
+
+const palette = ['#9bbc0f', '#8bac0f', '#306230', '#0f380f'];
+const pipeline = new Pipeline().add(createResizeNode(128, 85)).add(createPaletteMapNode(palette));
+
+const image = await pipeline.run(sourceFromUrl('https://example.com/image.jpg'));
+await saveImage(image, './gameboy.png');
+```
+
+## Color Formats
+
+```ts
+import { toRgba, hsvaToRgba } from '@dilemmagx/orchestra';
+
+const rgba = toRgba('#ffcc00');
+const other = hsvaToRgba({ h: 120, s: 50, v: 90, a: 1 });
+```
+
+## Common Nodes
+
+```ts
+import { Pipeline, createGrayscaleNode, createGammaNode } from '@dilemmagx/orchestra';
+
+const pipeline = new Pipeline().add(createGrayscaleNode()).add(createGammaNode(1.2));
+```
+
+Built-in nodes:
+
+- createBrightnessNode
+- createCheckerboardNode
+- createCircleNode
+- createConvolutionNode
+- createContrastNode
+- createEdgeDetectNode
+- createFillNode
+- createGammaNode
+- createGaussianBlurNode
+- createGaussianNoiseNode
+- createGrayscaleNode
+- createInvertNode
+- createNoiseNode
+- createPaletteMapNode
+- createRandomFillNode
+- createRectNode
+- createResizeNode
+- createSaltPepperNoiseNode
+- createSharpenNode
+- createThresholdNode
+
+## Custom Node
+
+```ts
+import { Pipeline, createParamNode, sourceFromEmpty } from '@dilemmagx/orchestra';
+
+const posterize = createParamNode('posterize', { step: 32 }, (_context, image, params) =>
+  image.mapPixels((pixel) => {
+    const next = Math.round(pixel.r / params.step) * params.step;
+    return { r: next, g: next, b: next, a: pixel.a };
+  })
+);
+
+const pipeline = new Pipeline().add(posterize);
+const image = await pipeline.run(sourceFromEmpty(512, 512, 'rgba8'));
+```

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@dilemmagx/orchestra",
+  "version": "1.0.0",
+  "description": "A programmable node-based image synthesis and processing toolkit.",
+  "license": "GPL-3.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "DilemmaGX",
+  "homepage": "https://github.com/DilemmaGX/dilib/tree/main/orchestra#readme",
+  "bugs": {
+    "url": "https://github.com/DilemmaGX/dilib/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DilemmaGX/dilib.git",
+    "directory": "orchestra"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "keywords": [
+    "image",
+    "processing",
+    "graph",
+    "nodes"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly && esbuild src/index.ts --bundle --outfile=dist/index.js --platform=node --target=node18 --sourcemap --minify"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "esbuild": "^0.27.3",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "sharp": "^0.34.3"
+  }
+}