← Garden room - 4x3 - Design Profile Demo

Door Header Panel

v4 Gemini approved

Create the door header OSB/EPS SIP panel, 850x122x305mm. Include a spline joint on both left and right edges to securely lock into the vertical spline groove of the adjacent front SIP panels.

Dependencies

front_left_sip.header_spline front_right_sip.header_spline

Interfaces Provided

top_face (face)
◉
Agent initialized (status: waiting_for_dependencies, action: check_dependencies)
◉
Provider: google | Profile: balanced
◉
Provider updated to google / balanced
◇
Received interface front_right_sip.top_face: %{name: "top_face", type: "face", value: %{}, agent_id: "front_right_sip"}
◇
Received interface front_right_sip.header_spline: %{name: "header_spline", type: "spline", value: %{}, agent_id: "front_right_sip"}
◇
Received interface front_left_sip.top_face: %{name: "top_face", type: "face", value: %{}, agent_id: "front_left_sip"}
◇
Received interface front_left_sip.header_spline: %{name: "header_spline", type: "spline", value: %{}, agent_id: "front_left_sip"}
◉
All dependencies resolved, starting generation
◉
Generating v1
○
Calling Gemini API for code generation (gemini-3.1-pro-preview)...
◉
Generation token budget: max_tokens=12288, thinking_budget=0 (retry_count=0)
●
Received response (1891 tokens)
◆
door_header_sip_v1.py · 150 lines 
import FreeCAD
import Part
import math
from FreeCAD import Vector

# === PARAMETERS ===
LENGTH = 850.0
THICKNESS = 122.0
HEIGHT = 305.0

OSB_THICKNESS = 11.0
CORE_THICKNESS = 100.0

SPLINE_W = 45.0
SPLINE_D = 90.0
GROOVE_DEPTH = SPLINE_W / 2.0  # 22.5mm recess per panel

# === DOCUMENT ===
doc = FreeCAD.ActiveDocument or FreeCAD.newDocument("Door_Header_SIP")

# === BUILD PANEL ===
# Front OSB face
face1 = Part.makeBox(LENGTH, OSB_THICKNESS, HEIGHT, Vector(0, 0, 0))

# EPS Core
core = Part.makeBox(LENGTH, CORE_THICKNESS, HEIGHT, Vector(0, OSB_THICKNESS, 0))

# Back OSB face
face2 = Part.makeBox(LENGTH, OSB_THICKNESS, HEIGHT, Vector(0, OSB_THICKNESS + CORE_THICKNESS, 0))

# Fuse into a single SIP panel solid
panel = face1.fuse(core).fuse(face2)

# === SPLINE GROOVES ===
# Centered in the total thickness
spline_y_offset = (THICKNESS - SPLINE_D) / 2.0

# Cut left groove
left_groove = Part.makeBox(GROOVE_DEPTH, SPLINE_D, HEIGHT, 
                           Vector(0, spline_y_offset, 0))

# Cut right groove
right_groove = Part.makeBox(GROOVE_DEPTH, SPLINE_D, HEIGHT, 
                            Vector(LENGTH - GROOVE_DEPTH, spline_y_offset, 0))

panel = panel.cut(left_groove).cut(right_groove)
panel = panel.removeSplitter()

# === PART CODE ===
PART_CODE = "G-1"
PRINT_SCALE = 50  # 1:50 model scale — adjust if printing at a different scale

