diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7b22f8c..535928d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -70,7 +70,7 @@ The installed skill does not depend on the website. These paths are relative to `BlueprintDrawing` opts into shared roles with `roles`. The independent highlight-opacity token is used by TIM-01, TIM-03, and TIM-05 without changing their stroke-role adoption. The SVG-to-JSX builder preserves supported root styles, removes standalone fixed ink and the root font family so the gallery inherits its theme and loaded font, and gives repeated definitions local IDs. Font weight, optical sizing, and GEOM settings remain authored. Standalone SVGs retain their own font stack. -Catalogue codes are a three-letter family prefix (`familyPrefix` in `components/plotter/study-types.ts`) and a number, without gaps within a family. A new drawing takes the next number in its family; a retired drawing keeps its code reserved in `retiredStudies`. Keep study IDs stable and keep removed studies out of active metadata. +Catalogue codes are a three-letter family prefix (`familyPrefix` in `components/plotter/study-types.ts`) and a number, without gaps within a family. A new drawing takes the next number in its family; a retired drawing keeps its code reserved in `retiredStudies`. Keep study IDs stable and keep removed studies out of active metadata. COS-01 and COS-02 retain their published codes within Services and Systems; the catalogue check explicitly allows those two legacy codes. MEC-05’s static and animated core faces share a hatch component; its carrier frames remain unhatched. Timeline edits preserve the chosen still unless redesign is requested. Grammar isolation keeps focused marks at their original appearance, and supplemental grid segments restore only portions hidden with a form. diff --git a/app/illustrations/page.tsx b/app/illustrations/page.tsx index 989db3d..7f7a8ca 100644 --- a/app/illustrations/page.tsx +++ b/app/illustrations/page.tsx @@ -1,6 +1,5 @@ import type { Metadata } from "next"; import { Suspense } from "react"; -import { CossConcepts } from "@/components/plotter/coss-concepts"; import { IllustrationGallery } from "@/components/plotter/illustration-gallery"; import { illustrations, @@ -64,7 +63,6 @@ export default function IllustrationsPage() { /> - ); } diff --git a/components/plotter/coss-concepts/common-interface-study.tsx b/components/plotter/common-interface-study.tsx similarity index 99% rename from components/plotter/coss-concepts/common-interface-study.tsx rename to components/plotter/common-interface-study.tsx index 1e368ad..480899f 100644 --- a/components/plotter/coss-concepts/common-interface-study.tsx +++ b/components/plotter/common-interface-study.tsx @@ -1,4 +1,4 @@ -import { BlueprintDrawing } from "../blueprint-drawing"; +import { BlueprintDrawing } from "./blueprint-drawing"; // Conceptual assembly, not a physical part or infrastructure diagram. // Four outer profiles stand for the catalog services. Their common circular diff --git a/components/plotter/coss-concepts/index.tsx b/components/plotter/coss-concepts/index.tsx deleted file mode 100644 index 42c6917..0000000 --- a/components/plotter/coss-concepts/index.tsx +++ /dev/null @@ -1,48 +0,0 @@ -import { DrawingFigure, SheetBar } from "@/components/sheet"; -import { CommonInterfaceStudy } from "./common-interface-study"; -import { SharedSystemStudy } from "./shared-system-study"; - -export const concepts = [ - { - code: "COS-01", - title: "One interface, many services", - description: - "Different parts, one shared opening. Email, SMS, video, and scheduling meet a common SDK contract.", - Drawing: CommonInterfaceStudy, - }, - { - code: "COS-02", - title: "A common boundary", - description: - "Two complementary profiles form one system. A construction study of the interface between an app and coss.", - Drawing: SharedSystemStudy, - }, -] as const; - -export function CossConcepts() { - return ( -
- -
- {concepts.map(({ code, title, description, Drawing }) => ( - - - - ))} -
-
- ); -} diff --git a/components/plotter/illustrations.tsx b/components/plotter/illustrations.tsx index ad5a9d6..f9b49b5 100644 --- a/components/plotter/illustrations.tsx +++ b/components/plotter/illustrations.tsx @@ -15,6 +15,7 @@ import { OriginalParticlesBlueprint } from "./original-particles-blueprint"; import { popularServiceStudies } from "./popular-service-studies"; import { PrimitivesBlueprint } from "./primitives-blueprint"; import { serviceStudies } from "./service-studies"; +import { sharedInterfaceStudies } from "./shared-interface-studies"; import { stateStudies } from "./state-studies"; import type { IllustrationStudy } from "./study-types"; import { systemStateStudies } from "./system-state-studies"; @@ -40,6 +41,7 @@ const collection: IllustrationStudy[] = [ illustration: , }, ...systemStudies, + ...sharedInterfaceStudies, ...flatCalStudies, ...interfaceDetailStudies, ...flatSystemStudies, diff --git a/components/plotter/plotter-intro.tsx b/components/plotter/plotter-intro.tsx index e46b5a0..a248a7c 100644 --- a/components/plotter/plotter-intro.tsx +++ b/components/plotter/plotter-intro.tsx @@ -42,12 +42,6 @@ export function PlotterIntro() { > Customization - - coss.com concepts - ); diff --git a/components/plotter/shared-interface-studies.tsx b/components/plotter/shared-interface-studies.tsx new file mode 100644 index 0000000..88bca22 --- /dev/null +++ b/components/plotter/shared-interface-studies.tsx @@ -0,0 +1,24 @@ +import { CommonInterfaceStudy } from "./common-interface-study"; +import { SharedSystemStudy } from "./shared-system-study"; +import type { IllustrationStudy } from "./study-types"; + +export const sharedInterfaceStudies: IllustrationStudy[] = [ + { + id: "service-common-interface", + code: "COS-01", + title: "One interface, many services", + description: + "Different parts, one shared opening. Email, SMS, video, and scheduling meet a common SDK contract.", + category: "Services", + illustration: , + }, + { + id: "system-common-boundary", + code: "COS-02", + title: "A common boundary", + description: + "Two complementary profiles form one system. A construction study of the interface between an app and coss.", + category: "Systems", + illustration: , + }, +]; diff --git a/components/plotter/coss-concepts/shared-system-study.tsx b/components/plotter/shared-system-study.tsx similarity index 98% rename from components/plotter/coss-concepts/shared-system-study.tsx rename to components/plotter/shared-system-study.tsx index 2bb2d58..0637947 100644 --- a/components/plotter/coss-concepts/shared-system-study.tsx +++ b/components/plotter/shared-system-study.tsx @@ -1,4 +1,4 @@ -import { BlueprintDrawing } from "../blueprint-drawing"; +import { BlueprintDrawing } from "./blueprint-drawing"; const unit = 60; const frame = { left: 160, top: 88, size: 4 * unit }; diff --git a/components/plotter/study-types.ts b/components/plotter/study-types.ts index 7d85280..a5e778a 100644 --- a/components/plotter/study-types.ts +++ b/components/plotter/study-types.ts @@ -2,6 +2,7 @@ import type { ReactNode } from "react"; // One family per code prefix: GEO, TYP, INT, TIM, SYS, SRV, AGT, EMP, OBJ, MEC, // CRF, NAT. Codes are numbered without gaps within each family. +// COS-01 and COS-02 retain their original codes in Services and Systems. export type StudyCategory = | "Geometry" | "Typography" diff --git a/public/plotter/downloads/plotter.zip b/public/plotter/downloads/plotter.zip index 334f912..f34ba43 100644 Binary files a/public/plotter/downloads/plotter.zip and b/public/plotter/downloads/plotter.zip differ diff --git a/scripts/build-plotter-catalogue.tsx b/scripts/build-plotter-catalogue.tsx index 53541ed..a24bcac 100644 --- a/scripts/build-plotter-catalogue.tsx +++ b/scripts/build-plotter-catalogue.tsx @@ -10,9 +10,7 @@ import { } from "node:fs"; import { tmpdir } from "node:os"; import { resolve } from "node:path"; -import { createElement } from "react"; import { renderToStaticMarkup } from "react-dom/server"; -import { concepts } from "../components/plotter/coss-concepts"; import { illustrations } from "../components/plotter/illustrations"; import { familyPrefix, @@ -41,22 +39,13 @@ type Entry = { markup: string; }; -const entries: Entry[] = [ - ...illustrations.map((item) => ({ - code: item.code, - title: item.title, - description: item.description, - family: item.category, - markup: standalone(renderToStaticMarkup(item.illustration)), - })), - ...concepts.map((concept) => ({ - code: concept.code, - title: concept.title, - description: concept.description, - family: "coss.com concepts", - markup: standalone(renderToStaticMarkup(createElement(concept.Drawing))), - })), -]; +const entries: Entry[] = illustrations.map((item) => ({ + code: item.code, + title: item.title, + description: item.description, + family: item.category, + markup: standalone(renderToStaticMarkup(item.illustration)), +})); mkdirSync(destination, { recursive: true }); for (const file of readdirSync(destination)) { @@ -90,15 +79,12 @@ try { rmSync(temporary, { recursive: true, force: true }); } -const families = [ - ...(Object.keys(familyPrefix) as StudyCategory[]), - "coss.com concepts", -]; +const families = Object.keys(familyPrefix) as StudyCategory[]; const sections = families .map((family) => { const rows = entries.filter((entry) => entry.family === family); if (!rows.length) return ""; - const prefix = rows[0]?.code.slice(0, 3); + const prefix = familyPrefix[family]; return [ `## ${family} (${prefix})`, "", @@ -122,7 +108,7 @@ writeFileSync( Every drawing in the Plotter catalogue, exported as a resolved static SVG at its native 560 × 440. Codes match the website. When a brief names a code (“like TIM-06”), open that file and borrow its construction relationship, not its subject. -Codes are a three-letter family prefix and a number, without gaps within a family. Drawings retired as near-duplicates keep their codes reserved and are not exported here. The [approved references](../approved-references.md) remain the style anchors; a catalogue drawing is an example, not a new reference selection. +Codes are a three-letter family prefix and a number, without gaps within a family. COS-01 and COS-02 retain their original codes within Services and Systems. Drawings retired as near-duplicates keep their codes reserved and are not exported here. The [approved references](../approved-references.md) remain the style anchors; a catalogue drawing is an example, not a new reference selection. ${sections}`, ); diff --git a/scripts/check-plotter.tsx b/scripts/check-plotter.tsx index 472887d..00d97ff 100644 --- a/scripts/check-plotter.tsx +++ b/scripts/check-plotter.tsx @@ -5,7 +5,6 @@ import { readdirSync, readFileSync, statSync } from "node:fs"; import { dirname, resolve } from "node:path"; import { YAML } from "bun"; import { renderToStaticMarkup } from "react-dom/server"; -import { concepts } from "../components/plotter/coss-concepts"; import { illustrations } from "../components/plotter/illustrations"; import { familyPrefix } from "../components/plotter/study-types"; @@ -74,13 +73,12 @@ for (const study of illustrations) { // Every coded drawing is bundled in the skill, so a brief can cite it. const catalogueRoot = resolve(skillRoot, "references/catalogue"); const catalogueIndex = readFileSync(resolve(catalogueRoot, "index.md"), "utf8"); -const coded = [ - ...illustrations.map((study) => ({ - code: study.code, - prefix: familyPrefix[study.category], - })), - ...concepts.map((concept) => ({ code: concept.code, prefix: "COS" })), -]; +// These studies joined the main collection without changing their published codes. +const legacyCodes = new Set(["COS-01", "COS-02"]); +const coded = illustrations.map((study) => ({ + code: study.code, + prefix: legacyCodes.has(study.code) ? "COS" : familyPrefix[study.category], +})); const numbers = new Map(); for (const { code, prefix } of coded) { const match = code.match(/^([A-Z]{3})-(\d{2})$/); diff --git a/skills/plotter/references/catalogue/index.md b/skills/plotter/references/catalogue/index.md index caab312..c09f8c3 100644 --- a/skills/plotter/references/catalogue/index.md +++ b/skills/plotter/references/catalogue/index.md @@ -4,7 +4,7 @@ Every drawing in the Plotter catalogue, exported as a resolved static SVG at its native 560 × 440. Codes match the website. When a brief names a code (“like TIM-06”), open that file and borrow its construction relationship, not its subject. -Codes are a three-letter family prefix and a number, without gaps within a family. Drawings retired as near-duplicates keep their codes reserved and are not exported here. The [approved references](../approved-references.md) remain the style anchors; a catalogue drawing is an example, not a new reference selection. +Codes are a three-letter family prefix and a number, without gaps within a family. COS-01 and COS-02 retain their original codes within Services and Systems. Drawings retired as near-duplicates keep their codes reserved and are not exported here. The [approved references](../approved-references.md) remain the style anchors; a catalogue drawing is an example, not a new reference selection. ## Geometry (GEO) @@ -71,6 +71,7 @@ Codes are a three-letter family prefix and a number, without gaps within a famil | Code | Drawing | What it explains | | --- | --- | --- | +| [COS-02](COS-02.svg) | A common boundary | Two complementary profiles form one system. A construction study of the interface between an app and coss. | | [SYS-02](SYS-02.svg) | A connection, located | Three inputs meet three outputs on a regular switching grid. A single closed junction connects B to 02, turning an abstract matrix into a precise route. | | [SYS-04](SYS-04.svg) | A measured distribution | A small cluster occupies a regular coordinate field. Two projected measurements locate one point and make the underlying rule visible. | | [SYS-01](SYS-01.svg) | A route, constructed | One selected route and two alternatives share a junction. A repeated bend radius establishes the spacing between the three outlets. | @@ -83,6 +84,7 @@ Codes are a three-letter family prefix and a number, without gaps within a famil | Code | Drawing | What it explains | | --- | --- | --- | | [SRV-04](SRV-04.svg) | Linear · Work aligned to a cycle | Issue modules share a two-week construction grid. Their measured spans align the work within a common cycle boundary. | +| [COS-01](COS-01.svg) | One interface, many services | Different parts, one shared opening. Email, SMS, video, and scheduling meet a common SDK contract. | | [SRV-01](SRV-01.svg) | Cloudflare · Between visitor and origin | An edge cache between visitor and origin: a hit returns locally, while a miss continues outward. A study of Cloudflare’s CDN role. | | [SRV-02](SRV-02.svg) | Vercel · From preview to production | Preview 02 is selected for production. Matching outlines identify the same source version; promotion rebuilds it for the production environment. | | [SRV-03](SRV-03.svg) | Stripe · Payments, combined | Four equal payments combine into one gross payment total, before fees, refunds, or availability. Their conserved width makes aggregation a visible construction rule. | @@ -172,10 +174,3 @@ Codes are a three-letter family prefix and a number, without gaps within a famil | [NAT-01](NAT-01.svg) | A branching leaf | Paired veins follow a repeated pitch within a leaf formed by two intersecting arcs. | | [NAT-02](NAT-02.svg) | One edge, two cells | A selected hexagonal cell shares each of its walls with the surrounding six cells. | | [NAT-03](NAT-03.svg) | The summit in contours | Nested elevation lines tighten around one marked summit, with a consistent interval between levels. | - -## coss.com concepts (COS) - -| Code | Drawing | What it explains | -| --- | --- | --- | -| [COS-01](COS-01.svg) | One interface, many services | Different parts, one shared opening. Email, SMS, video, and scheduling meet a common SDK contract. | -| [COS-02](COS-02.svg) | A common boundary | Two complementary profiles form one system. A construction study of the interface between an app and coss. |