@developerz.ai/ts23d 0.1.0 → 0.2.0

package/dist/export/lod-coverage.d.ts

@@ -0,0 +1,12 @@
+import type { CompiledAsset } from '../core/index.js';
+export declare const MSFT_LOD = "MSFT_lod";
+export declare const SCREEN_COVERAGE = "MSFT_screencoverage";
+export type LodCoverage = readonly [number, number, number];
+/** Default [LOD0→1, LOD1→2, cull] for an asset from its compiled LODs (any subset, LOD0 first). */
+export declare function defaultCoverage(lods: readonly CompiledAsset[]): LodCoverage;
+export declare function checkCoverage(c: readonly number[], asset: string): void;
+/**
+ * MSFT_screencoverage for the LODs actually written (e.g. [0, 2]): entry j is the coverage where
+ * LOD j hands over — to the next included LOD's switch point, or to nothing (cull) for the last.
+ */
+export declare function coverageFor(levels: readonly number[], c: LodCoverage): number[];

package/dist/export/metadata.d.ts

@@ -10,6 +10,8 @@ export interface GlbMeta {
     readonly license?: string;
     /** Where the numbers came from (the recipe's `sources`) → `dc:relation`. */
     readonly sources?: readonly string[];
+    /** Third-party inputs (e.g. CC0 texture sets) → `dc:contributor`. Filled by export. */
+    readonly credits?: readonly string[];
 }
 /** `asset` block, plus root `extensions` and the extension name when an XMP packet is written. */
 export declare function metadata(name: string, meta: GlbMeta | undefined): {

package/dist/export/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0";
-export declare const GENERATOR = "@developerz.ai/ts23d 0.1.0";
+export declare const VERSION = "0.2.0";
+export declare const GENERATOR = "@developerz.ai/ts23d 0.2.0";

package/dist/grammar/index.js

@@ -3,8 +3,8 @@ import {
   layoutSplit2,
   split2,
   parseWhyte2
-} from "../chunk-ravbb06q.js";
-import"../chunk-4ddzsqtc.js";
+} from "../chunk-dxvypr7y.js";
+import"../chunk-hg7pf34j.js";
 export {
   layoutSplit2 as layoutSplit,
   parseSplit2 as parseSplit,

package/dist/index.js

@@ -30,24 +30,40 @@ import {
   rotateZ2,
   worldMesh2,
   worldMeshes2
-} from "./chunk-4ddzsqtc.js";
+} from "./chunk-hg7pf34j.js";
 import {
+  CC0_WOOD_PLANKS_GREY2,
+  CC0_MATERIALS2,
+  MATERIAL_LIBRARY2,
+  hex2,
+  NATURAL2,
+  definePalette2,
+  palettes2,
+  provideTextures2,
+  creditOf2,
+  DEFAULT_SHEET2,
+  STRIP_ROWS2,
+  CUSTOM_STRIP_SLOTS2,
   TRIM_SHEET_SIZE2,
+  stripRow2,
   stripRect2,
   cellRect2,
   STRIPS2,
+  CLASSIC_STRIPS2,
+  MATERIAL_STRIPS2,
   CELLS2,
   DECAL_CELLS2,
   FOLIAGE_CELLS2,
   isFoliage2,
-  DEFAULT_SHEET2,
+  defineMaterial2,
+  resetMaterials2,
+  materialOf2,
+  textureSources2,
+  stripCredits2,
   paintTrimSheet2,
-  hex2,
-  definePalette2,
-  palettes2,
   threeMaterialSource2,
   godotShaderSource2
-} from "./chunk-kvcep7ft.js";
+} from "./chunk-y63c6zcv.js";
 import {
   RayGrid2,
   bakeAo2,
@@ -56,8 +72,13 @@ import {
   livery2,
   optimize2,
   weightedNormals2
-} from "./chunk-xnt2sdhf.js";
+} from "./chunk-drna2rny.js";
 import {
+  MSFT_LOD2,
+  SCREEN_COVERAGE2,
+  defaultCoverage2,
+  checkCoverage2,
+  coverageFor2,
   mergeToPivots2,
   summarize2,
   optimizeParts2,
@@ -65,8 +86,10 @@ import {
   sheetFileName2,
   sheetPngs2,
   toGlb2,
-  exportGlb2
-} from "./chunk-gcyp9b4d.js";
+  exportGlb2,
+  toLodGlb2,
+  exportLodGlb2
+} from "./chunk-dbq4qf52.js";
 import {
   pointTriangleDistance2,
   TriangleGrid2,
@@ -103,13 +126,13 @@ import {
   lodPivots2,
   DEFAULT_LOD_GATES2,
   runLodQa2
-} from "./chunk-w1zyhj40.js";
+} from "./chunk-jq4e17tj.js";
 import {
   parseSplit2,
   layoutSplit2,
   split2,
   parseWhyte2
-} from "./chunk-ravbb06q.js";
+} from "./chunk-dxvypr7y.js";
 import {
   box2,
   lathe2,
@@ -147,7 +170,7 @@ import {
   text2,
   tiled2,
   valueNoise3
-} from "./chunk-wtqhq529.js";
+} from "./chunk-d1fv6hrm.js";
 import {
   mass2,
   opening2,
@@ -182,12 +205,12 @@ import {
   whyteAxles2,
   trackRun2,
   propeller2
-} from "./chunk-1ypfs7ga.js";
+} from "./chunk-8j4c28jt.js";
 import {
   localGenerator2,
   importGlb2,
   kubeezImages2
-} from "./chunk-a8fxakcj.js";
+} from "./chunk-6b05mnmx.js";
 import {
   checkBeautyOptions2,
   parseSize2,
@@ -208,15 +231,19 @@ import {
   detailWindows2,
   reviewPack2,
   thumbnail2
-} from "./chunk-11v28977.js";
+} from "./chunk-f6yme003.js";
 import {
   manifestOf2
-} from "./chunk-kgvbpqqw.js";
+} from "./chunk-7rtfjh9f.js";
 export {
   BUDGETS2 as BUDGETS,
+  CC0_MATERIALS2 as CC0_MATERIALS,
+  CC0_WOOD_PLANKS_GREY2 as CC0_WOOD_PLANKS_GREY,
   CELLS2 as CELLS,
   CLASH_EPS2 as CLASH_EPS,
+  CLASSIC_STRIPS2 as CLASSIC_STRIPS,
   CONTACT_EPS2 as CONTACT_EPS,
+  CUSTOM_STRIP_SLOTS2 as CUSTOM_STRIP_SLOTS,
   DECAL_CELLS2 as DECAL_CELLS,
   DEFAULT_GATES2 as DEFAULT_GATES,
   DEFAULT_LOD_GATES2 as DEFAULT_LOD_GATES,
@@ -224,12 +251,18 @@ export {
   FOLIAGE_CELLS2 as FOLIAGE_CELLS,
   HEADS2 as HEADS,
   HEAD_RES2 as HEAD_RES,
+  MATERIAL_LIBRARY2 as MATERIAL_LIBRARY,
+  MATERIAL_STRIPS2 as MATERIAL_STRIPS,
+  MSFT_LOD2 as MSFT_LOD,
   MeshBuilder2 as MeshBuilder,
+  NATURAL2 as NATURAL,
   REVIEW_THRESHOLDS2 as REVIEW_THRESHOLDS,
   RayGrid2 as RayGrid,
+  SCREEN_COVERAGE2 as SCREEN_COVERAGE,
   SHEET_MAPS2 as SHEET_MAPS,
   SPECIES2 as SPECIES,
   STRIPS2 as STRIPS,
+  STRIP_ROWS2 as STRIP_ROWS,
   TRIM_SHEET_SIZE2 as TRIM_SHEET_SIZE,
   TriangleGrid2 as TriangleGrid,
   Ts23dError2 as Ts23dError,
@@ -251,23 +284,29 @@ export {
   cell2 as cell,
   cellRect2 as cellRect,
   checkBeautyOptions2 as checkBeautyOptions,
+  checkCoverage2 as checkCoverage,
   checkHead2 as checkHead,
   clashes2 as clashes,
   clear2 as clear,
   compile2 as compile,
   contactSheet2 as contactSheet,
+  coverageFor2 as coverageFor,
   createRng2 as createRng,
   creature2 as creature,
+  creditOf2 as creditOf,
   cross2 as cross,
   cylinder2 as cylinder,
+  defaultCoverage2 as defaultCoverage,
   defineAsset2 as defineAsset,
   defineFamily2 as defineFamily,
+  defineMaterial2 as defineMaterial,
   definePalette2 as definePalette,
   degenerateTriangles2 as degenerateTriangles,
   detailWindows2 as detailWindows,
   dot2 as dot,
   encodePng2 as encodePng,
   exportGlb2 as exportGlb,
+  exportLodGlb2 as exportLodGlb,
   exposure2 as exposure,
   facade2 as facade,
   fbm2 as fbm,
@@ -308,6 +347,7 @@ export {
   maskIoU2 as maskIoU,
   maskStats2 as maskStats,
   mass2 as mass,
+  materialOf2 as materialOf,
   measure2 as measure,
   measureText2 as measureText,
   measures2 as measures,
@@ -338,8 +378,10 @@ export {
   prism2 as prism,
   propeller2 as propeller,
   proportions2 as proportions,
+  provideTextures2 as provideTextures,
   quatFromAxisAngle2 as quatFromAxisAngle,
   renderBeauty2 as renderBeauty,
+  resetMaterials2 as resetMaterials,
   reviewPack2 as reviewPack,
   ridgeHeight2 as ridgeHeight,
   ridged2 as ridged,
@@ -365,7 +407,9 @@ export {
   silhouetteIoU2 as silhouetteIoU,
   slopeMap2 as slopeMap,
   split2 as split,
+  stripCredits2 as stripCredits,
   stripRect2 as stripRect,
+  stripRow2 as stripRow,
   sub2 as sub,
   summarize2 as summarize,
   surfaceSamples2 as surfaceSamples,
@@ -375,11 +419,13 @@ export {
   terrainColor2 as terrainColor,
   terrainGrid2 as terrainGrid,
   text2 as text,
+  textureSources2 as textureSources,
   thermalErosion2 as thermalErosion,
   threeMaterialSource2 as threeMaterialSource,
   thumbnail2 as thumbnail,
   tiled2 as tiled,
   toGlb2 as toGlb,
+  toLodGlb2 as toLodGlb,
   toWorld2 as toWorld,
   touches2 as touches,
   touching2 as touching,
@@ -407,5 +453,5 @@ export {
   zFighting2 as zFighting
 };
 
-//# debugId=72A146AAD343702B64756E2164756E21
+//# debugId=514018F8AD878FF264756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "72A146AAD343702B64756E2164756E21",
+  "debugId": "514018F8AD878FF264756E2164756E21",
   "names": []
 }

package/dist/kinds/head-armour.d.ts

@@ -1,9 +1,5 @@
-import type { Vec3 } from '../core/index.js';
 import type { SculptEdit } from '../primitives/index.js';
 import type { HeadParams } from './head-params.js';
-/** Chest ellipsoid of the bust (shared with head-bust.ts so the strap hugs it). */
-export declare const chestOf: (cx: number, s: number, b: number) => {
-    at: Vec3;
-    r: Vec3;
-};
-export declare function armour(p: HeadParams, cx: number, s: number, b: number, nz: number): SculptEdit[];
+import { type BustFrame } from './head-torso.js';
+/** `cell`: the bust's sculpt cell; plates thicken to ≈ 2.5 cells so far LODs stay closed. */
+export declare function armour(p: HeadParams, f: BustFrame, cell?: number): SculptEdit[];

package/dist/kinds/head-bust.d.ts

@@ -1,4 +1,5 @@
-import type { SculptEdit } from '../primitives/index.js';
+import { type SculptEdit } from '../primitives/index.js';
 import type { HeadLayout } from './head-layout.js';
 import type { HeadParams } from './head-params.js';
-export declare function bustEdits(p: HeadParams, l: HeadLayout): SculptEdit[];
+/** `cell`: the bust's sculpt cell (head units), floors the plinth disc so far LODs keep it. */
+export declare function bustEdits(p: HeadParams, l: HeadLayout, cell?: number): SculptEdit[];

package/dist/kinds/head-face.d.ts

@@ -3,4 +3,6 @@ import type { HeadLayout } from './head-layout.js';
 import type { HeadParams } from './head-params.js';
 /** Brain case + face plate: the forms the eyes are seated against (head.ts probes them). */
 export declare function primaryEdits(l: HeadLayout): SculptEdit[];
-export declare function skullEdits(p: HeadParams, l: HeadLayout): SculptEdit[];
+/** `cell`: the sculpt cell (head units). Far LODs drop the teeth and floor the nose's radii at
+ *  about 0.6 cells so a long nose survives. */
+export declare function skullEdits(p: HeadParams, l: HeadLayout, cell?: number): SculptEdit[];

package/dist/kinds/head-garb.d.ts

@@ -0,0 +1,4 @@
+import type { SculptEdit } from '../primitives/index.js';
+import type { HeadParams } from './head-params.js';
+import { type BustFrame } from './head-torso.js';
+export declare function vest(p: HeadParams, f: BustFrame): SculptEdit[];

package/dist/kinds/head-mesh.d.ts

@@ -2,6 +2,8 @@ import type { Mesh, Vec3 } from '../core/index.js';
 import { type Field, type SculptEdit } from '../primitives/index.js';
 import type { HeadLayout } from './head-layout.js';
 import type { HeadParams } from './head-params.js';
+/** Default plinth colour (dark slate). */
+export declare const PLINTH: Vec3;
 /** The jaw region (head units): an ellipsoid around chin and lower lip, cut flat at the mouth
  *  line. Its skin seam runs along the lips, down the marionette lines and under the chin — creases
  *  a face already has — instead of across the cheek. */
@@ -15,6 +17,8 @@ export interface HeadEditSet {
     readonly ears: readonly SculptEdit[];
     readonly tusks: readonly SculptEdit[];
     readonly bust: readonly SculptEdit[];
+    /** The bust-cut region (≈ 0 on the cut faces), painted as bare plinth material. */
+    readonly bustCut?: Field;
 }
 /** `head` and `jaw` meshes in head units at cell size `res` (units). Each is ONE sculpt (skull +
  *  ears − region, skull ∩ region + tusks), so the sculpt's range skipping covers every edit. */

package/dist/kinds/head-mouth.d.ts

@@ -0,0 +1,4 @@
+import type { SculptEdit } from '../primitives/index.js';
+import type { HeadLayout } from './head-layout.js';
+import type { HeadParams } from './head-params.js';
+export declare function mouthEdits(p: HeadParams, l: HeadLayout, teeth?: boolean): SculptEdit[];

package/dist/kinds/head-params.d.ts

@@ -2,7 +2,7 @@ import { type Vec3 } from '../core/index.js';
 export type EarShape = 'round' | 'pointed';
 export type HairStyle = 'none' | 'topknot' | 'mohawk' | 'swept' | 'tufts' | 'braids';
 export type BeardStyle = 'none' | 'short' | 'braided' | 'goatee';
-export type BustStyle = 'pauldrons' | 'hood' | 'tunic';
+export type BustStyle = 'pauldrons' | 'hood' | 'tunic' | 'vest';
 export interface HeadColors {
     readonly skin: Vec3;
     /** Darker skin: lips edge, nostrils, inner ear, wrinkles. */
@@ -23,6 +23,10 @@ export interface HeadColors {
     readonly fur?: Vec3;
     /** War paint / tattoo stripes (orc), or none. */
     readonly paint?: Vec3;
+    /** The bust's plinth (stone/wood socle); default a dark slate. */
+    readonly plinth?: Vec3;
+    /** Scarf / sash cloth (vest style); default `cloth`. */
+    readonly scarf?: Vec3;
 }
 export interface HeadParams {
     /** Chin to crown, metres (adult human ≈ 0.23). */
@@ -94,14 +98,18 @@ export interface HeadParams {
     readonly neck: {
         readonly radius: number;
     };
+    /** Shoulder half-span, gear style, muscle mass (0 = bony and narrow … 1 = brute; default 0.5). */
     readonly bust: {
         readonly shoulders: number;
         readonly style: BustStyle;
+        readonly mass?: number;
     };
     readonly hair: HairStyle;
     readonly beard: BeardStyle;
     /** Wart / bump count scattered on the skin (seeded). */
     readonly warts: number;
+    /** Forehead creases (0 = smooth; a goblin's worried brow has 3). */
+    readonly wrinkles?: number;
     readonly colors: HeadColors;
 }
 /** Throws T3D_RECIPE_INVALID (with a fix) when `p` cannot make a head. */

package/dist/kinds/head-tone.d.ts

@@ -0,0 +1,10 @@
+import type { Vec3 } from '../core/index.js';
+import type { Field } from '../primitives/index.js';
+export interface ToneOptions {
+    /** Probe distance for the cavity test, head units (≈ the size of a fold). */
+    readonly reach: number;
+    /** 0 = flat colour, 1 = full painted tone. */
+    readonly strength?: number;
+}
+/** Wraps `colorAt` with cavity darkening and a warm-top / cool-under gradient. */
+export declare function toned(field: Field, colorAt: (q: Vec3) => Vec3, o: ToneOptions): (q: Vec3) => Vec3;

package/dist/kinds/head-torso.d.ts

@@ -0,0 +1,35 @@
+import type { Vec3 } from '../core/index.js';
+import { type Field, type SculptEdit } from '../primitives/index.js';
+import type { HeadLayout } from './head-layout.js';
+import type { HeadParams } from './head-params.js';
+/** Where the bust sits relative to the head: centre x, shoulder half-span, base, neck root… */
+export interface BustFrame {
+    readonly cx: number;
+    readonly s: number;
+    /** Reference z the torso is laid out from (the floor lifted by the build's hunch). */
+    readonly b: number;
+    /** The asset's floor: bottom of the plinth. */
+    readonly floor: number;
+    /** Neck root (top of the sternum), z. */
+    readonly nz: number;
+    readonly m: number;
+    /** Neck radius. */
+    readonly n: number;
+    /** Where the trapezius meets the neck, z (high behind the ear on a brute). */
+    readonly trapZ: number;
+    /** Top of the plinth = bottom of the chest cut, z. */
+    readonly cutZ: number;
+}
+export declare function frameOf(p: HeadParams, l: HeadLayout): BustFrame;
+/** Anatomy volumes (plain adds), every one grown by `g`. */
+export declare function torsoForms(f: BustFrame, g?: number): SculptEdit[];
+/** Signed distance to the bust-cut region (negative inside): ≈ 0 on the cut faces. */
+export declare function cutField(f: BustFrame): Field;
+/** Keeps a group to the bust silhouette: the U-cut under the chest, rising to cut the arms. */
+export declare function bustCut(f: BustFrame, g?: number): SculptEdit;
+/** The bare body: anatomy in `color`, sternal notch and groove, then the bust cut. */
+export declare function bodyEdits(p: HeadParams, f: BustFrame, color: Vec3): SculptEdit[];
+/** A turned plinth: wide disc with a bead moulding, then a narrower socle up to the chest cut.
+ *  Both start below the floor, so the bust's flat base cut alone makes the underside. */
+/** `minT`: floor for the disc's thickness (≈ a cell), so far LODs keep the bust on the ground. */
+export declare function plinthEdits(p: HeadParams, f: BustFrame, minT?: number): SculptEdit[];

package/dist/kinds/index.js

@@ -32,12 +32,12 @@ import {
   whyteAxles2,
   trackRun2,
   propeller2
-} from "../chunk-1ypfs7ga.js";
-import"../chunk-ravbb06q.js";
-import"../chunk-wtqhq529.js";
-import"../chunk-kvcep7ft.js";
-import"../chunk-xnt2sdhf.js";
-import"../chunk-4ddzsqtc.js";
+} from "../chunk-8j4c28jt.js";
+import"../chunk-dxvypr7y.js";
+import"../chunk-d1fv6hrm.js";
+import"../chunk-y63c6zcv.js";
+import"../chunk-drna2rny.js";
+import"../chunk-hg7pf34j.js";
 export {
   HEADS2 as HEADS,
   HEAD_RES2 as HEAD_RES,

package/dist/material/cc0.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialDef } from './material-def.js';
+/** Poly Haven "Wood Planks Grey" by Rob Tuytel (CC0), 1.5 m square, 1k PNG maps. */
+export declare const CC0_WOOD_PLANKS_GREY: MaterialDef;
+export declare const CC0_MATERIALS: readonly MaterialDef[];

package/dist/material/define.d.ts

@@ -0,0 +1,34 @@
+import { type MaterialDef } from './material-def.js';
+import type { StripRecipe } from './paint/types.js';
+import { type TextureSource } from './texture-source.js';
+import { type CustomStripId, type StripId } from './trim-sheet.js';
+/**
+ * Register a project material and return its strip id for `strip:` options.
+ * @example
+ * const teak = defineMaterial({ id: 'teak_deck', kind: 'planks', roughness: 0.6,
+ *   albedo: '#8a5a32', albedo2: '#5a3a1e', params: { width: 0.12, rings: 0.5 } });
+ * box({ size: [4, 2, 0.05], strip: teak, color: NATURAL });
+ */
+export declare function defineMaterial(def: MaterialDef): CustomStripId;
+/**
+ * Forget every defined material (tests; long-lived workers that reload recipes). Built-ins stay.
+ * Meshes compiled before the reset keep UVs into rows that may be reassigned.
+ */
+export declare function resetMaterials(): void;
+export interface MaterialInfo {
+    readonly id: StripId;
+    /** classic = greyscale strip tinted by vertex colour; library/defined carry their own colour. */
+    readonly origin: 'classic' | 'library' | 'defined';
+    readonly recipe: StripRecipe;
+    readonly description: string;
+    readonly sources: readonly string[];
+}
+/** What a strip is: its recipe, origin, description and sources. Unknown ids throw. */
+export declare function materialOf(id: StripId): MaterialInfo;
+/** Every texture set a defined material references (what `bun run textures` fetches). */
+export declare function textureSources(): readonly TextureSource[];
+/**
+ * Credit lines for the image strips a mesh samples: any V coordinate inside such a strip's row
+ * counts. Empty when no image strip is used (the GLB stays byte-identical).
+ */
+export declare function stripCredits(vs: ArrayLike<number>): string[];

package/dist/material/generator.d.ts

@@ -1,4 +1,4 @@
 import type { PaintedSheet, SheetRecipe } from './paint/types.js';
 export { DEFAULT_SHEET } from './paint/default-sheet.js';
-export type { CellImage, PaintedSheet, SheetRecipe, StripKind, StripRecipe, } from './paint/types.js';
+export type { CellImage, MaterialPainter, MaterialSurface, PaintedSheet, PaintKit, SheetRecipe, StripKind, StripRecipe, } from './paint/types.js';
 export declare function paintTrimSheet(recipe?: SheetRecipe): PaintedSheet;

package/dist/material/index.d.ts

@@ -1,4 +1,9 @@
-export { type CellImage, DEFAULT_SHEET, type PaintedSheet, paintTrimSheet, type SheetRecipe, type StripKind, type StripRecipe, } from './generator.js';
-export { definePalette, hex, type Palette, palettes } from './palette.js';
+export { CC0_MATERIALS, CC0_WOOD_PLANKS_GREY } from './cc0.js';
+export { defineMaterial, type MaterialInfo, materialOf, resetMaterials, stripCredits, textureSources, } from './define.js';
+export { type CellImage, DEFAULT_SHEET, type MaterialPainter, type MaterialSurface, type PaintedSheet, type PaintKit, paintTrimSheet, type SheetRecipe, type StripKind, type StripRecipe, } from './generator.js';
+export { MATERIAL_LIBRARY } from './library.js';
+export type { MaterialDef } from './material-def.js';
+export { definePalette, hex, NATURAL, type Palette, palettes } from './palette.js';
 export { godotShaderSource, type ShaderHints, threeMaterialSource } from './shader.js';
-export { CELLS, type CellId, cellRect, DECAL_CELLS, type DecalCellId, FOLIAGE_CELLS, type FoliageCellId, isFoliage, STRIPS, type StripId, stripRect, TRIM_SHEET_SIZE, type UvRect, } from './trim-sheet.js';
+export { creditOf, provideTextures, type TextureCache, type TextureFile, type TextureSource, } from './texture-source.js';
+export { type BuiltinStripId, CELLS, type CellId, CLASSIC_STRIPS, type ClassicStripId, CUSTOM_STRIP_SLOTS, type CustomStripId, cellRect, DECAL_CELLS, type DecalCellId, FOLIAGE_CELLS, type FoliageCellId, isFoliage, MATERIAL_STRIPS, type MaterialStripId, STRIP_ROWS, STRIPS, type StripId, stripRect, stripRow, TRIM_SHEET_SIZE, type UvRect, } from './trim-sheet.js';

package/dist/material/index.js

@@ -1,38 +1,70 @@
 import {
+  CC0_WOOD_PLANKS_GREY2,
+  CC0_MATERIALS2,
+  MATERIAL_LIBRARY2,
+  hex2,
+  NATURAL2,
+  definePalette2,
+  palettes2,
+  provideTextures2,
+  creditOf2,
+  DEFAULT_SHEET2,
+  STRIP_ROWS2,
+  CUSTOM_STRIP_SLOTS2,
   TRIM_SHEET_SIZE2,
+  stripRow2,
   stripRect2,
   cellRect2,
   STRIPS2,
+  CLASSIC_STRIPS2,
+  MATERIAL_STRIPS2,
   CELLS2,
   DECAL_CELLS2,
   FOLIAGE_CELLS2,
   isFoliage2,
-  DEFAULT_SHEET2,
+  defineMaterial2,
+  resetMaterials2,
+  materialOf2,
+  textureSources2,
+  stripCredits2,
   paintTrimSheet2,
-  hex2,
-  definePalette2,
-  palettes2,
   threeMaterialSource2,
   godotShaderSource2
-} from "../chunk-kvcep7ft.js";
-import"../chunk-4ddzsqtc.js";
+} from "../chunk-y63c6zcv.js";
+import"../chunk-hg7pf34j.js";
 export {
+  CC0_MATERIALS2 as CC0_MATERIALS,
+  CC0_WOOD_PLANKS_GREY2 as CC0_WOOD_PLANKS_GREY,
   CELLS2 as CELLS,
+  CLASSIC_STRIPS2 as CLASSIC_STRIPS,
+  CUSTOM_STRIP_SLOTS2 as CUSTOM_STRIP_SLOTS,
   DECAL_CELLS2 as DECAL_CELLS,
   DEFAULT_SHEET2 as DEFAULT_SHEET,
   FOLIAGE_CELLS2 as FOLIAGE_CELLS,
+  MATERIAL_LIBRARY2 as MATERIAL_LIBRARY,
+  MATERIAL_STRIPS2 as MATERIAL_STRIPS,
+  NATURAL2 as NATURAL,
   STRIPS2 as STRIPS,
+  STRIP_ROWS2 as STRIP_ROWS,
   TRIM_SHEET_SIZE2 as TRIM_SHEET_SIZE,
   cellRect2 as cellRect,
+  creditOf2 as creditOf,
+  defineMaterial2 as defineMaterial,
   definePalette2 as definePalette,
   godotShaderSource2 as godotShaderSource,
   hex2 as hex,
   isFoliage2 as isFoliage,
+  materialOf2 as materialOf,
   paintTrimSheet2 as paintTrimSheet,
   palettes2 as palettes,
+  provideTextures2 as provideTextures,
+  resetMaterials2 as resetMaterials,
+  stripCredits2 as stripCredits,
   stripRect2 as stripRect,
+  stripRow2 as stripRow,
+  textureSources2 as textureSources,
   threeMaterialSource2 as threeMaterialSource
 };
 
-//# debugId=00CB682D745D7A0764756E2164756E21
+//# debugId=DC34FA57446536B164756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/material/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "00CB682D745D7A0764756E2164756E21",
+  "debugId": "DC34FA57446536B164756E2164756E21",
   "names": []
 }

package/dist/material/library.d.ts

@@ -0,0 +1,7 @@
+import type { MaterialDef } from './material-def.js';
+import type { MaterialStripId } from './trim-sheet.js';
+type Library = Readonly<Record<MaterialStripId, MaterialDef & {
+    readonly id: MaterialStripId;
+}>>;
+export declare const MATERIAL_LIBRARY: Library;
+export {};

package/dist/material/material-def.d.ts

@@ -0,0 +1,30 @@
+import { type Vec3 } from '../core/index.js';
+import type { MaterialPainter, StripKind, StripRecipe } from './paint/types.js';
+import { type TextureSource } from './texture-source.js';
+export interface MaterialDef {
+    /** snake_case, unique; becomes the strip id recipes pass as `strip`. */
+    readonly id: string;
+    /** Base painter the strip starts from. Default 'noise' (a quiet surface). */
+    readonly kind?: StripKind;
+    /** World metres the strip's V span represents (typical face height). Default 1. */
+    readonly scaleMetres?: number;
+    /** Perceptual roughness 0..1 (glTF): 0 mirror, 1 chalk. */
+    readonly roughness: number;
+    /** 0 dielectric, 1 metal. Default 0. Avoid in-between values except for dirt/oxide blends. */
+    readonly metalness?: number;
+    /** Intrinsic base colour: sRGB '#rrggbb' or linear RGB. Default white (vertex colour = hue). */
+    readonly albedo?: string | Vec3;
+    /** Second colour the painter blends to (latewood, rust, verdigris, bare wood under paint). */
+    readonly albedo2?: string | Vec3;
+    /** Painter knobs for `kind` (see each painter's header in src/material/paint/). */
+    readonly params?: Readonly<Record<string, number>>;
+    /** Your own layer, painted after `kind`: write height/tone/rough/metal/mix per texel. */
+    readonly paint?: MaterialPainter;
+    /** Paint from a CC0 texture set (opt-in, needs `bun run textures`) instead of `kind`. */
+    readonly texture?: TextureSource;
+    readonly description?: string;
+    /** Where the numbers come from (URLs). */
+    readonly sources?: readonly string[];
+}
+/** Validate a definition and turn it into the strip recipe the sheet painter runs. */
+export declare function toStripRecipe(d: MaterialDef): StripRecipe;