def _emboss_part_code(shape, code, print_scale=PRINT_SCALE):
    """Cut part code into largest face. Returns shape unmodified on any failure."""
    import os, math
    depth_raw = 0.6 * print_scale
    try:
        # --- font ---
        rd = FreeCAD.getResourceDir()
        font = None
        for fn in ("osifont-lgpl3fe.ttf", "FreeSans.ttf", "FreeCAD.ttf"):
            fp = os.path.join(rd, "Mod", "TechDraw", "Resources", "fonts", fn)
            if os.path.exists(fp):
                font = fp; break
        if font is None:
            return shape

        # --- cap depth at 33% of thinnest component dimension ---
        all_dims = sorted([shape.BoundBox.XLength, shape.BoundBox.YLength, shape.BoundBox.ZLength])
        depth = min(depth_raw, all_dims[0] * 0.33)

        # --- find largest face ---
        best = max(shape.Faces, key=lambda f: f.Area)
        n = best.normalAt(0, 0)
        c = best.CenterOfMass

        # --- text height: 2 mm at print scale, capped at 80% of longest face edge ---
        fb = best.BoundBox
        fb_dims = sorted([d for d in (fb.XLength, fb.YLength, fb.ZLength) if d > 1.0])
        text_h = min(2.0 * print_scale, (fb_dims[-1] * 0.80) if fb_dims else 2.0 * print_scale)

        # --- orthonormal face frame: right (r), up (u), out (n) ---
        wz = Vector(0, 0, 1)
        wy = Vector(0, 1, 0)
        up_ref = wy if abs(n.dot(wz)) > 0.9 else wz
        r = up_ref.cross(n).normalize()
        u = n.cross(r).normalize()

        # --- build text faces from wires (handles letters with holes) ---
        ss = Part.makeShapeString(String=code, FontFile=font, Size=text_h, Tracking=0)
        wires = sorted(ss.Wires, key=lambda w: w.BoundBox.DiagonalLength, reverse=True)
        faces_out = []
        used = set()
        for i, ow in enumerate(wires):
            if i in used:
                continue
            ob = ow.BoundBox
            holes = []
            for j, iw in enumerate(wires):
                if j <= i or j in used:
                    continue
                ib = iw.BoundBox
                if ob.XMin < ib.XMin and ob.XMax > ib.XMax and ob.YMin < ib.YMin and ob.YMax > ib.YMax:
                    holes.append(iw)
                    used.add(j)
            used.add(i)
            try:
                faces_out.append(Part.Face([ow] + holes) if holes else Part.Face(ow))
            except Exception:
                try:
                    faces_out.append(Part.Face(ow))
                except Exception:
                    pass
        if not faces_out:
            return shape
        tf = Part.Compound(faces_out) if len(faces_out) > 1 else faces_out[0]

        # --- combined matrix: center text → rotate onto face → translate to face center ---
        tb = tf.BoundBox
        mc = FreeCAD.Matrix()          # center text at local origin
        mc.A14 = -tb.XLength / 2
        mc.A24 = -tb.YLength / 2
        mr = FreeCAD.Matrix()          # rotate: X→r, Y→u, Z→n
        mr.A11 = r.x;  mr.A12 = u.x;  mr.A13 = n.x
        mr.A21 = r.y;  mr.A22 = u.y;  mr.A23 = n.y
        mr.A31 = r.z;  mr.A32 = u.z;  mr.A33 = n.z
        mt = FreeCAD.Matrix()          # translate to face center, offset 5% outward
        mt.A14 = c.x + n.x * depth * 0.05
        mt.A24 = c.y + n.y * depth * 0.05
        mt.A34 = c.z + n.z * depth * 0.05
        tf2 = tf.transformGeometry(mt.multiply(mr.multiply(mc)))

        # --- extrude inward and cut ---
        extrude_vec = Vector(-n.x * depth * 1.1, -n.y * depth * 1.1, -n.z * depth * 1.1)
        text_solid = tf2.extrude(extrude_vec)
        return shape.cut(text_solid)

    except Exception as e:
        print(f"[part_code] emboss skipped: {e}")
        return shape

panel = _emboss_part_code(panel, PART_CODE)

# === ADD TO DOCUMENT ===
obj = doc.addObject("Part::Feature", "Door_Header_SIP")
obj.Shape = panel

doc.recompute()
if FreeCAD.GuiUp:
    FreeCAD.Gui.ActiveDocument.ActiveView.fitAll()
