Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 0 additions & 2 deletions app/illustrations/page.tsx
Original file line number Diff line number Diff line change
@@ -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,
Expand Down Expand Up @@ -64,7 +63,6 @@ export default function IllustrationsPage() {
/>
</Suspense>
</section>
<CossConcepts />
</SiteShell>
);
}
Original file line number Diff line number Diff line change
@@ -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
Expand Down
48 changes: 0 additions & 48 deletions components/plotter/coss-concepts/index.tsx

This file was deleted.

2 changes: 2 additions & 0 deletions components/plotter/illustrations.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand All @@ -40,6 +41,7 @@ const collection: IllustrationStudy[] = [
illustration: <OriginalParticlesBlueprint />,
},
...systemStudies,
...sharedInterfaceStudies,
...flatCalStudies,
...interfaceDetailStudies,
...flatSystemStudies,
Expand Down
6 changes: 0 additions & 6 deletions components/plotter/plotter-intro.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,6 @@ export function PlotterIntro() {
>
Customization
</a>
<a
className="underline underline-offset-4 hover:text-muted-foreground"
href="/illustrations#coss-concepts"
>
coss.com concepts
</a>
</nav>
</header>
);
Expand Down
24 changes: 24 additions & 0 deletions components/plotter/shared-interface-studies.tsx
Original file line number Diff line number Diff line change
@@ -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: <CommonInterfaceStudy />,
},
{
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: <SharedSystemStudy />,
},
];
Original file line number Diff line number Diff line change
@@ -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 };
Expand Down
1 change: 1 addition & 0 deletions components/plotter/study-types.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
Binary file modified public/plotter/downloads/plotter.zip
Binary file not shown.
34 changes: 10 additions & 24 deletions scripts/build-plotter-catalogue.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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)) {
Expand Down Expand Up @@ -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})`,
"",
Expand All @@ -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}`,
);
Expand Down
14 changes: 6 additions & 8 deletions scripts/check-plotter.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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";

Expand Down Expand Up @@ -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<string, number[]>();
for (const { code, prefix } of coded) {
const match = code.match(/^([A-Z]{3})-(\d{2})$/);
Expand Down
11 changes: 3 additions & 8 deletions skills/plotter/references/catalogue/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down Expand Up @@ -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. |
Expand All @@ -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. |
Expand Down Expand Up @@ -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. |
Loading