three-slicer 0.1.1 → 0.1.2

package/types/viewer-loaders.d.ts

@@ -1,23 +1,23 @@
-// three-slicer/viewer/loaders — 커널 무관 순수 로더.
+// three-slicer/viewer/loaders — pure loaders, independent of the kernel.
 
-/** 내장 5종 + `registerLoader()` 로 등록된 확장자. 등록 시 이 배열에 push 된다. */
+/** The 5 built-ins plus any extension registered via `registerLoader()`, which pushes onto this array. */
 export const SUPPORTED_EXT: string[]
 
-/** 소문자 확장자. 점이 없으면 빈 문자열. */
+/** Lowercased extension. Empty string when there is no dot. */
 export function fileExt(name: string): string
 
 export interface LoadedObject {
   name: string
-  /** 삼각형 정점 좌표 (N*9, model z-up) */
+  /** Triangle vertex coordinates (N*9, model z-up) */
   modelPos: Float32Array
 }
 
-/** 파일 1개에 여러 오브젝트가 들어있을 수 있다(3mf/amf/step) → 항상 배열. */
+/** A single file may contain several objects (3mf/amf/step) -> always an array. */
 export function loadModel(name: string, buffer: ArrayBuffer): Promise<LoadedObject[]>
 
 /**
- * 확장 포맷 등록. 무거운 의존성이 필요한 포맷(STEP=OCCT WASM 등)은 패키지에 넣지 않으므로
- * 앱에서 직접 붙인다. `<Viewport/>` 의 파일 대화상자·드래그앤드롭 필터에 자동 반영된다.
+ * Registers an extra format. Formats needing heavy dependencies (STEP=OCCT WASM, etc.) are not bundled here,
+ * so the app wires them up itself. The `<Viewport/>` file dialog and drag-and-drop filters pick them up automatically.
  *
  * ```js
  * import { registerLoader } from 'three-slicer/viewer/loaders'
@@ -29,5 +29,5 @@ export function registerLoader(
   fn: (buffer: ArrayBuffer, name: string) => LoadedObject[] | Promise<LoadedObject[]>,
 ): void
 
-/** 연결 성분 분리. 성분이 1개뿐이면 `null`(분리 불가) — 빈 배열이 아니다. */
+/** Connected-component split. Returns `null` when there is only one component (cannot split) — not an empty array. */
 export function splitConnectedComponents(localPos: Float32Array): Float32Array[] | null

package/types/viewer-toolpath.d.ts

@@ -1,26 +1,26 @@
-// three-slicer/viewer/toolpath — 커널 레이어 → GPU 인스턴싱 툴패스.
-// three 를 import 하지 않는다: makeToolpath 가 THREE 네임스페이스를 인자로 받는다(단일 인스턴스 보장).
+// three-slicer/viewer/toolpath — kernel layers -> GPU-instanced toolpath.
+// Does not import three: makeToolpath takes the THREE namespace as an argument (guaranteeing a single instance).
 
-/** 8정점 다이아몬드 단면의 24 삼각형 인덱스 (SegmentTemplate.cpp:18 원본) */
+/** The 24 triangle indices of the 8-vertex diamond cross-section (from SegmentTemplate.cpp:18) */
 export const VERTEX_DATA: number[]
 
-/** 툴패스 타입 → 색. 0=travel, 1=wall … 11=prime */
+/** Toolpath type -> color. 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) */
+/** Blue-to-red 11-color heatmap (libvgcode ColorRange.hpp:14) */
 export const DEFAULT_RANGES_COLORS: number[][]
 
 export interface ViewTypeDef {
   key: 'feature' | 'speed' | 'height' | 'width' | 'fan' | 'temp'
   label: string
-  /** 연속값(히트맵)인가. false 면 고정색. */
+  /** Whether values are continuous (heatmap). False means a fixed color. */
   cont: boolean
   unit: string
 }
 export const VIEW_TYPES: ViewTypeDef[]
 