●
Executing in FreeCAD...
◉
StepAnalyzer failed: FreeCAD could not read STEP file: FreeCAD exception thrown (File to load not existing or not readable) — skipping
●
FreeCAD execution succeeded
●
Exported: model.stl
◉
Generation succeeded and component was auto-approved (v1)
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◇
Received interface front_left_sip.top_face: %{name: "top_face", type: "face", value: %{}, agent_id: "front_left_sip"}
◇
Received interface front_left_sip.header_spline: %{name: "header_spline", type: "spline", value: %{}, agent_id: "front_left_sip"}
◇
Received interface front_left_sip.top_face: %{name: "top_face", type: "face", value: %{}, agent_id: "front_left_sip"}
◇
Received interface front_left_sip.header_spline: %{name: "header_spline", type: "spline", value: %{}, agent_id: "front_left_sip"}
◉
Upstream interface changed: front_left_sip.header_spline
◉
Regeneration requested by user
◉
Generating v2
○
Calling Gemini API for code generation (gemini-3.1-pro-preview)...
◉
Generation token budget: max_tokens=12288, thinking_budget=0 (retry_count=0)
●
Received response (1695 tokens)
◆
door_header_sip_v2.py · 137 lines 
import FreeCAD
import Part
import os
import math
from FreeCAD import Vector

# === PARAMETERS ===
WIDTH = 850.0
THICKNESS = 122.0
HEIGHT = 305.0

FACE_T = 11.0
CORE_T = 100.0
SPLINE_DEPTH = 22.5  # Standard recess for a 45mm block spline

# === DOCUMENT ===
doc = FreeCAD.ActiveDocument or FreeCAD.newDocument("Model")

# === BUILD GEOMETRY ===
# Create OSB faces
osb_front = Part.makeBox(WIDTH, FACE_T, HEIGHT, Vector(0, 0, 0))
osb_back = Part.makeBox(WIDTH, FACE_T, HEIGHT, Vector(0, FACE_T + CORE_T, 0))

# Create EPS core, recessed on left and right sides for the spline joint
core = Part.makeBox(
    WIDTH - 2 * SPLINE_DEPTH, 
    CORE_T, 
    HEIGHT, 
    Vector(SPLINE_DEPTH, FACE_T, 0)
)

# Fuse layers into a single panel solid
panel = osb_front.fuse(core).fuse(osb_back)
panel = panel.removeSplitter()

# === PART CODE ===
PART_CODE = "G-1"
PRINT_SCALE = 50  # 1:50 model scale — adjust if printing at a different scale

def _emboss_part_code(shape, code, print_scale=PRINT_SCALE):
    """Cut part code into largest face. Returns shape unmodified on any failure."""
    import os, math
    depth_raw = 0.6 * print_scale
    try:
        # --- font ---
        rd = FreeCAD.getResourceDir()
        font = None
        for fn in ("osifont-lgpl3fe.ttf", "FreeSans.ttf", "FreeCAD.ttf"):
            fp = os.path.join(rd, "Mod", "TechDraw", "Resources", "fonts", fn)
            if os.path.exists(fp):
                font = fp; break
        if font is None:
            return shape

        # --- cap depth at 33% of thinnest component dimension ---
        all_dims = sorted([shape.BoundBox.XLength, shape.BoundBox.YLength, shape.BoundBox.ZLength])
        depth = min(depth_raw, all_dims[0] * 0.33)

        # --- find largest face ---
        best = max(shape.Faces, key=lambda f: f.Area)
        n = best.normalAt(0, 0)
        c = best.CenterOfMass

        # --- text height: 2 mm at print scale, capped at 80% of longest face edge ---
        fb = best.BoundBox
        fb_dims = sorted([d for d in (fb.XLength, fb.YLength, fb.ZLength) if d > 1.0])
        text_h = min(2.0 * print_scale, (fb_dims[-1] * 0.80) if fb_dims else 2.0 * print_scale)

        # --- orthonormal face frame: right (r), up (u), out (n) ---
        wz = Vector(0, 0, 1)
        wy = Vector(0, 1, 0)
        up_ref = wy if abs(n.dot(wz)) > 0.9 else wz
        r = up_ref.cross(n).normalize()
        u = n.cross(r).normalize()

        # --- build text faces from wires (handles letters with holes) ---
        ss = Part.makeShapeString(String=code, FontFile=font, Size=text_h, Tracking=0)
        wires = sorted(ss.Wires, key=lambda w: w.BoundBox.DiagonalLength, reverse=True)
        faces_out = []
        used = set()
        for i, ow in enumerate(wires):
            if i in used:
                continue
            ob = ow.BoundBox
            holes = []
            for j, iw in enumerate(wires):
                if j <= i or j in used:
                    continue
                ib = iw.BoundBox
                if ob.XMin < ib.XMin and ob.XMax > ib.XMax and ob.YMin < ib.YMin and ob.YMax > ib.YMax:
                    holes.append(iw)
                    used.add(j)
            used.add(i)
            try:
                faces_out.append(Part.Face([ow] + holes) if holes else Part.Face(ow))
            except Exception:
                try:
                    faces_out.append(Part.Face(ow))
                except Exception:
                    pass
        if not faces_out:
            return shape
        tf = Part.Compound(faces_out) if len(faces_out) > 1 else faces_out[0]

        # --- combined matrix: center text → rotate onto face → translate to face center ---
        tb = tf.BoundBox
        mc = FreeCAD.Matrix()          # center text at local origin
        mc.A14 = -tb.XLength / 2
        mc.A24 = -tb.YLength / 2
        mr = FreeCAD.Matrix()          # rotate: X→r, Y→u, Z→n
        mr.A11 = r.x;  mr.A12 = u.x;  mr.A13 = n.x
        mr.A21 = r.y;  mr.A22 = u.y;  mr.A23 = n.y
        mr.A31 = r.z;  mr.A32 = u.z;  mr.A33 = n.z
        mt = FreeCAD.Matrix()          # translate to face center, offset 5% outward
        mt.A14 = c.x + n.x * depth * 0.05
        mt.A24 = c.y + n.y * depth * 0.05
        mt.A34 = c.z + n.z * depth * 0.05
        tf2 = tf.transformGeometry(mt.multiply(mr.multiply(mc)))

        # --- extrude inward and cut ---
        extrude_vec = Vector(-n.x * depth * 1.1, -n.y * depth * 1.1, -n.z * depth * 1.1)
        text_solid = tf2.extrude(extrude_vec)
        return shape.cut(text_solid)

    except Exception as e:
        print(f"[part_code] emboss skipped: {e}")
        return shape

