@protoboardai/ext-docs 0.0.0-stage → 0.2.0

package/lib/standin.ts

@@ -0,0 +1,36 @@
+/**
+ * Stand-in test data for a system, generated from its model by the doc
+ * spec's recipe (`testData.standins`, a module in lib/standins/). Writes
+ * `docs/test-data/<test-id>.json` with status "standin". A file whose status
+ * is "measured" is never touched; existing stand-ins are refreshed (they are
+ * derived data, so regenerating them from the current model is always safe).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import type { BuiltContext } from "./context.ts";
+import type { TestData } from "./testdata.ts";
+
+export async function writeStandins(ctx: BuiltContext): Promise<{ written: string[]; kept: string[] }> {
+  const recipe = ctx.sys.config.testData?.standins;
+  if (!recipe) return { written: [], kept: [] };
+  if (!/^[\w-]+$/.test(recipe)) throw new Error(`testData.standins "${recipe}" is not a recipe name (lib/standins/<name>.ts)`);
+  const mod = await import(new URL(`./standins/${recipe}.ts`, import.meta.url).href);
+  const sets: TestData[] = mod.standins(ctx);
+  const dir = join(ctx.sys.absDocs, "test-data");
+  mkdirSync(dir, { recursive: true });
+  const written: string[] = [];
+  const kept: string[] = [];
+  for (const t of sets) {
+    const file = join(dir, `${t.id}.json`);
+    if (existsSync(file)) {
+      const cur = JSON.parse(readFileSync(file, "utf8"));
+      if (cur.status === "measured") {
+        kept.push(t.id);
+        continue;
+      }
+    }
+    writeFileSync(file, JSON.stringify(t, null, 2) + "\n");
+    written.push(t.id);
+  }
+  return { written, kept };
+}

package/lib/standins/multirotor.ts

@@ -0,0 +1,283 @@
+/**
+ * Stand-in test data for a multirotor, derived from the model so documents
+ * have plausible curves before anything is measured. Every file is written
+ * with status "standin", lists the model queries it was derived from, and
+ * states each assumption the model could not supply. The build never
+ * overwrites a file whose status is "measured".
+ *
+ * Model inputs: the motor maker's full thrust table (performance.thrust_tests,
+ * interpolated row to row by src/system/propulsion.ts), motor idle current, battery voltage / capacity / cell count, part
+ * masses, avionics supply figures (O4 min supply power, GNSS supply current).
+ */
+import type { ModuleDef } from "@deltarobotics/uhd";
+import { category } from "../model.ts";
+import { modelMass } from "../derived.ts";
+import { fullThrottle, thrustAtThrottle, thrustAtThrust, thrustTests } from "@deltarobotics/uhd";
+import type { DocContext } from "../values.ts";
+import type { TestData } from "../testdata.ts";
+
+const GEN = "@protoboardai/ext-docs lib/standins/multirotor.ts";
+const r = (x: number, d = 2) => Number(x.toFixed(d));
+
+function first(ctx: DocContext, cat: string): ModuleDef | undefined {
+  return ctx.scene.assembly.instances.find((i) => i.kind === "module" && category(i.def) === cat)?.def;
+}
+
+export function standins(ctx: DocContext): TestData[] {
+  const system = ctx.sys.system.id;
+  const motor = first(ctx, "motor");
+  const battery = first(ctx, "battery");
+  if (!motor || !battery) return [];
+  const motorCount = ctx.scene.assembly.instances.filter((i) => i.kind === "module" && category(i.def) === "motor").length;
+  const test = thrustTests(motor)[0];
+  if (!test) return [];
+  const bOut = battery.interfaces.find((i) => i.parameters?.some((p) => p.id === "capacity"))!;
+  const bp = (id: string) => bOut.parameters!.find((p) => p.id === id)!.value as number;
+  const V = bp("voltage");
+  const cap = bp("capacity");
+  const cells = bp("cell_count");
+  const bq = (id: string) => `def:${battery.id}:interfaces[id=${bOut.id}].parameters[id=${id}].value`;
+  const tq = (k: string) => `def:${motor.id}:traits[type=performance].params.thrust_tests[0].${k}`;
+
+  // everything propulsive comes from the maker's rows, interpolated linearly between them
+  const top = fullThrottle(test);
+  const Tfull = top.thrust_g;
+  const Ifull = top.current_A;
+  const at = (throttlePct: number) => thrustAtThrottle(test, throttlePct);
+  /** Pack current for all motors producing `thrustG` each: table power at that thrust over the pack's nominal voltage. */
+  const packCurrentFor = (thrustG: number) => {
+    const row = thrustAtThrust(test, thrustG);
+    return row ? (motorCount * row.power_W) / V : undefined;
+  };
+  const currentAt = (t: number) => at(t * 100).current_A;
+
+  // avionics: O4 minimum supply power from the model; GNSS supply current; FC + RX assumed
+  const o4 = first(ctx, "video");
+  const o4W = (o4?.interfaces.find((i) => i.id === "vcc")?.parameters?.find((p) => p.id === "min_supply_power")?.value as number) ?? 0;
+  const gnss = first(ctx, "gnss");
+  const gnssmA = (gnss?.domains?.find((d) => d.domain === "electrical")?.metadata as any)?.supply_current_mA ?? 0;
+  const FC_RX_W = 2.5; // assumption: FC + receiver draw, not in the model
+  const BEC_EFF = 0.85; // assumption
+  const avionicsW = (o4W + (gnssmA / 1000) * 5 + FC_RX_W) / BEC_EFF;
+  const avionicsA = avionicsW / V;
+
+  // mass: systemMass (stated weights, else CAD volume × material density), plus an
+  // assumed allowance for the parts the model has no mass for (cables, capacitor)
+  const sm = modelMass(ctx);
+  const known = sm.totalG;
+  const missing = sm.missing;
+  const UNKNOWN_ALLOWANCE_G = 20; // assumption: leads, cables and capacitor with no mass in the model
+  const auw = known + UNKNOWN_ALLOWANCE_G;
+
+  // hover: the table's electrical power at thrust = AUW / motors (interpolated between rows)
+  const hoverT = auw / motorCount;
+  const hoverIprop = packCurrentFor(hoverT) ?? motorCount * Ifull;
+  const hoverI = hoverIprop + avionicsA;
+  const USABLE = 0.8; // assumption: usable fraction of rated capacity
+  const minutes = (I: number) => ((cap / 1000) * USABLE * 60) / I;
+
+  const base = {
+    $schema: "uhd-test-data/1",
+    status: "standin" as const,
+    subject: { system, modules: [motor.id, battery.id] },
+  };
+  const derivedFrom = [tq("rows"), tq("propeller"), tq("supply_V"), bq("voltage"), bq("capacity")];
+  const assumptions = [
+    `motor figures interpolate linearly between the ${test.rows.length} rows of the maker's table (0 at 0 % throttle); pack current = table electrical power ÷ ${V} V nominal`,
+    `maker's table used the ${test.propeller} prop at ${test.supply_V} V, not the fitted propeller`,
+    `avionics: DJI O4 minimum supply power ${o4W} W, GNSS ${gnssmA} mA at 5 V, FC + receiver ${FC_RX_W} W (assumed), BEC efficiency ${BEC_EFF * 100} % (assumed)`,
+    `all-up weight = ${r(known, 1)} g from systemMass (derived:mass.all_up, of which ${r(sm.assumedG, 1)} g is CAD volume × assumed material) + ${UNKNOWN_ALLOWANCE_G} g assumed for the ${missing.length} parts with no mass in the model (${missing.map((e) => e.def.name).join(", ")})`,
+  ];
+  const generatedAt = new Date().toISOString().slice(0, 10);
+
+  // 1 throttle sweep (static)
+  const sweep: TestData = {
+    ...base,
+    id: "throttle-sweep",
+    title: "Static thrust and current vs throttle (whole vehicle)",
+    conditions: [
+      { name: "Supply", value: test.supply_V, unit: "V" },
+      { name: "Propeller (maker's test)", value: test.propeller, unit: "" },
+      { name: "Motors", value: motorCount, unit: "" },
+    ],
+    provenance: { method: "Stand-in: the motor maker's thrust table row by row, scaled to all motors, plus avionics draw.", derivedFrom, assumptions, generator: GEN, generatedAt },
+    columns: [
+      { id: "throttle", label: "Throttle", unit: "%" },
+      { id: "thrust_motor", label: "Thrust per motor", unit: "g" },
+      { id: "current_motor", label: "Current per motor", unit: "A" },
+      { id: "thrust_total", label: "Total thrust", unit: "g" },
+      { id: "current_total", label: "Total current", unit: "A" },
+      { id: "power_total", label: "Electrical power", unit: "W" },
+    ],
+    rows: Array.from({ length: 11 }, (_, i) => {
+      const t = i / 10;
+      const Tm = at(t * 100).thrust_g;
+      const Im = currentAt(t);
+      const It = motorCount * Im + avionicsA;
+      return [i * 10, r(Tm, 0), r(Im, 2), r(motorCount * Tm, 0), r(It, 1), r(It * test.supply_V, 0)];
+    }),
+    summary: [
+      { id: "thrust_total_full", label: "Total static thrust at 100 %", value: r(motorCount * Tfull, 0), unit: "g" },
+      { id: "current_total_full", label: "Total current at 100 %", value: r(motorCount * Ifull + avionicsA, 1), unit: "A" },
+    ],
+  };
+
+  // 2 hover current
+  const hover: TestData = {
+    ...base,
+    id: "hover-current",
+    title: "Hover current and all-up-weight sensitivity",
+    conditions: [
+      { name: "Battery nominal", value: V, unit: "V" },
+      { name: "All-up weight (estimate)", value: r(auw, 0), unit: "g" },
+    ],
+    provenance: { method: "Stand-in: hover thrust = AUW / motors; motor power interpolated from the maker's thrust table at that thrust; plus avionics.", derivedFrom: [...derivedFrom, "derived:mass.all_up"], assumptions, generator: GEN, generatedAt },
+    columns: [
+      { id: "auw", label: "All-up weight", unit: "g" },
+      { id: "thrust_motor", label: "Hover thrust per motor", unit: "g" },
+      { id: "current_total", label: "Hover current", unit: "A" },
+      { id: "power_total", label: "Hover power", unit: "W" },
+    ],
+    rows: [-100, -50, 0, 50, 100, 150].map((d) => {
+      const w = auw + d;
+      const I = (packCurrentFor(w / motorCount) ?? motorCount * Ifull) + avionicsA;
+      return [r(w, 0), r(w / motorCount, 0), r(I, 2), r(I * V, 0)];
+    }),
+    summary: [
+      { id: "auw_g", label: "All-up weight (estimate)", value: r(auw, 0), unit: "g" },
+      { id: "hover_current_A", label: "Hover current", value: r(hoverI, 1), unit: "A" },
+      { id: "hover_power_W", label: "Hover power", value: r(hoverI * V, 0), unit: "W" },
+      { id: "avionics_current_A", label: "Avionics current", value: r(avionicsA, 2), unit: "A" },
+    ],
+  };
+
+  // 3 flight time
+  const regimes: [string, number][] = [
+    ["Hover", hoverI],
+    ["Cruise (1.5 × hover thrust)", (packCurrentFor(1.5 * hoverT) ?? motorCount * Ifull) + avionicsA],
+    ["Freestyle mix", 0],
+    ["Full throttle", motorCount * Ifull + avionicsA],
+  ];
+  const mix = 0.75 * regimes[1][1] + 0.2 * (motorCount * at(50).current_A + avionicsA) + 0.05 * regimes[3][1];
+  regimes[2][1] = mix;
+  const flight: TestData = {
+    ...base,
+    id: "flight-time",
+    title: "Flight-time estimate by regime",
+    conditions: [
+      { name: "Capacity", value: cap, unit: "mAh" },
+      { name: "Usable fraction (assumed)", value: USABLE * 100, unit: "%" },
+      { name: "Freestyle mix", value: "75 % cruise, 20 % half throttle, 5 % full", unit: "" },
+    ],
+    provenance: { method: "Stand-in: time = capacity × usable fraction ÷ average current. Static-thrust currents: pessimistic for forward flight.", derivedFrom: [...derivedFrom, "test:hover-current:summary[id=hover_current_A].value"], assumptions: [...assumptions, `usable capacity ${USABLE * 100} % of rated`], generator: GEN, generatedAt },
+    columns: [
+      { id: "regime", label: "Regime", unit: "" },
+      { id: "current", label: "Average current", unit: "A" },
+      { id: "minutes", label: "Flight time", unit: "min" },
+    ],
+    rows: regimes.map(([n, I]) => [n, r(I, 1), r(minutes(I), 1)]),
+    summary: [
+      { id: "hover_min", label: "Hover", value: r(minutes(hoverI), 1), unit: "min" },
+      { id: "mix_min", label: "Freestyle mix", value: r(minutes(mix), 1), unit: "min" },
+    ],
+  };
+
+  // 4 thrust-to-weight
+  const volts = [cells * 4.2, V, cells * 3.5];
+  const twr: TestData = {
+    ...base,
+    id: "thrust-to-weight",
+    title: "Thrust-to-weight ratio vs pack voltage",
+    conditions: [
+      { name: "All-up weight (estimate)", value: r(auw, 0), unit: "g" },
+      { name: "Reference supply (maker's test)", value: test.supply_V, unit: "V" },
+    ],
+    provenance: { method: "Stand-in: static thrust scaled with (V / test V)² (thrust ~ rpm², rpm ~ V), divided by the AUW estimate.", derivedFrom: [...derivedFrom, "derived:mass.all_up"], assumptions, generator: GEN, generatedAt },
+    columns: [
+      { id: "voltage", label: "Pack voltage", unit: "V" },
+      { id: "thrust_total", label: "Total static thrust", unit: "g" },
+      { id: "twr", label: "Thrust-to-weight", unit: "" },
+    ],
+    rows: volts.map((v) => {
+      const T = motorCount * Tfull * (v / test.supply_V) ** 2;
+      return [r(v, 1), r(T, 0), r(T / auw, 1)];
+    }),
+    summary: [{ id: "twr_nominal", label: "Thrust-to-weight at nominal voltage", value: r((motorCount * Tfull * (V / test.supply_V) ** 2) / auw, 1), unit: "" }],
+  };
+
+  // 5 ESC temperature over a punch-out
+  const AMB = 25, RTH = 2.0, CTH = 20, RLOSS = 0.004, SW = 1.5; // assumptions
+  const esc = first(ctx, "esc");
+  const temps: (number | string)[][] = [];
+  let T = AMB + 8;
+  const thrOf = (s: number) => (s >= 2 && s < 6 ? 1 : 0.35);
+  for (let s = 0; s <= 30; s += 0.5) {
+    const th = thrOf(s);
+    const Ich = currentAt(th);
+    const P = motorCount * (Ich ** 2 * RLOSS + SW * th);
+    if (s > 0) T += ((P - (T - AMB) / RTH) / CTH) * 0.5;
+    temps.push([s, th * 100, r(Ich, 1), r(T, 1)]);
+  }
+  const peak = Math.max(...temps.map((x) => Number(x[3])));
+  const escTemp: TestData = {
+    ...base,
+    id: "esc-temp-punchout",
+    title: "ESC board temperature over a 4 s punch-out",
+    subject: { system, modules: [esc?.id ?? "esc", motor.id] },
+    conditions: [
+      { name: "Ambient", value: AMB, unit: "°C" },
+      { name: "Punch-out", value: "100 % from 2 s to 6 s, 35 % otherwise", unit: "" },
+    ],
+    provenance: {
+      method: "Stand-in: lumped thermal model C·dT/dt = P − (T − ambient)/R with conduction and switching losses per channel.",
+      derivedFrom: [tq("rows"), ...(esc ? [`def:${esc.id}:interfaces[id=motor_1].parameters[id=max_current].value`] : [])],
+      assumptions: [
+        `thermal resistance ${RTH} K/W and capacity ${CTH} J/K (board in prop wash) — not in the model`,
+        `effective conduction resistance ${RLOSS * 1000} mΩ per channel and ${SW} W switching loss per channel at full throttle — not in the model`,
+        "starting 8 °C above ambient after the previous flight segment",
+      ],
+      generator: GEN,
+      generatedAt,
+    },
+    columns: [
+      { id: "time", label: "Time", unit: "s" },
+      { id: "throttle", label: "Throttle", unit: "%" },
+      { id: "current_channel", label: "Current per channel", unit: "A" },
+      { id: "temperature", label: "ESC temperature", unit: "°C" },
+    ],
+    rows: temps,
+    summary: [{ id: "peak_C", label: "Peak temperature", value: r(peak, 1), unit: "°C" }],
+  };
+
+  // 6 battery discharge
+  const OCV = [4.2, 4.08, 3.98, 3.9, 3.84, 3.8, 3.77, 3.74, 3.7, 3.62, 3.45]; // generic LiPo curve (assumption)
+  const RCELL = 0.004; // assumption
+  const dis: TestData = {
+    ...base,
+    id: "battery-discharge",
+    title: "Pack voltage vs capacity used",
+    subject: { system, modules: [battery.id] },
+    conditions: [
+      { name: "Cells", value: cells, unit: "" },
+      { name: "Hover current (stand-in)", value: r(hoverI, 1), unit: "A" },
+      { name: "Freestyle average (stand-in)", value: r(mix, 1), unit: "A" },
+    ],
+    provenance: {
+      method: "Stand-in: generic LiPo open-circuit curve per cell minus I·R sag, scaled to the pack.",
+      derivedFrom: [bq("cell_count"), bq("capacity"), "test:hover-current:summary[id=hover_current_A].value"],
+      assumptions: ["generic LiPo open-circuit voltage curve", `internal resistance ${RCELL * 1000} mΩ per cell — not in the model`],
+      generator: GEN,
+      generatedAt,
+    },
+    columns: [
+      { id: "used", label: "Capacity used", unit: "mAh" },
+      { id: "v_rest", label: "Open circuit", unit: "V" },
+      { id: "v_hover", label: "At hover current", unit: "V" },
+      { id: "v_mix", label: "At freestyle average", unit: "V" },
+    ],
+    rows: OCV.map((v, i) => [r((cap * i) / 10, 0), r(v * cells, 2), r((v - hoverI * RCELL) * cells, 2), r((v - mix * RCELL) * cells, 2)]),
+    summary: [{ id: "sag_mix_V", label: "Sag at freestyle average", value: r(mix * RCELL * cells, 2), unit: "V" }],
+  };
+
+  return [sweep, hover, flight, twr, escTemp, dis];
+}

