@dilemmagx/orchestra 1.2.2 → 1.2.4

package/README.md

@@ -117,14 +117,11 @@ the system font family is used when available.
 ```ts
 import { Pipeline, createImageNode, sourceFromEmpty } from '@dilemmagx/orchestra';
 
-const posterize = createImageNode(
-  '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 posterize = createImageNode('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);
@@ -186,6 +183,23 @@ const pipeline = new Pipeline().add(mapped);
 const image = await pipeline.run(sourceFromUrl('https://example.com/image.jpg'));
 ```
 
+## Stroke Nodes
+
+```ts
+import {
+  Pipeline,
+  createContrastStrokeNode,
+  createAlphaStrokeNode,
+  sourceFromUrl,
+} from '@dilemmagx/orchestra';
+
+const pipeline = new Pipeline()
+  .add(createAlphaStrokeNode({ alphaThreshold: 8, thickness: 2, color: '#0f172a' }))
+  .add(createContrastStrokeNode({ threshold: 28, thickness: 2, color: '#ffffff' }));
+
+const image = await pipeline.run(sourceFromUrl('https://example.com/image.png'));
+```
+
 ## Built-in Nodes
 
 - createBrightnessNode
@@ -193,7 +207,9 @@ const image = await pipeline.run(sourceFromUrl('https://example.com/image.jpg'))
 - createCircleNode
 - createConvolutionNode
 - createContrastNode
+- createContrastStrokeNode
 - createEdgeDetectNode
+- createAlphaStrokeNode
 - createFillNode
 - createGammaNode
 - createGaussianBlurNode
@@ -219,7 +235,9 @@ const image = await pipeline.run(sourceFromUrl('https://example.com/image.jpg'))
 Selectors and masking helpers:
 
 - createAlphaSelector
+- createAlphaStrokeSelector
 - createCircleSelector
+- createContrastStrokeSelector
 - createLumaSelector
 - createMaskMapNode
 - createMaskedNode

package/dist/core/nodes.d.ts