panel = _emboss_part_code(panel, PART_CODE)

# === ADD TO DOCUMENT ===
obj = doc.addObject("Part::Feature", "Body")
obj.Shape = panel

doc.recompute()
if FreeCAD.GuiUp:
    FreeCAD.Gui.ActiveDocument.ActiveView.fitAll()
●
Executing in FreeCAD...
◉
StepAnalyzer failed: FreeCAD could not read STEP file: FreeCAD exception thrown (File to load not existing or not readable) — skipping
●
FreeCAD execution succeeded
●
Exported: model.stl
◉
Generation succeeded and component was auto-approved (v2)
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◇
Received interface front_right_sip.top_face: %{name: "top_face", type: "face", value: %{}, agent_id: "front_right_sip"}
◇
Received interface front_right_sip.header_spline: %{name: "header_spline", type: "spline", value: %{}, agent_id: "front_right_sip"}
◉
Upstream interface changed: front_right_sip.header_spline
◉
Upstream interface changed: front_right_sip.header_spline
◉
Regeneration requested by user
◉
Generating v3
○
Calling Gemini API for code generation (gemini-3.1-pro-preview)...
◉
Generation token budget: max_tokens=12288, thinking_budget=0 (retry_count=0)
●
Received response (1802 tokens)
◆
door_header_sip_v3.py · 139 lines 
import FreeCAD
import Part
import math
from FreeCAD import Vector, Placement, Rotation

# === PARAMETERS ===
LENGTH = 850.0
THICKNESS = 122.0
HEIGHT = 305.0
OSB_THICKNESS = 11.0
CORE_THICKNESS = THICKNESS - (2.0 * OSB_THICKNESS)  # 100.0 mm
SPLINE_GROOVE_DEPTH = 22.5

# === DOCUMENT ===
doc = FreeCAD.ActiveDocument or FreeCAD.newDocument("Model")

# === BUILD GEOMETRY ===
# Front OSB face (Y = 0)
front_osb = Part.makeBox(LENGTH, OSB_THICKNESS, HEIGHT, Vector(0, 0, 0))

# Back OSB face
back_osb = Part.makeBox(LENGTH, OSB_THICKNESS, HEIGHT, Vector(0, THICKNESS - OSB_THICKNESS, 0))

