three-slicer 0.1.0 → 0.1.1

package/types/settings.d.ts

@@ -0,0 +1,19 @@
+// three-slicer/settings
+import type { SlicerSettings, SettingKey, Point } from './settings-keys.d.ts'
+export type { SlicerSettings, SettingKey, Point }
+
+/** config-schema 의 default 값 (없는 키면 undefined) */
+export function schemaDefault(key: string): unknown
+
+/** settings 맵 우선, 없으면 스키마 default. 벡터형은 벡터 그대로 돌려준다. */
+export function settingRaw(settings: SlicerSettings | null | undefined, key: string): unknown
+
+/** settingRaw 를 스칼라로 정규화 — 벡터면 [0]. */
+export function settingScalar(settings: SlicerSettings | null | undefined, key: string): unknown
+
+/**
+ * 설정 맵 → 커널 슬라이스 파라미터. 스키마 키에서 유도하며 누락 키는 내부 기본값으로 채운다.
+ * ponytail: 반환 키가 53개라 개별 나열 대신 Record — 커널 파라미터는 slice() 에 그대로 넘기는 용도지
+ * 소비자가 필드 단위로 읽는 API 가 아니다. 필드 접근이 필요해지면 그때 펼칠 것.
+ */
+export function deriveKernelParams(settings: SlicerSettings | null | undefined): Record<string, unknown>

package/types/toggle.d.ts

@@ -0,0 +1,22 @@
+// three-slicer/toggle — toggle-rules.json 의 enable_if 조건식 부분 평가.
+import type { SlicerSettings } from './settings-keys.d.ts'
+
+/** 설정 접근기 — 값이 없으면 스키마 default, 벡터형은 [0]. */
+export interface ToggleCfg {
+  bool(key: string): boolean
+  int(key: string): number
+  float(key: string): number
+  /** 키가 config-schema 에 존재하는가 */
+  has(key: string): boolean
+}
+
+export function makeCfg(settings: SlicerSettings | null | undefined): ToggleCfg
+
+/**
+ * enable_if 조건식 1개 평가. 번역 불가한 식은 `null`(= fail-open, 활성 유지) 을 돌려준다 —
+ * `false` 와 반드시 구분해서 다룰 것.
+ */
+export function evalEnableIf(expr: string, locals: Record<string, unknown>, cfg: ToggleCfg): boolean | null
+
+/** 현재 설정에서 비활성이어야 하는 키 → 그렇게 만든 enable_if 조건식. 조건이 명확히 false 인 규칙만. */
+export function disabledKeys(cfg: ToggleCfg): Record<string, string>

package/types/viewer-loaders.d.ts

@@ -0,0 +1,33 @@
+// three-slicer/viewer/loaders — 커널 무관 순수 로더.
+
+/** 내장 5종 + `registerLoader()` 로 등록된 확장자. 등록 시 이 배열에 push 된다. */
+export const SUPPORTED_EXT: string[]
+
+/** 소문자 확장자. 점이 없으면 빈 문자열. */
+export function fileExt(name: string): string
+
+export interface LoadedObject {
+  name: string
+  /** 삼각형 정점 좌표 (N*9, model z-up) */
+  modelPos: Float32Array
+}
+
+/** 파일 1개에 여러 오브젝트가 들어있을 수 있다(3mf/amf/step) → 항상 배열. */
+export function loadModel(name: string, buffer: ArrayBuffer): Promise<LoadedObject[]>
+
+/**
+ * 확장 포맷 등록. 무거운 의존성이 필요한 포맷(STEP=OCCT WASM 등)은 패키지에 넣지 않으므로
+ * 앱에서 직접 붙인다. `<Viewport/>` 의 파일 대화상자·드래그앤드롭 필터에 자동 반영된다.
+ *
+ * ```js
+ * import { registerLoader } from 'three-slicer/viewer/loaders'
+ * registerLoader('step,stp', async (buffer, name) => [{ name, modelPos }])
+ * ```
+ */
+export function registerLoader(
+  exts: string | string[],
+  fn: (buffer: ArrayBuffer, name: string) => LoadedObject[] | Promise<LoadedObject[]>,
+): void
+
+/** 연결 성분 분리. 성분이 1개뿐이면 `null`(분리 불가) — 빈 배열이 아니다. */
+export function splitConnectedComponents(localPos: Float32Array): Float32Array[] | null

package/types/viewer-toolpath.d.ts

