How jobinjia/shuimo-core works
shuimo-core is a deterministic procedural Chinese-ink illustration library that produces SVG strings or Canvas output. Its main workflow takes seeded painting options, plans a landscape composition, generates visual elements and paper texture, and returns artwork; separate APIs generate flowers and seal stamps. The graph also captures the documented stamp-v2 font-worker option and xuan-paper worker. Relationships involving unsampled composition and illustration modules are limited to explicit README or SOURCE INDEX evidence.
Main entry points: Mount.ts Landscape elements · SceneManager.ts Scene manager · seal.ts Stamp v2 engine · Stroke.ts Ink strokes
Components 24
Painting composition
- Painting API
packages/core/src/composition/PaintingGenerator.ts - Scene manager
packages/core/src/composition/SceneManager.ts - Mount planner
packages/core/src/composition/MountPlanner.ts
Artwork generation
- Landscape elements
packages/core/src/elements/natural/Mount.ts - Water and boats
packages/core/src/elements/natural/Water.ts - Natural elements
packages/core/src/elements/natural - Flower generators
packages/core/src/drawing/FlowerCanvas.ts - Ink mountains
packages/core/src/drawing/ink-mount/InkMount.ts - Ink strokes
packages/core/src/drawing/Stroke.ts - Brush texture
packages/core/src/drawing/Texture.ts
Seal stamps
- Stamp v2 engine
packages/core/src/drawing/stampV2/seal.ts - Glyph layout
packages/core/src/drawing/stampV2/text/glyphs.ts - Stamp SVG renderer
packages/core/src/drawing/stampV2/render/svg.ts - Font path utilities
packages/core/src/drawing/internal/glyphPath.ts - Font worker client
packages/core/src/drawing/internal/glyphFontClient.ts - Font worker
packages/core/src/drawing/internal/glyphFontWorker.ts
Xuan paper
- Paper rendering
packages/core/src/elements/natural/xuan-paper - Paper worker
packages/core/src/elements/natural/xuan-paper/worker.ts - Paper tone WASM
packages/core/src/elements/natural/xuan-paper/paper-tone-wasm.ts
Shared primitives
- Geometry
packages/core/src/foundation/geometry/Vector2.ts - Noise functions
packages/core/src/foundation/noise - Seeded random
packages/core/src/foundation/random/prng.ts - SVG utilities
packages/core/src/utils/svg.ts
Other components
- Library user
Connections 34
- Library user → Painting API: configures
README.md - Painting API → Scene manager: generates
packages/core/src/composition/SceneManager.ts - Scene manager → Mount planner: plans
packages/core/src/composition/SceneManager.ts - Scene manager → Landscape elements: renders
packages/core/src/composition/SceneManager.ts - Scene manager → Water and boats: renders
packages/core/src/composition/SceneManager.ts - Scene manager → Seeded random: samples
packages/core/src/composition/SceneManager.ts - Library user → Stamp v2 engine: requests seal
README.md - Stamp v2 engine → Glyph layout: lays out
packages/core/src/drawing/stampV2/seal.ts - Stamp v2 engine → Stamp SVG renderer: renders
packages/core/src/drawing/stampV2/seal.ts - Stamp v2 engine → Geometry: uses geometry
packages/core/src/drawing/stampV2/seal.ts - Stamp v2 engine → Seeded random: seeds
packages/core/src/drawing/stampV2/seal.ts - Glyph layout → Font path utilities: uses paths
packages/core/src/drawing/stampV2/text/glyphs.ts - Glyph layout → Font worker client: requests fonts
packages/core/src/drawing/stampV2/text/glyphs.ts - Glyph layout → Geometry: lays out
packages/core/src/drawing/stampV2/text/glyphs.ts - Font worker client → Font worker: posts requests
packages/core/src/drawing/internal/glyphFontClient.ts - Font worker → Font path utilities: normalizes paths
packages/core/src/drawing/internal/glyphFontWorker.ts - Library user → Paper rendering: requests paper
README.md - Paper worker → Paper tone WASM: computes tone
packages/core/src/elements/natural/xuan-paper/worker.ts - Library user → Flower generators: generates flowers
README.md - Library user → Ink mountains: generates mountains
README.md - Landscape elements → Ink strokes: draws strokes
packages/core/src/elements/natural/Mount.ts - Landscape elements → Brush texture: adds texture
packages/core/src/elements/natural/Mount.ts - Landscape elements → Noise functions: samples noise
packages/core/src/elements/natural/Mount.ts - Landscape elements → Seeded random: uses randomness
packages/core/src/elements/natural/Mount.ts - Water and boats → Ink strokes: draws strokes
- Water and boats → Brush texture: adds texture
- Ink mountains → Geometry: uses vectors
- Ink mountains → Noise functions: samples noise
- Ink strokes → Geometry: uses geometry
packages/core/src/drawing/Stroke.ts - Ink strokes → Noise functions: uses noise
packages/core/src/drawing/Stroke.ts - Brush texture → Ink strokes: uses strokes
packages/core/src/drawing/Texture.ts - Brush texture → Noise functions: uses noise
packages/core/src/drawing/Texture.ts - Landscape elements → SVG utilities: emits SVG
packages/core/src/elements/natural/Mount.ts - Water and boats → SVG utilities: emits SVG