Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 159x 159x 159x 665x 665x 665x 665x 665x 665x 665x 159x 159x 1x 1x 1x 1x 1x 17x 17x 17x 7x 7x 1x 1x 1x 1x 1x 1x 1x 1x 1x 12x 17x 17x 15x 12x 1x 17x 17x 17x 17x 17x 17x 17x 17x 12x 12x 12x | // Abacus Studio — the filament catalog (Gitea epic #5, Phase 1 #7 → quantization).
//
// The catalog is the SECOND boundary's fixed input: the spools the printer can
// actually lay down. It's deliberately NOT the whole filament library — it's the
// loaded-AMS reality (per the studio decision: "swatches come from THH active and
// available filament"). `materialize` (abacus-plan.ts) quantizes the design's
// intrinsic colors onto exactly these spools; nothing outside the catalog is
// printable.
//
// Two sources feed it:
// • 'thh-ams' — the live THH AMS snapshot (spools carry a real `material`,
// so material-family adhesion checks can run — see #357). The
// THH client that produces this lands in a later phase (P3).
// • 'manual-params'— the offline fallback: the `filament_1..count` hexes on the
// params surface, color-only (material defaults to PLA, so the
// material-interface check stays inert until THH supplies real
// families). This is the "THH-only" decision made literal —
// manual mode never fabricates material data it doesn't have.
//
// Framework-free (no React, no three): a plain projection over `Params`.
import type { ThhFilamentRow } from '@/lib/abacus/print/filament-wire'
import type { Params } from './abacus-model'
// The Bambu material families that matter for interface adhesion (PLA↔PETG↔TPU
// bond poorly). Open string tail keeps THH free to report families we don't
// enumerate yet without a type break.
export type FilamentMaterial = 'PLA' | 'PETG' | 'TPU' | 'ABS' | 'ASA' | (string & {})
export type FilamentSpool = {
id: string // stable within a catalog; the plan references spools by this
name: string
hex: string
material: FilamentMaterial
}
export type FilamentCatalog = {
source: 'thh-ams' | 'manual-params'
spools: FilamentSpool[]
// Present for 'thh-ams' snapshots (an ISO timestamp); absent for params-derived
// catalogs, which have no fetch moment.
fetchedAt?: string
}
// The offline catalog: the up-to-8 loaded slots from the params surface, in
// filament_1..count order (clamped to [1,8], matching the historical filament
// map). Color-only — every spool defaults to PLA because the params carry no
// material data; real families arrive only via the THH AMS source.
export function catalogFromParams(p: Params): FilamentCatalog {
const count = Math.max(1, Math.min(8, p.filament_count))
const spools: FilamentSpool[] = []
for (let n = 1; n <= count; n++) {
spools.push({
id: `filament-${n}`,
name: `Filament ${n}`,
hex: p[`filament_${n}` as 'filament_1'],
material: 'PLA',
})
}
return { source: 'manual-params', spools }
}
// Normalize THH's 8-digit RGBA hex (no '#', e.g. "A0A0A0FF") to the catalog's
// "#RRGGBB". Tolerates a leading '#' and an already-6-digit value; falls back to
// a neutral grey when the field is missing or malformed, so a spool still gets a
// renderable swatch rather than breaking the color math.
function normalizeThhHex(raw: string | undefined): string {
const hex = (raw ?? '').replace(/^#/, '')
if (!/^[0-9a-fA-F]{6,8}$/.test(hex)) return '#808080'
return `#${hex.slice(0, 6).toUpperCase()}`
}
// Project the proxy's filaments read onto the studio's FilamentCatalog. Spools
// keep the AMS order THH reports (slot 0.1, 0.2, …) — the order the picker shows.
// This is the 'thh-ams' source: spools carry a real `material` family, so once
// the design has mixed materials the material-interface checks (P4) come alive;
// today the studio just gets true colors + names instead of the params stand-in.
// `fetchedAt` stamps the snapshot for cache/debugging. Rows are loaded AMS
// slots only — the read never returns external (no-slot) spools.
export function thhFilamentsToCatalog(rows: ThhFilamentRow[], fetchedAt: string): FilamentCatalog {
const spools: FilamentSpool[] = rows.map((row, i) => {
const name =
[row.brand, row.product].filter(Boolean).join(' ').trim() ||
row.family ||
row.slotId ||
`Slot ${i + 1}`
return {
// slotId is how a print ticket references the spool; the positional
// fallback only guards against a degenerate row within this snapshot.
id: row.slotId ?? `slot-${i}`,
name,
hex: normalizeThhHex(row.colorHex),
material: (row.family as FilamentMaterial) || 'PLA',
}
})
return { source: 'thh-ams', spools, fetchedAt }
}
|