partforge 0.20.1 → 0.20.2

package/docs/AUTHORING-PARTS.md

@@ -316,24 +316,36 @@ changing any of them is a fresh cache node while an identical rebuild is a hit.
 `parameters` is an **array of sections**; the framework builds the panel from it and
 binds each control to a key in `defaults`. Two section kinds:
 
-**Preset + sliders section:**
+**Preset + controls section:**
 
 ```js
 {
   id: "body",
   title: "Body",
   presets: { M3: { od: 8, bore: 3.4, h: 10 }, M5: { od: 12, bore: 5.4, h: 16 } }, // name → param overrides
-  advanced: [                                  // sliders revealed under "Advanced"
+  advanced: [                                  // controls revealed under "Advanced"
     { key: "od",   label: "Outer diameter", unit: "mm", min: 4, max: 40, step: 0.5 },
     { key: "bore", label: "Bore",           unit: "mm", min: 1, max: 30, step: 0.1, control: "number" },
+    { key: "title", label: "Title", control: "text" },
+    { key: "label", label: "Label", control: "textarea" },
   ],
 }
 ```
 
-Each slider/feature control shows an **editable number box** beside it — drag the
+Numeric slider/feature controls show an **editable number box** beside them — drag the
 slider or type an exact value (finer than `step` is allowed; typed values clamp to
-`[min, max]`). Optional `control` per parameter: omit it (or `"slider"`) for a slider
-+ box; `"number"` for a box only (no slider — handy for precise or wide-range values).
+`[min, max]`). Optional `control` per parameter chooses the input:
+
+- omit it (or use `"slider"`) for a slider + number box;
+- `"number"` for a number box only (handy for precise or wide-range values);
+- `"text"` for a single-line string field;
+- `"textarea"` for a multiline string field whose line breaks are preserved.
+
+Text fields update `params` live on every edit, so the existing rebuild loop previews
+the new string immediately. Give every text key a string value in `defaults`; empty
+strings are valid control values, while the part's build function decides whether its
+geometry supports them. Editing any control in a preset section selects `Custom`, and
+choosing a preset updates both numeric and text fields.
 
 **Feature-toggle section** (checkbox enables a feature + reveals its sliders; `0` = off):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "partforge",
-  "version": "0.20.1",
+  "version": "0.20.2",
   "description": "Turn a declarative part definition into a parametric-CAD web app (three.js + Manifold/Replicad). Requires a Vite-based consumer.",
   "type": "module",
   "license": "MIT",

package/src/framework/app.css

@@ -81,6 +81,14 @@ select.preset {
 .row .num::-webkit-outer-spin-button, .row .num::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }
 .row .num { -moz-appearance: textfield; }
 .row .unit { font-family: var(--pf-mono); color: var(--pf-muted); font-size: 10px; }
+.text-input {
+  display: block; width: 100%; font: 12px/1.4 var(--pf-mono);
+  background: var(--pf-input-bg); color: var(--pf-text-strong);
+  border: 1px solid var(--pf-border); border-radius: 6px; padding: 6px 8px;
+}
+textarea.text-input { min-height: 64px; resize: vertical; }
+.text-input:focus { outline: none; border-color: var(--pf-accent);
+  box-shadow: 0 0 0 3px color-mix(in oklab, var(--pf-accent) 35%, transparent); }
 
 /* crafted range slider — hairline track + CAD-blue handle (the panel's signature control) */
 input[type="range"] { -webkit-appearance: none; appearance: none; width: 100%; height: 18px; margin: 0; background: transparent; cursor: pointer; }

package/src/framework/controls.js