package/lib/templates/doc.css

@@ -0,0 +1,247 @@
+/* uhd-tech-docs print theme — light pages, Protoboard type and accent.
+   Rules: skills/uhd-tech-docs/references/style-study.md ("Rules we adopt"). */
+@font-face { font-family: "Kode Mono"; src: url("__FONTS__/KodeMono-Regular.ttf") format("truetype"); font-weight: 400; }
+@font-face { font-family: "Kode Mono"; src: url("__FONTS__/KodeMono-Medium.ttf") format("truetype"); font-weight: 500; }
+@font-face { font-family: "Kode Mono"; src: url("__FONTS__/KodeMono-SemiBold.ttf") format("truetype"); font-weight: 600; }
+@font-face { font-family: "Kode Mono"; src: url("__FONTS__/KodeMono-Bold.ttf") format("truetype"); font-weight: 700; }
+/* display text: the Bold file under every weight, so it is bold whatever weight a rule asks for */
+@font-face { font-family: "Kode Mono Bold"; src: url("__FONTS__/KodeMono-Bold.ttf") format("truetype"); font-weight: 100 900; }
+
+:root {
+  --ink: #1b1b1b;
+  --muted: #6f6f6f;
+  --faint: #a3a3a3;
+  --rule: #d6d6d6;
+  --tint: #f3f3f3;
+  --accent: #ff5c00;         /* oklch(0.6837 0.2120 40.59) */
+  --accent-ink: #d94e00;     /* accent for small text on white */
+  --accent-tint: #fff1e8;
+  --danger: #c62828;
+  --dark: #111111;
+  --mono: "Kode Mono", "JetBrains Mono", "DejaVu Sans Mono", monospace;
+  --display: "Kode Mono Bold", "Kode Mono", monospace;
+}
+@page { size: A4; margin: 0; }
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; background: #e9e9e9; }
+body { font-family: var(--mono); font-size: 7.6pt; line-height: 1.5; color: var(--ink); -webkit-print-color-adjust: exact; print-color-adjust: exact; font-variant-numeric: tabular-nums; }
+#pages { display: flex; flex-direction: column; align-items: center; gap: 8mm; padding: 8mm 0; }
+#flow { width: 178mm; }
+
+/* ---- page frame ---------------------------------------------------------- */
+.page { width: 210mm; height: 297mm; position: relative; overflow: hidden; background: #fff; box-shadow: 0 1px 6px rgba(0,0,0,.18); break-after: page; }
+.pg-head { position: absolute; top: 9mm; left: 16mm; right: 16mm; height: 6mm; display: flex; align-items: baseline; gap: 3mm; border-bottom: 0.5pt solid var(--ink); font-size: 6.4pt; letter-spacing: .04em; text-transform: uppercase; }
+.pg-mark { width: 2.2mm; height: 2.2mm; background: var(--accent); align-self: center; flex: none; }
+.pg-title { font-family: var(--display); font-size: 7.6pt; letter-spacing: .02em; }
+.pg-type { color: var(--muted); }
+.pg-id { margin-left: auto; color: var(--muted); }
+.pg-body { position: absolute; top: 20mm; left: 16mm; right: 16mm; bottom: 17mm; overflow: hidden; }
+.pg-foot { position: absolute; bottom: 8mm; left: 16mm; right: 16mm; display: flex; align-items: baseline; gap: 4mm; border-top: 0.35pt solid var(--rule); padding-top: 1.6mm; font-size: 6.4pt; color: var(--muted); letter-spacing: .03em; }
+.pg-brand { font-family: var(--display); color: var(--ink); letter-spacing: .06em; }
+.pg-brand b { color: var(--accent); font-weight: 400; }
+.pg-num { margin-left: auto; color: var(--ink); font-weight: 600; }
+.page.overflow { outline: 2mm solid red; }
+
+/* ---- cover ---------------------------------------------------------------- */
+.page.cover .pg-head, .page.cover .pg-foot { display: none; }
+.page.cover .pg-body { top: 0; left: 0; right: 0; bottom: 0; }
+.cover-top { position: absolute; inset: 0 0 auto 0; height: 178mm; background: var(--dark); color: #fff; overflow: hidden; }
+.cover-top .grid-bg { position: absolute; inset: 0; background-image: linear-gradient(rgba(255,255,255,.045) 1px, transparent 1px), linear-gradient(90deg, rgba(255,255,255,.045) 1px, transparent 1px); background-size: 8mm 8mm; }
+.cover-brand { position: absolute; top: 13mm; left: 16mm; font-family: var(--display); font-size: 8.6pt; letter-spacing: .12em; }
+.cover-brand b { color: var(--accent); font-weight: 400; }
+.cover-doctype { position: absolute; top: 13mm; right: 16mm; font-size: 6.9pt; letter-spacing: .14em; text-transform: uppercase; color: #bdbdbd; }
+.cover-title { position: absolute; top: 27mm; left: 16mm; right: 16mm; font-family: var(--display); font-size: 25pt; line-height: 1.08; letter-spacing: .02em; }
+.cover-title .accent { color: var(--accent); }
+.cover-sub { position: absolute; top: 49mm; left: 16mm; width: 112mm; font-size: 7.6pt; line-height: 1.55; color: #cfcfcf; }
+.cover-hero { position: absolute; left: 6mm; right: 6mm; top: 64mm; bottom: 4mm; }
+.cover-hero img { width: 100%; height: 100%; object-fit: contain; }
+.cover-rev { position: absolute; top: 13mm; right: 16mm; margin-top: 6mm; display: flex; gap: 0; font-size: 6.4pt; letter-spacing: .06em; }
+.cover-rev span { border: 0.5pt solid #7a7a7a; padding: .6mm 2mm; color: #e0e0e0; }
+.cover-rev span:first-child { background: var(--accent); border-color: var(--accent); color: #111; font-weight: 700; }
+.cover-bottom { position: absolute; top: 186mm; left: 16mm; right: 16mm; bottom: 12mm; }
+.cover-foot { position: absolute; left: 16mm; right: 16mm; bottom: 9mm; display: flex; gap: 4mm; font-size: 6.4pt; color: var(--muted); border-top: 0.35pt solid var(--rule); padding-top: 1.6mm; }
+.cover-foot .pg-brand { color: var(--ink); }
+.cover-foot .right { margin-left: auto; }
+
+/* ---- headings ------------------------------------------------------------- */
+h1.sec { font-family: var(--display); font-weight: 400; font-size: 13.5pt; line-height: 1.15; letter-spacing: .02em; margin: 0 0 3.5mm; padding-bottom: 1.8mm; border-bottom: 0.5pt solid var(--ink); display: flex; align-items: baseline; gap: 3mm; }
+h1.sec .num { color: var(--accent); font-size: 8.6pt; letter-spacing: .06em; }
+h1.sec .aside { margin-left: auto; font-family: var(--mono); font-size: 6.4pt; color: var(--muted); letter-spacing: .04em; text-transform: uppercase; }
+h2.sub { font-size: 7.6pt; font-weight: 600; text-transform: uppercase; letter-spacing: .09em; margin: 5mm 0 2mm; display: flex; align-items: center; gap: 2mm; }
+h2.sub::before { content: ""; width: 1.6mm; height: 1.6mm; background: var(--accent); flex: none; }
+.pg-body > h2.sub:first-child, .pg-body > .sec + h2.sub { margin-top: 1mm; }
+p { margin: 0 0 2.2mm; }
+.prose { max-width: 128mm; }
+.lead { font-size: 8.6pt; line-height: 1.55; max-width: 150mm; margin-bottom: 4mm; }
+.muted { color: var(--muted); }
+.small { font-size: 6.4pt; }
+code, .code { font-family: var(--mono); font-size: 6.9pt; background: var(--tint); padding: 0 .6mm; }
+.gap-block { margin-bottom: 5mm; }
+
+/* ---- values and markers ---------------------------------------------------- */
+.v { white-space: nowrap; }
+.v.st-gap { color: var(--faint); }
+sup.mk { font-size: 5.5pt; font-weight: 700; color: var(--accent-ink); margin-left: .35mm; vertical-align: 2.2pt; line-height: 0; letter-spacing: 0; }
+sup.mk-gap { color: var(--faint); }
+.legend { display: flex; flex-wrap: wrap; gap: 1.2mm 5mm; font-size: 6.4pt; color: var(--muted); border-top: 0.35pt solid var(--rule); padding-top: 1.8mm; margin-top: 3mm; }
+
+/* ---- layout helpers -------------------------------------------------------- */
+.cols { display: grid; grid-template-columns: 1fr 1fr; gap: 7mm; }
+.cols-3 { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 5mm; }
+.cols-60 { display: grid; grid-template-columns: 1.45fr 1fr; gap: 7mm; }
+.block { margin-bottom: 5mm; }
+
+/* ---- key figures ------------------------------------------------------------ */
+.kpis { display: grid; grid-template-columns: repeat(4, 1fr); border-top: 0.5pt solid var(--ink); border-bottom: 0.5pt solid var(--ink); }
+.kpi { padding: 2.6mm 3mm 2.8mm 0; border-right: 0.35pt solid var(--rule); padding-left: 3mm; }
+.kpi:first-child { padding-left: 0; }
+.kpi:last-child { border-right: 0; }
+.kpi .k-label { font-size: 5.8pt; letter-spacing: .1em; text-transform: uppercase; color: var(--muted); }
+.kpi .k-value { font-family: var(--display); font-size: 15pt; line-height: 1.25; margin-top: 1mm; white-space: nowrap; }
+.kpi .k-value .v { font-family: var(--display); }
+.kpi .k-sub { font-size: 5.8pt; color: var(--muted); line-height: 1.35; margin-top: .6mm; }
+.kpis.k6 { grid-template-columns: repeat(3, 1fr); }
+.kpis.k6 .kpi:nth-child(3n+1) { padding-left: 0; }
+.kpis.k6 .kpi:nth-child(3n) { border-right: 0; }
+.kpis.k6 .kpi:nth-child(n+4) { border-top: 0.35pt solid var(--rule); }
+
+/* ---- tables ------------------------------------------------------------------ */
+table { border-collapse: collapse; width: 100%; font-size: 6.9pt; line-height: 1.38; }
+th { text-align: left; font-weight: 600; background: var(--tint); padding: 1.3mm 1.8mm; border-bottom: 0.5pt solid var(--ink); font-size: 6.4pt; letter-spacing: .05em; text-transform: uppercase; white-space: nowrap; }
+td { padding: 1.15mm 1.8mm; border-bottom: 0.25pt solid var(--rule); vertical-align: top; }
+td.num, th.num { text-align: right; }
+td.unit { color: var(--muted); white-space: nowrap; }
+td.key { white-space: nowrap; }
+td.wrap { word-break: break-word; }
+tr.group td { font-weight: 600; border-bottom: 0.5pt solid var(--ink); padding-top: 2.4mm; background: none; text-transform: uppercase; letter-spacing: .07em; font-size: 6.4pt; }
+tr.group:first-child td { padding-top: 1.3mm; }
+table.pinout td:first-child { font-weight: 600; }
+table.dense td { padding: .8mm 1.6mm; }
+.continued > .cont-note, .cont-note { display: none; }
+.continued .cont-note { display: block; font-size: 6.4pt; color: var(--muted); margin-bottom: 1mm; text-transform: uppercase; letter-spacing: .08em; }
+.fn { font-size: 6.4pt; color: var(--muted); margin-top: 1.4mm; }
+.tag { display: inline-block; font-size: 5.8pt; font-weight: 600; letter-spacing: .06em; text-transform: uppercase; padding: .1mm 1.1mm; border: 0.4pt solid var(--faint); color: var(--muted); border-radius: .6mm; white-space: nowrap; }
+.tag.ok { border-color: #2e7d32; color: #2e7d32; }
+.tag.warn { border-color: var(--accent-ink); color: var(--accent-ink); }
+.tag.err { border-color: var(--danger); color: var(--danger); }
+.tag.info { border-color: var(--faint); color: var(--muted); }
+
+/* ---- figures ------------------------------------------------------------------ */
+figure { margin: 0 0 4mm; }
+.figwrap { position: relative; width: 100%; }
+.figwrap img { display: block; width: 100%; height: auto; }
+.figwrap svg.overlay { position: absolute; inset: 0; width: 100%; height: 100%; overflow: visible; }
+figcaption, .cap { font-size: 6.4pt; color: var(--muted); margin-top: 1.6mm; display: flex; gap: 2mm; }
+figcaption b, .cap b { color: var(--ink); font-weight: 600; white-space: nowrap; }
+figcaption .unit { margin-left: auto; white-space: nowrap; }
+.chart { display: block; width: 100%; height: auto; }
+.chart text { font-family: var(--mono); }
+.chartbox { border-top: 0.35pt solid var(--rule); padding-top: 2mm; }
+.chartbox h3 { font-size: 6.9pt; font-weight: 600; margin: 0 0 1mm; letter-spacing: .03em; }
+
+/* ---- callouts (SVG) ------------------------------------------------------------ */
+.co-leader { stroke: var(--ink); fill: none; }
+.co-dot { fill: var(--ink); }
+.co-bubble { fill: #fff; stroke: var(--ink); }
+.co-bubble.acc { fill: var(--accent); stroke: var(--accent); }
+.co-num { font-family: var(--mono); font-weight: 700; fill: var(--ink); }
+.co-num.acc { fill: #fff; }
+.co-label { font-family: var(--mono); fill: var(--ink); }
+.co-label.muted { fill: var(--muted); }
+
+/* ---- admonitions ------------------------------------------------------------------ */
+.note { display: grid; grid-template-columns: 5.5mm 1fr; gap: 1.5mm; border-top: 0.35pt solid var(--rule); border-bottom: 0.35pt solid var(--rule); padding: 1.8mm 0; margin: 2mm 0; font-size: 6.9pt; }
+.note + .note { border-top: 0; margin-top: -2mm; }
+.note svg { width: 4.2mm; height: 4.2mm; margin-top: .2mm; }
+.note b { font-weight: 700; letter-spacing: .04em; }
+.note.warning b { color: var(--danger); }
+.note.caution b { color: var(--accent-ink); }
+
+/* ---- contents ------------------------------------------------------------------ */
+ol.toc { list-style: none; padding: 0; margin: 0; }
+ol.toc li { display: flex; align-items: baseline; gap: 2mm; padding: 1.1mm 0; border-bottom: 0.25pt solid var(--rule); }
+.toc-n { color: var(--accent-ink); width: 7mm; flex: none; }
+.toc-dots { flex: 1; }
+.toc-p { font-weight: 600; }
+
+/* ---- assembly steps -------------------------------------------------------------- */
+.step { border-top: 0.6pt solid var(--ink); padding-top: 2.6mm; margin-bottom: 5mm; }
+.step-head { display: flex; align-items: center; gap: 3mm; margin-bottom: 2.4mm; }
+.step-no { width: 8.5mm; height: 8.5mm; border-radius: 50%; background: var(--accent); color: #fff; font-family: var(--display); font-size: 12pt; display: flex; align-items: center; justify-content: center; flex: none; }
+.step-head h2 { font-family: var(--display); font-weight: 400; font-size: 12pt; margin: 0; letter-spacing: .02em; }
+.step-head .trace { margin-left: auto; font-size: 5.8pt; color: var(--faint); text-align: right; max-width: 60mm; line-height: 1.35; }
+.parts { display: flex; flex-wrap: wrap; gap: 2mm; margin-bottom: 2mm; }
+.part { display: grid; grid-template-columns: 11mm auto; grid-template-rows: auto auto; column-gap: 1.8mm; align-items: center; border: 0.35pt solid var(--rule); padding: 1.2mm 2.4mm 1.2mm 1.4mm; min-width: 36mm; }
+.part img { grid-row: span 2; width: 11mm; height: 11mm; object-fit: contain; }
+.part .p-name { font-size: 6.4pt; line-height: 1.25; }
+.part .p-qty { font-family: var(--display); font-size: 8.6pt; color: var(--accent-ink); line-height: 1.1; display: flex; align-items: center; gap: 1.4mm; }
+.part .p-qty .letter { font-family: var(--mono); font-weight: 700; font-size: 5.8pt; width: 3.6mm; height: 3.6mm; border-radius: 50%; border: 0.5pt solid var(--ink); color: var(--ink); display: inline-flex; align-items: center; justify-content: center; }
+.part.tool { border-style: dashed; }
+.step-body { display: grid; grid-template-columns: 1fr; gap: 2mm; }
+ol.actions { margin: 0; padding: 0; list-style: none; counter-reset: a; }
+ol.actions li { counter-increment: a; position: relative; padding: .9mm 0 .9mm 5mm; border-bottom: 0.25pt solid var(--rule); }
+ol.actions li::before { content: counter(a) "."; position: absolute; left: 0; font-weight: 700; color: var(--ink); }
+ol.actions li:last-child { border-bottom: 0; }
+.step-meta { display: flex; flex-wrap: wrap; gap: 1mm 5mm; font-size: 6.4pt; color: var(--muted); margin-top: 1.2mm; }
+.step-meta b { color: var(--ink); font-weight: 600; }
+.wiretable td { font-size: 6.4pt; }
+.x-flag { color: var(--accent-ink); font-weight: 700; }
+
+/* ---- BOM thumbnails ---------------------------------------------------------------- */
+.kit { display: grid; grid-template-columns: repeat(5, 1fr); gap: 0; border-top: 0.5pt solid var(--ink); }
+.kit-item { border-bottom: 0.35pt solid var(--rule); border-right: 0.35pt solid var(--rule); padding: 2mm 2mm 2.2mm; display: flex; flex-direction: column; gap: .8mm; min-height: 30mm; }
+.kit-item:nth-child(5n) { border-right: 0; }
+.kit-item img { width: 100%; height: 16mm; object-fit: contain; }
+.kit-item .k-name { font-size: 5.8pt; line-height: 1.3; }
+.kit-item .k-qty { font-family: var(--display); color: var(--accent-ink); font-size: 8.6pt; }
+.kit-item .k-id { font-size: 5.8pt; color: var(--faint); word-break: break-all; }
+.kit-item.noimg img { display: none; }
+.kit-item .ph { height: 16mm; display: flex; align-items: center; justify-content: center; color: var(--faint); font-size: 5.8pt; border: 0.35pt dashed var(--rule); }
+
+/* ---- additions ---------------------------------------------------------------------- */
+.v.wrap { white-space: normal; }
+.cover-kicker { position: absolute; top: 25mm; left: 16mm; font-size: 6.9pt; letter-spacing: .18em; text-transform: uppercase; color: var(--accent); font-weight: 600; }
+.cover-title { top: 31mm; }
+.cover-sub { top: 52mm; }
+.cover-hero { top: 70mm; bottom: 9mm; }
+.cover-herocap { position: absolute; right: 16mm; bottom: 4mm; font-size: 5.8pt; color: #8a8a8a; letter-spacing: .03em; }
+.cover-grid { display: grid; grid-template-columns: 1fr 1.25fr; gap: 8mm; margin-top: 5mm; }
+.cover-grid .legend { margin-top: 1mm; border-top: 0; padding-top: 0; flex-direction: column; gap: .8mm; }
+.co-inline { display: inline-flex; width: 4.2mm; height: 4.2mm; border-radius: 50%; background: var(--accent); color: #fff; font-weight: 700; font-size: 6.4pt; align-items: center; justify-content: center; }
+ul.plain, ul.tight { margin: 0 0 2mm; padding-left: 3.5mm; }
+ul.plain li, ul.tight li { margin: .4mm 0; }
+.keyrow { display: flex; align-items: center; gap: 2mm; font-size: 6.9pt; margin: .9mm 0; }
+.sw { width: 7mm; height: 3.4mm; border: 0.5pt solid; display: inline-block; flex: none; }
+.sw-ctx { background: #f5f5f5; border-color: #a8a8a8; }
+.sw-new { background: #e8eaed; border-color: #242424; }
+.sw-acc { background: #ffb584; border-color: #d24a00; }
+.sw-guide { border: 0; height: 0; border-top: 0.9pt dashed var(--accent); }
+.stackfig { border-top: 0.35pt solid var(--rule); padding-top: 1.6mm; }
+.st-title { font-size: 6.9pt; font-weight: 600; margin-bottom: 1mm; }
+.st-legend { font-size: 5.8pt; line-height: 1.4; color: var(--ink); }
+.st-legend .mm { color: var(--accent-ink); display: inline-block; min-width: 15mm; }
+.part .ph-s { grid-row: span 2; width: 11mm; height: 11mm; border: 0.35pt dashed var(--rule); }
+.part .p-qty .letter.acc { background: var(--accent); border-color: var(--accent); color: #fff; }
+.mk-inline { font-size: 5.5pt; font-weight: 700; color: var(--accent-ink); }
+code.q { font-size: 5.8pt; background: none; padding: 0; color: var(--muted); word-break: break-all; }
+.wiringfig svg { display: block; margin-bottom: 2mm; }
+table.provtable { table-layout: fixed; }
+table.provtable th:nth-child(1) { width: 20mm; } table.provtable th:nth-child(2) { width: 17mm; } table.provtable th:nth-child(3) { width: 62mm; }
+.sysdiag { display: block; margin: 1mm 0 0; }
+
+.step-top { break-inside: avoid; }
+.step-cont { margin-bottom: 1.5mm; }
+.step-end { margin-bottom: 6mm; }
+.wiretable td:nth-child(2), .wiretable td:nth-child(3) { line-height: 1.45; }
+.chartbox .cap { margin-bottom: 1mm; }
+.legend-row { display: flex; gap: 4mm; font-size: 6.4pt; color: var(--muted); margin: -0.5mm 0 1mm; }
+.legend-row i { display: inline-block; width: 5mm; height: 0; border-top: 1.2pt solid; vertical-align: middle; margin-right: 1.2mm; }
+.legend-row i.dash { border-top-style: dashed; }
+/* print: last so it wins over the screen rules above */
+@media print { html, body { background: #fff; } #pages { display: block; gap: 0; padding: 0; } .page { box-shadow: none !important; margin: 0; } }
+.accent-q { font-family: var(--display); color: var(--accent-ink); }
+.stackfig svg { display: block; }
+.hwtable td:first-child { width: 62mm; } .hwtable td:last-child { width: 16mm; white-space: nowrap; }
+.kpi .k-value .u { font-family: var(--mono); font-size: 8.6pt; letter-spacing: 0; margin-left: .4mm; }
+.cover-foot { white-space: nowrap; }
+.cover-foot > span:nth-child(2) { overflow: hidden; text-overflow: ellipsis; }