@@ -119,7 +119,9 @@ export declare function runNodeImage(node: ImageNode, context: NodeContext, stat
 /**
  * Selector used to choose pixels for masked execution.
  */
-export type PixelSelector = (pixel: Pixel, x: number, y: number, context: NodeContext) => boolean;
+export type PixelSelector = ((pixel: Pixel, x: number, y: number, context: NodeContext) => boolean) & {
+    prepare?: (image: ImageBuffer, context: NodeContext) => Uint8Array;
+};
 /**
  * Masking options for nodes.
  */
@@ -171,6 +173,42 @@ export type CircleSelectorOptions = {
     cy: number;
     radius: number;
 };
+/**
+ * Options for alpha-boundary stroke nodes.
+ */
+export type AlphaStrokeOptions = {
+    alphaThreshold?: number;
+    thickness?: number;
+    color?: ColorInput;
+    connectivity?: 4 | 8;
+};
+/**
+ * Options for contrast-boundary stroke nodes.
+ */
+export type ContrastStrokeOptions = {
+    threshold?: number;
+    thickness?: number;
+    color?: ColorInput;
+    connectivity?: 4 | 8;
+};
+/**
+ * Options for alpha-boundary selectors.
+ */
+export type AlphaStrokeSelectorOptions = {
+    alphaThreshold?: number;
+    thickness?: number;
+    mode?: 'stroke' | 'shape';
+    connectivity?: 4 | 8;
+};
+/**
+ * Options for contrast-boundary selectors.
+ */
+export type ContrastStrokeSelectorOptions = {
+    threshold?: number;
+    thickness?: number;
+    mode?: 'stroke' | 'shape';
+    connectivity?: 4 | 8;
+};
 /**
  * Creates a rectangle selector.
  */
@@ -187,6 +225,14 @@ export declare function createLumaSelector(threshold: number): PixelSelector;
  * Creates an alpha-based selector.
  */
 export declare function createAlphaSelector(threshold: number): PixelSelector;
+/**
+ * Creates an alpha-boundary selector.
+ */
+export declare function createAlphaStrokeSelector(options?: AlphaStrokeSelectorOptions): PixelSelector;
+/**
+ * Creates a contrast-boundary selector.
+ */
+export declare function createContrastStrokeSelector(options?: ContrastStrokeSelectorOptions): PixelSelector;
 /**
  * Creates a node with typed parameters stored in the node metadata.
  */
@@ -203,6 +249,14 @@ export declare function createMaskMapNode(mask: MaskMapSource, entries: MaskMapE
  * Creates a node that removes pixels outside the selection.
  */
 export declare function createSelectionCropNode(selector: PixelSelector, options?: SelectionOptions): ImageNode;
+/**
+ * Creates a node that draws a stroke along alpha boundaries.
+ */
+export declare function createAlphaStrokeNode(options?: AlphaStrokeOptions): ImageNode;
+/**
+ * Creates a node that draws a stroke along contrast boundaries.
+ */
+export declare function createContrastStrokeNode(options?: ContrastStrokeOptions): ImageNode;
 /**
  * Creates a node that maps every pixel using a custom mapper.
  */

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { ImageBuffer } from './core/image';
 export { SeededRandom, createRandom } from './core/random';
 export type { ResizeOptions, SaveImageOptions, TextFont, TextFontSource, TextLayout, TextOptions, TextStyle, } from './core/sources';
 export { imageToBuffer, loadImage, renderText, resizeImage, saveImage, sourceFromBuffer, sourceFromDataUri, sourceFromEmpty, sourceFromPath, sourceFromUrl, } from './core/sources';
-export type { CircleSelectorOptions, ImageInput, ImageNode, ImageNodeOptions, MaskMapEntry, MaskMapOptions, MaskMapSource, NodeDefinition, NodeContext, NodeResult, NodeState, ParametricNode, PixelMatrix, PixelNodeInfo, PixelNodeRunner, PixelSelector, FractalNoiseOptions, PerlinNoiseOptions, RectSelectorOptions, SelectionMode, SelectionOptions, SimpleNodeDefinition, ValueNoiseOptions, RidgedNoiseOptions, TurbulenceNoiseOptions, VoronoiNoiseOptions, } from './core/nodes';
-export { DEFAULT_IMAGE_KEY, createBrightnessNode, createCircleSelector, createCheckerboardNode, createCircleNode, createConvolutionNode, createContrastNode, createAlphaSelector, createEdgeDetectNode, createFillNode, createGammaNode, createGaussianBlurNode, createGaussianNoiseNode, createGrayscaleNode, createInvertNode, createImageNode, createPixelNode, createLumaSelector, createMapNode, createMaskMapNode, createMaskedNode, createNoiseNode, createFractalNoiseNode, createPerlinNoiseNode, createRidgedNoiseNode, createTurbulenceNoiseNode, createValueNoiseNode, createVoronoiNoiseNode, createPaletteMapNode, createParamNode, createRandomFillNode, createRectSelector, createResizeNode, createSelectionCropNode, createRectNode, createSaltPepperNoiseNode, createSharpenNode, createThresholdNode, createTextNode, defineNode, getImage, mergeNodeState, node, runNode, runNodeImage, buildBoxKernel, buildGaussianKernel, } from './core/nodes';
+export type { AlphaStrokeOptions, AlphaStrokeSelectorOptions, CircleSelectorOptions, ContrastStrokeOptions, ContrastStrokeSelectorOptions, ImageInput, ImageNode, ImageNodeOptions, MaskMapEntry, MaskMapOptions, MaskMapSource, NodeDefinition, NodeContext, NodeResult, NodeState, ParametricNode, PixelMatrix, PixelNodeInfo, PixelNodeRunner, PixelSelector, FractalNoiseOptions, PerlinNoiseOptions, RectSelectorOptions, SelectionMode, SelectionOptions, SimpleNodeDefinition, ValueNoiseOptions, RidgedNoiseOptions, TurbulenceNoiseOptions, VoronoiNoiseOptions, } from './core/nodes';
+export { DEFAULT_IMAGE_KEY, createAlphaStrokeNode, createAlphaStrokeSelector, createBrightnessNode, createCircleSelector, createCheckerboardNode, createCircleNode, createConvolutionNode, createContrastNode, createAlphaSelector, createContrastStrokeNode, createContrastStrokeSelector, createEdgeDetectNode, createFillNode, createGammaNode, createGaussianBlurNode, createGaussianNoiseNode, createGrayscaleNode, createInvertNode, createImageNode, createPixelNode, createLumaSelector, createMapNode, createMaskMapNode, createMaskedNode, createNoiseNode, createFractalNoiseNode, createPerlinNoiseNode, createRidgedNoiseNode, createTurbulenceNoiseNode, createValueNoiseNode, createVoronoiNoiseNode, createPaletteMapNode, createParamNode, createRandomFillNode, createRectSelector, createResizeNode, createSelectionCropNode, createRectNode, createSaltPepperNoiseNode, createSharpenNode, createThresholdNode, createTextNode, defineNode, getImage, mergeNodeState, node, runNode, runNodeImage, buildBoxKernel, buildGaussianKernel, } from './core/nodes';
 export type { PipelineInput, PipelineOptions } from './core/pipeline';
 export { Pipeline, createExamplePipeline, pipeline } from './core/pipeline';