@@ -113,6 +113,8 @@ function el(tag, className, text) {
 // One parameter control bound to params[def.key]. `def.control`:
 //   "slider" (default) — range slider + an editable number box (drag OR type)
 //   "number"           — number box only (no slider)
+//   "text"             — single-line text field
+//   "textarea"         — multiline text field
 // The box accepts exact values (finer than `step`); typed values clamp to
 // [min, max] on commit (blur/Enter). Returns { wrap, sync }.
 function makeSlider(def, params, onChange, info) {
@@ -173,6 +175,34 @@ function makeSlider(def, params, onChange, info) {
   return { wrap, sync };
 }
 
+function makeTextControl(def, params, onChange, info) {
+  const multiline = def.control === "textarea";
+  const wrap = el("div", "slider");
+  const row = el("div", "row");
+  const label = el("label", "", def.label);
+  attachInfo(label, def.description, info);
+  row.append(label);
+  wrap.append(row);
+
+  const field = document.createElement(multiline ? "textarea" : "input");
+  if (!multiline) field.type = "text";
+  field.className = "text-input";
+  field.value = String(params[def.key] ?? "");
+  field.addEventListener("input", () => {
+    params[def.key] = field.value;
+    onChange?.();
+  });
+  wrap.append(field);
+
+  const sync = () => { field.value = String(params[def.key] ?? ""); };
+  return { wrap, sync };
+}
+
+const makeParameterControl = (def, params, onChange, info) =>
+  def.control === "text" || def.control === "textarea"
+    ? makeTextControl(def, params, onChange, info)
+    : makeSlider(def, params, onChange, info);
+
 // A collapsible "Advanced ▾" block. Returns { adv, toggle }.
 function advancedBlock() {
   const adv = el("div", "adv hidden");
@@ -242,7 +272,7 @@ function buildPresetSection(section, sec, params, onDirty, register, info) {
   if (advanced.length) {
     const { adv, toggle } = advancedBlock();
     for (const def of advanced) {
-      const s = makeSlider(def, params, () => { if (preset) preset.value = "Custom"; onDirty?.(); }, info);
+      const s = makeParameterControl(def, params, () => { if (preset) preset.value = "Custom"; onDirty?.(); }, info);
       adv.append(s.wrap);
       syncs[def.key] = s.sync;
       register(def.key, s.wrap);
@@ -281,7 +311,7 @@ function buildFeatureSection(section, sec, params, onDirty, register, info) {
     const group = el("div", "feat-group");
     const syncs = [];
     for (const def of feat.sliders.filter((d) => !d.hidden)) {
-      const s = makeSlider(def, params, onDirty, info);
+      const s = makeParameterControl(def, params, onDirty, info);
       group.append(s.wrap);
       syncs.push(s.sync);
       register(def.key, s.wrap);

package/src/framework/cutaway-gizmo.js

@@ -287,6 +287,11 @@ export function createCutawayGizmo({
 
   function pick(event, ray) {
     if (pickHandle) return resolveHandle(pickHandle(event, handles, ray));
+    handleRoot.updateWorldMatrix(true, true);
+    const intersection = raycaster.intersectObjects(hitProxies, false)[0];
+    const intersectedHandle = resolveHandle(intersection);
+    if (intersectedHandle) return intersectedHandle;
+
     const center = projectToClient(group.position);
     if (center) {
       const dx = event.clientX - center.x;
@@ -296,9 +301,7 @@ export function createCutawayGizmo({
         return "translate";
       }
     }
-    handleRoot.updateWorldMatrix(true, true);
-    const intersection = raycaster.intersectObjects(hitProxies, false)[0];
-    return resolveHandle(intersection);
+    return null;
   }
 
   function safeCapture(pointerId) {

package/src/parts/nameplate.js

@@ -5,16 +5,16 @@
 // exercises shape2d + the extrude/boolean path. Open /nameplate.html after `npm run dev`.
 import { roundedRectPolygon } from "partforge/geometry";
 
-const LABEL = "PARTFORGE\nv0.20";
-
 export default {
   meta: { title: "Nameplate", units: "mm", background: 0x15181d },
   parameters: [
     {
       id: "text",
       title: "Lettering",
-      description: "The text is a two-line label (`PARTFORGE` over `v0.20`). It is resolved to exact glyph curves — counters in **A R O G** and the **0** stay open — and sized by cap height.",
+      description: "Editable text resolved to exact glyph curves, with open counters and sizing based on cap height.",
       advanced: [
+        { key: "label", label: "Text", control: "textarea",
+          description: "The text rendered on the nameplate. Line breaks create multiple lines." },
         { key: "size", label: "Cap height", unit: "mm", min: 4, max: 16, step: 0.5,
           description: "Height of the uppercase letters. The second line scales with it." },
         { key: "depth", label: "Relief depth", unit: "mm", min: 0.4, max: 3, step: 0.1,
@@ -45,14 +45,14 @@ export default {
       ],
     },
   ],
-  defaults: { size: 8, depth: 1.2, stroke: 0, margin: 4, corner: 3, thickness: 3, engrave: 0 },
+  defaults: { label: "PARTFORGE\nv0.20", size: 8, depth: 1.2, stroke: 0, margin: 4, corner: 3, thickness: 3, engrave: 0 },
   parts: {
     plate: {
       label: "Nameplate",
       views: ["plate"],
       export: { name: "nameplate" },
       build: (k, p) => {
-        let text = k.text2d(LABEL, { size: p.size, align: "center", valign: "middle", lineHeight: p.size * 1.7 });
+        let text = k.text2d(p.label, { size: p.size, align: "center", valign: "middle", lineHeight: p.size * 1.7 });
         // Shape2D offset on the lettering: grow (>0, bolder) or shrink (<0, thinner). Guard
         // against a shrink that collapses thin strokes — keep the un-offset letters if so.
         if (p.stroke !== 0) {