# EPS Core (recessed on left and right for spline grooves)
core_length = LENGTH - (2.0 * SPLINE_GROOVE_DEPTH)
core = Part.makeBox(
    core_length, 
    CORE_THICKNESS, 
    HEIGHT, 
    Vector(SPLINE_GROOVE_DEPTH, OSB_THICKNESS, 0)
)

# Fuse all parts into a single solid SIP panel
result = front_osb.fuse([back_osb, core])
result = result.removeSplitter()

# === PART CODE ===
PART_CODE = "G-1"
PRINT_SCALE = 50  # 1:50 model scale — adjust if printing at a different scale

def _emboss_part_code(shape, code, print_scale=PRINT_SCALE):
    """Cut part code into largest face. Returns shape unmodified on any failure."""
    import os, math
    depth_raw = 0.6 * print_scale
    try:
        # --- font ---
        rd = FreeCAD.getResourceDir()
        font = None
        for fn in ("osifont-lgpl3fe.ttf", "FreeSans.ttf", "FreeCAD.ttf"):
            fp = os.path.join(rd, "Mod", "TechDraw", "Resources", "fonts", fn)
            if os.path.exists(fp):
                font = fp; break
        if font is None:
            return shape

        # --- cap depth at 33% of thinnest component dimension ---
        all_dims = sorted([shape.BoundBox.XLength, shape.BoundBox.YLength, shape.BoundBox.ZLength])
        depth = min(depth_raw, all_dims[0] * 0.33)

        # --- find largest face ---
        best = max(shape.Faces, key=lambda f: f.Area)
        n = best.normalAt(0, 0)
        c = best.CenterOfMass

        # --- text height: 2 mm at print scale, capped at 80% of longest face edge ---
        fb = best.BoundBox
        fb_dims = sorted([d for d in (fb.XLength, fb.YLength, fb.ZLength) if d > 1.0])
        text_h = min(2.0 * print_scale, (fb_dims[-1] * 0.80) if fb_dims else 2.0 * print_scale)

        # --- orthonormal face frame: right (r), up (u), out (n) ---
        wz = Vector(0, 0, 1)
        wy = Vector(0, 1, 0)
        up_ref = wy if abs(n.dot(wz)) > 0.9 else wz
        r = up_ref.cross(n).normalize()
        u = n.cross(r).normalize()

        # --- build text faces from wires (handles letters with holes) ---
        ss = Part.makeShapeString(String=code, FontFile=font, Size=text_h, Tracking=0)
        wires = sorted(ss.Wires, key=lambda w: w.BoundBox.DiagonalLength, reverse=True)
        faces_out = []
        used = set()
        for i, ow in enumerate(wires):
            if i in used:
                continue
            ob = ow.BoundBox
            holes = []
            for j, iw in enumerate(wires):
                if j <= i or j in used:
                    continue
                ib = iw.BoundBox
                if ob.XMin < ib.XMin and ob.XMax > ib.XMax and ob.YMin < ib.YMin and ob.YMax > ib.YMax:
                    holes.append(iw)
                    used.add(j)
            used.add(i)
            try:
                faces_out.append(Part.Face([ow] + holes) if holes else Part.Face(ow))
            except Exception:
                try:
                    faces_out.append(Part.Face(ow))
                except Exception:
                    pass
        if not faces_out:
            return shape
        tf = Part.Compound(faces_out) if len(faces_out) > 1 else faces_out[0]

        # --- combined matrix: center text → rotate onto face → translate to face center ---
        tb = tf.BoundBox
        mc = FreeCAD.Matrix()          # center text at local origin
        mc.A14 = -tb.XLength / 2
        mc.A24 = -tb.YLength / 2
        mr = FreeCAD.Matrix()          # rotate: X→r, Y→u, Z→n
        mr.A11 = r.x;  mr.A12 = u.x;  mr.A13 = n.x
        mr.A21 = r.y;  mr.A22 = u.y;  mr.A23 = n.y
        mr.A31 = r.z;  mr.A32 = u.z;  mr.A33 = n.z
        mt = FreeCAD.Matrix()          # translate to face center, offset 5% outward
        mt.A14 = c.x + n.x * depth * 0.05
        mt.A24 = c.y + n.y * depth * 0.05
        mt.A34 = c.z + n.z * depth * 0.05
        tf2 = tf.transformGeometry(mt.multiply(mr.multiply(mc)))

        # --- extrude inward and cut ---
        extrude_vec = Vector(-n.x * depth * 1.1, -n.y * depth * 1.1, -n.z * depth * 1.1)
        text_solid = tf2.extrude(extrude_vec)
        return shape.cut(text_solid)

    except Exception as e:
        print(f"[part_code] emboss skipped: {e}")
        return shape