-/** per-vertex 부가 정보 */
+/** Per-vertex extra data */
 export interface SegmentMeta {
   vType: Uint8Array
   vWidth: Float32Array
@@ -42,16 +42,16 @@ export interface SegmentData {
   maxAbs: number
   hasNaN: boolean
   meta: SegmentMeta
-  /** 타입별 총 압출 길이 (index = 툴패스 타입, 길이 16) */
+  /** Total extruded length per type (index = toolpath type, length 16) */
   typeLengths: Float64Array
-  /** 정점이 하나도 없으면 null */
+  /** Null when there is not a single vertex */
   bbox: { min: [number, number, number]; max: [number, number, number] } | null
 }
 
-/** 커널 layers[{z, paths(stride8), widths[]}] → GPU 스트림. */
+/** Kernel layers[{z, paths(stride8), widths[]}] -> GPU stream. */
 export function buildSegmentData(layers: unknown[], defaultLineWidth: number): SegmentData
 
-/** 타입별 길이 비율(%), pct 내림차순. 시간은 커널이 role 별로 노출하지 않아 길이로 근사한다. */
+/** Length share per type (%), descending by pct. The kernel does not expose time per role, so length is used as an approximation. */
 export function roleRatios(typeLengths: Float64Array | number[]): Array<{
   type: number
   label: string
@@ -60,7 +60,7 @@ export function roleRatios(typeLengths: Float64Array | number[]): Array<{
 }>
 
 /**
- * speed/fan/temp 는 커널 툴패스에 없어 설정값에서 유도한다 — 그 유도에 쓰는 값들.
+ * speed/fan/temp are absent from the kernel toolpath and derived from settings — these are the values used for that.
  */
 export interface ColorContext {
   speedByType?: Record<number, number>
@@ -73,26 +73,26 @@ export interface ColorContext {
 }
 
 export interface ColorResult {
-  /** per-vertex RGBA (nV*4). `.r` 에 색이 packed 돼 있다. */
+  /** Per-vertex RGBA (nV*4). The color is packed into `.r`. */
   color: Float32Array
   min: number
   max: number
   viewType: ViewTypeDef['key']
   label: string
   unit: string
-  /** false 면 고정색 — min/max 는 0 이고 범례를 그리면 안 된다. */
+  /** False means fixed colors — min/max are 0 and no legend should be drawn. */
   cont: boolean
 }
 
 export function computeColors(data: SegmentData, viewType: ViewTypeDef['key'], ctx: ColorContext): ColorResult
 
 export interface ToolpathHandle {
-  /** THREE.Mesh — 인자로 넘긴 THREE 네임스페이스의 타입 */
+  /** THREE.Mesh — typed by the THREE namespace passed in */
   mesh: any
   /** THREE.LineSegments (travel) */
   travLines: any
   setLayerRange(lo: number, hi: number): void
-  /** 하위호환 — setLayerRange(0, n-1) 과 같다. */
+  /** Backwards compatible — same as setLayerRange(0, n-1). */
   setVisibleLayers(n: number): void
   setTravelVisible(visible: boolean): void
   setColors(color: Float32Array): void
@@ -101,5 +101,5 @@ export interface ToolpathHandle {
   layerCount: number
 }
 
-/** @param THREE - `import * as THREE from 'three'` 네임스페이스. 소비자 인스턴스를 그대로 쓴다. */
+/** @param THREE - the `import * as THREE from 'three'` namespace. The consumer's instance is used as-is. */
 export function makeToolpath(THREE: any, data: SegmentData): ToolpathHandle

package/types/viewer.d.ts

@@ -3,11 +3,11 @@ import type * as React from 'react'
 import type { SlicerSettings } from './settings-keys.d.ts'
 
 export interface ViewportProps {
-  /** sparse 설정 맵. 기본 `{}`. */
+  /** Sparse settings map. Defaults to `{}`. */
   settings?: SlicerSettings
-  /** React setState 형태. 기본 no-op. */
+  /** React setState shape. Defaults to a no-op. */
   setSettings?: React.Dispatch<React.SetStateAction<SlicerSettings>>
-  /** 좌측 프로세스 패널 슬롯 — 보통 `<SettingsPanel embedded/>`. 기본 null. */
+  /** Left process-panel slot — usually `<SettingsPanel embedded/>`. Defaults to null. */
   processPanel?: React.ReactNode
 }
 

package/types/wasm.d.ts

@@ -1,5 +1,5 @@
-// three-slicer/wasm, three-slicer/wasm-mt — emscripten 글루(생성물, 3.5MB+).
-// ponytail: 여기에 정확한 타입을 쓰지 않는다. 글루는 재빌드 때마다 바뀌고, 공개 API 는
-//   three-slicer 의 createSlicer() 다. 직접 쓰는 쪽은 이미 커널 내부를 아는 쪽.
+// three-slicer/wasm, three-slicer/wasm-mt — emscripten glue (generated, 3.5MB+).
+// ponytail: no precise types here. The glue changes on every rebuild, and the public API is
+//   createSlicer() from three-slicer. Anyone using this directly already knows the kernel internals.
 declare const factory: (opts?: Record<string, unknown>) => Promise<any>
 export default factory

package/types/worker.d.ts

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