three-slicer 0.1.0 → 0.1.1

package/types/data/invalidation-map.json.d.ts

@@ -0,0 +1,15 @@
+// three-slicer/data/invalidation-map.json — 설정 키 변경 → 무효화되는 슬라이스 단계.
+// 최상위 키 = 무효화 대상 종류(print/object/filament 등).
+
+export interface InvalidationRule {
+  /** 이 규칙이 반응하는 config-schema 키들 */
+  keys: string[]
+  /** 무효화되는 단계 (예: 'psSkirtBrim', 'posSlice') */
+  steps: string[]
+  /** 단계로 표현 안 되는 특수 처리 */
+  special: string[]
+  line?: number
+}
+
+declare const invalidationMap: Record<string, InvalidationRule[]>
+export default invalidationMap

package/types/data/toggle-rules.json.d.ts

@@ -0,0 +1,20 @@
+// three-slicer/data/toggle-rules.json — 원본 toggle_options() 의 enable_if 조건식 추출.
+// 최상위 키 = 그룹명(예: 'toggle_print_fff_options', 'TabPrinter::toggle_options').
+
+export interface ToggleRule {
+  /** 원본 C++ 조건식 문자열. 평가는 three-slicer/toggle 의 evalEnableIf. */
+  enable_if?: string
+  /** 이 조건이 지배하는 config-schema 키들 */
+  fields?: string[]
+  line?: number
+}
+
+export interface ToggleGroup {
+  /** 로컬 변수명 → 원본 C++ 표현식(문자열). 번역은 toggle_eval.js 가 하드코딩으로 한다. */
+  locals: Record<string, string>
+  rules: ToggleRule[]
+  stats?: { toggle_calls_in_source: number; rules_extracted: number }
+}
+
+declare const toggles: Record<string, ToggleGroup>
+export default toggles

package/types/data/ui-tree.json.d.ts

@@ -0,0 +1,19 @@
+// three-slicer/data/ui-tree.json — 원본 Tab.cpp 의 페이지/그룹 트리.
+// 최상위 키 = 빌더명(예: 'TabPrint::build'), 값 = 그 빌더가 만드는 페이지들.
+
+export interface UIGroup {
+  group: string
+  line?: number
+  /** config-schema 의 옵션 키들 */
+  options: string[]
+}
+
+export interface UIPage {
+  page: string
+  icon?: string
+  line?: number
+  groups: UIGroup[]
+}
+
+declare const uiTree: Record<string, UIPage[]>
+export default uiTree

package/types/data.d.ts

@@ -0,0 +1,17 @@
+// three-slicer/data — 추출 JSON 4종. 원본 JSON 을 직접 import 하는 것보다 이쪽을 권한다:
+// import attribute(`with { type: 'json' }`)가 이미 붙어 있어 Node·번들러 양쪽에서 그대로 돌아간다.
+import type { ConfigOption } from './data/config-schema.json.d.ts'
+import type { UIPage } from './data/ui-tree.json.d.ts'
+import type { ToggleGroup } from './data/toggle-rules.json.d.ts'
+import type { InvalidationRule } from './data/invalidation-map.json.d.ts'
+
+export type { ConfigOption, UIPage, ToggleGroup, InvalidationRule }
+
+/** 907개 옵션 정의 */
+export const schema: Record<string, ConfigOption>
+/** 빌더명 → 페이지 트리 */
+export const uiTree: Record<string, UIPage[]>
+/** 그룹명 → enable_if 규칙 */
+export const toggleRules: Record<string, ToggleGroup>
+/** 설정 키 변경 → 무효화 단계 */
+export const invalidationMap: Record<string, InvalidationRule[]>

package/types/gen_settings_types.mjs

@@ -0,0 +1,70 @@
+// config-schema.json → types/settings-keys.d.ts (SlicerSettings 인터페이스, 907키).
+// 재생성: node types/gen_settings_types.mjs      (수동 편집 금지 — 이 스크립트만 고칠 것)
+//
+// ponytail: 스키마의 coXxx 타입만 보고 매핑한다. min/max·nullable 은 타입에 반영하지 않음
+//   (런타임 검증이지 타입 검증이 아니고, 907키 × branded number 는 tsc 를 느리게 만든다).
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const schema = JSON.parse(readFileSync(resolve(here, '../data/config-schema.json'), 'utf8'))
+
+const lit = (v) => "'" + String(v).replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'"
+// enum_values 가 없는 coEnum 도 있다(70/64 불일치) → string 으로 fail-open.
+const enumOf = (o) => (Array.isArray(o.enum_values) && o.enum_values.length)
+  ? o.enum_values.map(lit).join(' | ')
+  : 'string'
+
+// 벡터형은 `T[] | T` — settingScalar() 가 둘 다 받고, UI 는 첫 원소만 편집한다(settings.js:9).
+const vec = (t) => `${/\|/.test(t) ? `(${t})` : t}[] | ${/\|/.test(t) ? `(${t})` : t}`
+
+function tsType(o) {
+  switch (o.type) {
+    case 'coBool': return 'boolean'
+    case 'coBools': return vec('boolean')
+    case 'coInt': case 'coFloat': case 'coPercent': return 'number'
+    case 'coInts': case 'coFloats': case 'coPercents': return vec('number')
+    case 'coFloatOrPercent': return 'number | string'
+    case 'coFloatsOrPercents': return vec('number | string')
+    case 'coString': return 'string'
+    case 'coStrings': return vec('string')
+    case 'coEnum': return enumOf(o)
+    case 'coEnums': return vec(enumOf(o))
+    case 'coPoint': return 'Point'
+    case 'coPoints': return 'Point[]'
+    case 'coPointsGroups': return 'Point[][]'
+    default: return 'unknown'
+  }
+}
+
+const esc = (s) => String(s).replace(/\*\//g, '*\\/')
+const ident = (k) => /^[A-Za-z_$][\w$]*$/.test(k) ? k : lit(k).replace(/^'|'$/g, (m) => m === "'" ? "'" : m)
+
+const lines = []
+for (const key of Object.keys(schema).sort()) {
+  const o = schema[key]
+  const doc = [o.label, o.sidetext ? `(${o.sidetext})` : '', o.tooltip].filter(Boolean).join(' — ')
+  if (doc) lines.push(`  /** ${esc(doc).replace(/\s*\n\s*/g, ' ')} */`)
+  const name = /^[A-Za-z_$][\w$]*$/.test(key) ? key : lit(key)
+  lines.push(`  ${name}?: ${tsType(o)}`)
+}
+
+writeFileSync(resolve(here, 'settings-keys.d.ts'), `// AUTO-GENERATED by types/gen_settings_types.mjs — DO NOT EDIT.
+// Source: data/config-schema.json (${Object.keys(schema).length} keys)
+
+/** [x, y] — coPoint 계열 */
+export type Point = [number, number]
+
+/**
+ * 슬라이서 설정 맵. sparse — 편집한 키만 담고, 없는 키는 config-schema 의 default 가 쓰인다.
+ * 임의 키 확장이 필요하면 \`SlicerSettings & Record<string, unknown>\` 로 넓혀서 쓸 것.
+ */
+export interface SlicerSettings {
+${lines.join('\n')}
+}
+
+/** config-schema 에 존재하는 설정 키 */
+export type SettingKey = keyof SlicerSettings & string
+`)
+console.log(`settings-keys.d.ts written — ${Object.keys(schema).length} keys`)