result = _emboss_part_code(result, PART_CODE)

# === ADD TO DOCUMENT ===
# Named strictly "Body" per requirements for Part::Feature elements
obj = doc.addObject("Part::Feature", "Body")
obj.Shape = result

doc.recompute()
if FreeCAD.GuiUp:
    FreeCAD.Gui.ActiveDocument.ActiveView.fitAll()
●
Executing in FreeCAD...
◉
StepAnalyzer failed: FreeCAD could not read STEP file: FreeCAD exception thrown (File to load not existing or not readable) — skipping
●
FreeCAD execution succeeded
●
Exported: model.stl
◉
Generation succeeded and component was auto-approved (v3)
◉
Upstream interface changed: front_right_sip.header_spline
◉
Regeneration requested by user
◉
Generating v4
○
Calling Gemini API for code generation (gemini-3.1-pro-preview)...
◉
Generation token budget: max_tokens=12288, thinking_budget=0 (retry_count=0)
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
●
Received response (1927 tokens)
◆
door_header_sip_v4.py · 157 lines 
import FreeCAD
import Part
import math
from FreeCAD import Vector

# === PARAMETERS ===
PANEL_LENGTH = 850.0
HEIGHT = 305.0
FACE_T = 11.0
CORE_T = 100.0
TOTAL_T = 122.0
SPLINE_PROTRUSION = 22.5

# === DOCUMENT ===
doc = FreeCAD.ActiveDocument or FreeCAD.newDocument("HeaderSIP")

# === BUILD GEOMETRY ===
# Note: To satisfy the coordinate system rule (start at origin X=0),
# the left-most point is the tip of the left spline. The main panel OSB 
# faces start at X = SPLINE_PROTRUSION.

# 1. Left Spline (Protruding part)
spline_left = Part.makeBox(
    SPLINE_PROTRUSION, CORE_T, HEIGHT, 
    Vector(0, FACE_T, 0)
)

# 2. Main Panel OSB Faces and EPS Core
osb_front = Part.makeBox(
    PANEL_LENGTH, FACE_T, HEIGHT, 
    Vector(SPLINE_PROTRUSION, 0, 0)
)

core = Part.makeBox(
    PANEL_LENGTH, CORE_T, HEIGHT, 
    Vector(SPLINE_PROTRUSION, FACE_T, 0)
)

osb_back = Part.makeBox(
    PANEL_LENGTH, FACE_T, HEIGHT, 
    Vector(SPLINE_PROTRUSION, FACE_T + CORE_T, 0)
)

# 3. Right Spline (Protruding part)
spline_right = Part.makeBox(
    SPLINE_PROTRUSION, CORE_T, HEIGHT, 
    Vector(SPLINE_PROTRUSION + PANEL_LENGTH, FACE_T, 0)
)

# Combine all components into a single solid body
header_shape = spline_left.fuse([osb_front, core, osb_back, spline_right])
header_shape = header_shape.removeSplitter()

# === PART CODE ===
PART_CODE = "G-1"
PRINT_SCALE = 50  # 1:50 model scale — adjust if printing at a different scale

