@letterstory/design 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PRINCIPLES.md +4 -3
- package/README.md +2 -2
- package/package.json +3 -3
- package/tokens.css +1 -1
package/PRINCIPLES.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<!-- Published copy. The source is AGENTS.md at the root of github.com/letterstory/letterstory; edit there and run design/scripts/build.mjs. -->
|
|
2
2
|
|
|
3
|
-
#
|
|
3
|
+
# Letter design principles
|
|
4
4
|
|
|
5
5
|
## The six principles
|
|
6
6
|
|
|
@@ -20,8 +20,9 @@
|
|
|
20
20
|
stops being phantom-only loses its `phantom-` prefix in the same PR.
|
|
21
21
|
|
|
22
22
|
3. **One operation, one function, many projections.** UI route, MCP tool, REST endpoint and CLI
|
|
23
|
-
command are _projections_ of one lib function with one Zod schema. The manifest is `
|
|
24
|
-
in `src/lib/mcp/
|
|
23
|
+
command are _projections_ of one lib function with one Zod schema. The manifest is `TOOL_MANIFEST`
|
|
24
|
+
in `src/lib/mcp/manifest.ts` (handlers keyed by name in `src/lib/mcp/registry.ts`, which binds
|
|
25
|
+
them into `TOOLS`); MCP, OpenAPI and `/docs/api` are derived from it at request time
|
|
25
26
|
and cannot drift (`src/app/docs/api/AGENTS.md`). Where the UI has its own `/api/*` route, that
|
|
26
27
|
route and the tool must call the same lib function and share the schema — derive the tool
|
|
27
28
|
contract with `.omit()` for key-derived fields exactly as
|
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# `@letterstory/design`
|
|
2
2
|
|
|
3
|
-
The cross-repo layer of
|
|
3
|
+
The cross-repo layer of Letter's design system: the **tokens** (colour, radius, font,
|
|
4
4
|
type scale), the **phantom theme registry** Lettersprite renders, and the **design
|
|
5
5
|
principles** as a shipped file. Framework-neutral data with one thin adapter per framework,
|
|
6
|
-
so every
|
|
6
|
+
so every Letter repo reads the same values and none of them copies a palette.
|
|
7
7
|
|
|
8
8
|
Zero runtime dependencies, no build step to install. Published from this directory by
|
|
9
9
|
`.github/workflows/publish-design.yml` (npm Trusted Publishing, on merge to `main`);
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@letterstory/design",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.2.5",
|
|
4
|
+
"description": "Letter design tokens, the phantom theme registry, and the design principles — one source for every Letter repo.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "UNLICENSED",
|
|
7
|
-
"author": "
|
|
7
|
+
"author": "Letter",
|
|
8
8
|
"homepage": "https://github.com/letterstory/letterstory/tree/main/design#readme",
|
|
9
9
|
"repository": {
|
|
10
10
|
"type": "git",
|
package/tokens.css
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/* GENERATED by design/scripts/build.mjs — do not edit by hand. Source: design/tokens.json.
|
|
2
2
|
*
|
|
3
|
-
*
|
|
3
|
+
* Letter design tokens as CSS custom properties. Framework-neutral: load this
|
|
4
4
|
* stylesheet, then map the variables with the adapter for your framework
|
|
5
5
|
* (tailwind-v4.css, tailwind-v3.cjs, styled.js) or read them with var() directly.
|
|
6
6
|
* Dark values switch on a `.dark` class on an ancestor (next-themes attribute="class").
|