@@ -0,0 +1,105 @@
+// three-slicer/viewer/toolpath — 커널 레이어 → GPU 인스턴싱 툴패스.
+// three 를 import 하지 않는다: makeToolpath 가 THREE 네임스페이스를 인자로 받는다(단일 인스턴스 보장).
+
+/** 8정점 다이아몬드 단면의 24 삼각형 인덱스 (SegmentTemplate.cpp:18 원본) */
+export const VERTEX_DATA: number[]
+
+/** 툴패스 타입 → 색. 0=travel, 1=wall … 11=prime */
+export const TYPE_COLOR: Record<number, number[]>
+export const TYPE_LABEL: Record<number, string>
+
+/** 파랑→빨강 11색 히트맵 (libvgcode ColorRange.hpp:14) */
+export const DEFAULT_RANGES_COLORS: number[][]
+
+export interface ViewTypeDef {
+  key: 'feature' | 'speed' | 'height' | 'width' | 'fan' | 'temp'
+  label: string
+  /** 연속값(히트맵)인가. false 면 고정색. */
+  cont: boolean
+  unit: string
+}
+export const VIEW_TYPES: ViewTypeDef[]
+
+/** per-vertex 부가 정보 */
+export interface SegmentMeta {
+  vType: Uint8Array
+  vWidth: Float32Array
+  vHeight: Float32Array
+  vLayer: Int32Array
+}
+
+export interface SegmentData {
+  position: Float32Array
+  hwa: Float32Array
+  segIndex: Uint32Array
+  nV: number
+  nSeg: number
+  layerSegPrefix: Uint32Array
+  travelPos: Float32Array
+  travelPrefix: Uint32Array
+  nTrav: number
+  layerCount: number
+  maxAbs: number
+  hasNaN: boolean
+  meta: SegmentMeta
+  /** 타입별 총 압출 길이 (index = 툴패스 타입, 길이 16) */
+  typeLengths: Float64Array
+  /** 정점이 하나도 없으면 null */
+  bbox: { min: [number, number, number]; max: [number, number, number] } | null
+}
+
+/** 커널 layers[{z, paths(stride8), widths[]}] → GPU 스트림. */
+export function buildSegmentData(layers: unknown[], defaultLineWidth: number): SegmentData
+
+/** 타입별 길이 비율(%), pct 내림차순. 시간은 커널이 role 별로 노출하지 않아 길이로 근사한다. */
+export function roleRatios(typeLengths: Float64Array | number[]): Array<{
+  type: number
+  label: string
+  pct: number
+  color: number[]
+}>
+
+/**
+ * speed/fan/temp 는 커널 툴패스에 없어 설정값에서 유도한다 — 그 유도에 쓰는 값들.
+ */
+export interface ColorContext {
+  speedByType?: Record<number, number>
+  firstLayerSpeed?: number
+  fanByType?: Record<number, number>
+  fanFirstLayers?: number
+  tempNormal?: number
+  tempFirst?: number
+  closeFanLayers?: number
+}
+
+export interface ColorResult {
+  /** per-vertex RGBA (nV*4). `.r` 에 색이 packed 돼 있다. */
+  color: Float32Array
+  min: number
+  max: number
+  viewType: ViewTypeDef['key']
+  label: string
+  unit: string
+  /** false 면 고정색 — min/max 는 0 이고 범례를 그리면 안 된다. */
+  cont: boolean
+}
+
+export function computeColors(data: SegmentData, viewType: ViewTypeDef['key'], ctx: ColorContext): ColorResult
+
+export interface ToolpathHandle {
+  /** THREE.Mesh — 인자로 넘긴 THREE 네임스페이스의 타입 */
+  mesh: any
+  /** THREE.LineSegments (travel) */
+  travLines: any
+  setLayerRange(lo: number, hi: number): void
+  /** 하위호환 — setLayerRange(0, n-1) 과 같다. */
+  setVisibleLayers(n: number): void
+  setTravelVisible(visible: boolean): void
+  setColors(color: Float32Array): void
+  dispose(): void
+  nSeg: number
+  layerCount: number
+}
+
+/** @param THREE - `import * as THREE from 'three'` 네임스페이스. 소비자 인스턴스를 그대로 쓴다. */
+export function makeToolpath(THREE: any, data: SegmentData): ToolpathHandle

package/types/viewer.d.ts

@@ -0,0 +1,15 @@
+// three-slicer/viewer
+import type * as React from 'react'
+import type { SlicerSettings } from './settings-keys.d.ts'
+
+export interface ViewportProps {
+  /** sparse 설정 맵. 기본 `{}`. */
+  settings?: SlicerSettings
+  /** React setState 형태. 기본 no-op. */
+  setSettings?: React.Dispatch<React.SetStateAction<SlicerSettings>>
+  /** 좌측 프로세스 패널 슬롯 — 보통 `<SettingsPanel embedded/>`. 기본 null. */
+  processPanel?: React.ReactNode
+}
+
+declare const Viewport: React.FC<ViewportProps>
+export default Viewport

package/types/wasm.d.ts

@@ -0,0 +1,5 @@
+// three-slicer/wasm, three-slicer/wasm-mt — emscripten 글루(생성물, 3.5MB+).
+// ponytail: 여기에 정확한 타입을 쓰지 않는다. 글루는 재빌드 때마다 바뀌고, 공개 API 는
+//   three-slicer 의 createSlicer() 다. 직접 쓰는 쪽은 이미 커널 내부를 아는 쪽.
+declare const factory: (opts?: Record<string, unknown>) => Promise<any>
+export default factory

package/types/worker.d.ts

@@ -0,0 +1,3 @@
+// three-slicer/worker — 슬라이스 워커 스크립트. import 해서 쓰는 모듈이 아니라
+// `new Worker(new URL('three-slicer/worker', import.meta.url), { type: 'module' })` 의 대상.
+export {}

package/viewer/README.md

@@ -1,6 +1,6 @@
 # three-slicer/viewer
 
-3D slicer viewer as a React component: three.js viewport (orbit/transform gizmos), model import (STL/OBJ/3MF/AMF/PLY, multi-object, drag & drop), Web Worker slicing via `three-slicer`, support painting, multi-plate, and a GPU-instanced volumetric toolpath preview ported from OrcaSlicer's libvgcode (millions of segments in a single draw path, per-feature colors, layer range slider, G-code export).
+3D slicer viewer as a React component: three.js viewport (orbit/transform gizmos), model import (STL/OBJ/3MF/AMF/PLY + pluggable formats such as STEP, multi-object, drag & drop), Web Worker slicing via `three-slicer`, support painting, multi-plate, and a GPU-instanced volumetric toolpath preview ported from OrcaSlicer's libvgcode (millions of segments in a single draw path, per-feature colors, layer range slider, G-code export).
 
 ```bash
 npm i three-slicer/viewer react react-dom three@^0.160.0