def _emboss_part_code(shape, code, print_scale=PRINT_SCALE):
    """Cut part code into largest face. Returns shape unmodified on any failure."""
    import os, math
    depth_raw = 0.6 * print_scale
    try:
        # --- font ---
        rd = FreeCAD.getResourceDir()
        font = None
        for fn in ("osifont-lgpl3fe.ttf", "FreeSans.ttf", "FreeCAD.ttf"):
            fp = os.path.join(rd, "Mod", "TechDraw", "Resources", "fonts", fn)
            if os.path.exists(fp):
                font = fp; break
        if font is None:
            return shape

        # --- cap depth at 33% of thinnest component dimension ---
        all_dims = sorted([shape.BoundBox.XLength, shape.BoundBox.YLength, shape.BoundBox.ZLength])
        depth = min(depth_raw, all_dims[0] * 0.33)

        # --- find largest face ---
        best = max(shape.Faces, key=lambda f: f.Area)
        n = best.normalAt(0, 0)
        c = best.CenterOfMass

        # --- text height: 2 mm at print scale, capped at 80% of longest face edge ---
        fb = best.BoundBox
        fb_dims = sorted([d for d in (fb.XLength, fb.YLength, fb.ZLength) if d > 1.0])
        text_h = min(2.0 * print_scale, (fb_dims[-1] * 0.80) if fb_dims else 2.0 * print_scale)

        # --- orthonormal face frame: right (r), up (u), out (n) ---
        wz = Vector(0, 0, 1)
        wy = Vector(0, 1, 0)
        up_ref = wy if abs(n.dot(wz)) > 0.9 else wz
        r = up_ref.cross(n).normalize()
        u = n.cross(r).normalize()

        # --- build text faces from wires (handles letters with holes) ---
        ss = Part.makeShapeString(String=code, FontFile=font, Size=text_h, Tracking=0)
        wires = sorted(ss.Wires, key=lambda w: w.BoundBox.DiagonalLength, reverse=True)
        faces_out = []
        used = set()
        for i, ow in enumerate(wires):
            if i in used:
                continue
            ob = ow.BoundBox
            holes = []
            for j, iw in enumerate(wires):
                if j <= i or j in used:
                    continue
                ib = iw.BoundBox
                if ob.XMin < ib.XMin and ob.XMax > ib.XMax and ob.YMin < ib.YMin and ob.YMax > ib.YMax:
                    holes.append(iw)
                    used.add(j)
            used.add(i)
            try:
                faces_out.append(Part.Face([ow] + holes) if holes else Part.Face(ow))
            except Exception:
                try:
                    faces_out.append(Part.Face(ow))
                except Exception:
                    pass
        if not faces_out:
            return shape
        tf = Part.Compound(faces_out) if len(faces_out) > 1 else faces_out[0]

        # --- combined matrix: center text → rotate onto face → translate to face center ---
        tb = tf.BoundBox
        mc = FreeCAD.Matrix()          # center text at local origin
        mc.A14 = -tb.XLength / 2
        mc.A24 = -tb.YLength / 2
        mr = FreeCAD.Matrix()          # rotate: X→r, Y→u, Z→n
        mr.A11 = r.x;  mr.A12 = u.x;  mr.A13 = n.x
        mr.A21 = r.y;  mr.A22 = u.y;  mr.A23 = n.y
        mr.A31 = r.z;  mr.A32 = u.z;  mr.A33 = n.z
        mt = FreeCAD.Matrix()          # translate to face center, offset 5% outward
        mt.A14 = c.x + n.x * depth * 0.05
        mt.A24 = c.y + n.y * depth * 0.05
        mt.A34 = c.z + n.z * depth * 0.05
        tf2 = tf.transformGeometry(mt.multiply(mr.multiply(mc)))

        # --- extrude inward and cut ---
        extrude_vec = Vector(-n.x * depth * 1.1, -n.y * depth * 1.1, -n.z * depth * 1.1)
        text_solid = tf2.extrude(extrude_vec)
        return shape.cut(text_solid)

    except Exception as e:
        print(f"[part_code] emboss skipped: {e}")
        return shape

# Apply the embossing helper
header_shape = _emboss_part_code(header_shape, PART_CODE)

# === ADD TO DOCUMENT ===
feature = doc.addObject("Part::Feature", "HeaderSIP")
feature.Shape = header_shape

doc.recompute()

if FreeCAD.GuiUp:
    FreeCAD.Gui.ActiveDocument.ActiveView.fitAll()
●
Executing in FreeCAD...
◉
StepAnalyzer failed: FreeCAD could not read STEP file: FreeCAD exception thrown (File to load not existing or not readable) — skipping
●
FreeCAD execution succeeded
●
Exported: model.stl
◉
Generation succeeded and component was auto-approved (v4)
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
◉
Provider updated to google / balanced
v0.0.985