Accept an explicit model on assembly.cable

docs/assembly-cable.md

@@ -33,3 +33,14 @@ are inferred; there are no corresponding props or aliases.
 This is an additive props API and requires no migration. The schema validates
 the inputs; endpoint resolution, routing, and rendering require support in core
 and the CAD renderer.
+
+## Explicit cable models
+
+Set `model` to use a cable specification instead of inferring it from the endpoints.
+
+```tsx
+<assembly.cable name="C1" from=".J1" to=".J2"
+  model="adaptercable_a(jst_sh_pins4)_b(jst_ph_pins4)" />
+```
+
+`standard` retains its existing meaning. Omitting `model` preserves endpoint inference.

generated/PROPS_OVERVIEW.md

@@ -164,6 +164,8 @@ export interface AssemblyCableProps {
   to: string
   /** Optional USB-C-to-USB-C preset. Omit to infer the cable from its endpoints. */
   standard?: AssemblyCableStandard
+  /** Explicit cable model specification. Omit to infer the cable from its endpoints. */
+  model?: string
 }
 
 

lib/assembly/cable.ts

@@ -12,13 +12,16 @@ export interface AssemblyCableProps {
   to: string
   /** Optional USB-C-to-USB-C preset. Omit to infer the cable from its endpoints. */
   standard?: AssemblyCableStandard
+  /** Explicit cable model specification. Omit to infer the cable from its endpoints. */
+  model?: string
 }
 
 export const assemblyCableProps = z.object({
   name: z.string().trim().min(1),
   from: z.string().trim().min(1),
   to: z.string().trim().min(1),
   standard: z.literal("usb_c").optional(),
+  model: z.string().trim().min(1).optional(),
 })
 
 export type AssemblyCablePropsInput = z.input<typeof assemblyCableProps>

tests/assembly-cable.test.ts

@@ -53,3 +53,17 @@ test("assembly.cable requires an identity and two nonempty endpoint strings", ()
     )
   }
 })
+
+test("assembly.cable accepts an explicit model without changing standard behavior", () => {
+  const input = {
+    name: "C1",
+    from: ".J1",
+    to: ".J2",
+    model: "adaptercable_a(jst_sh_pins4)_b(jst_ph_pins4)",
+  }
+  expect(assemblyCableProps.parse(input)).toEqual(input)
+  for (const model of ["", " ", 4, null])
+    expect(assemblyCableProps.safeParse({ ...input, model }).success).toBe(
+      false,
+    )
+})