@syncline-design/cli 0.1.0-sandbox.46 → 0.1.0-sandbox.48

package/README.md

@@ -19,10 +19,10 @@ Until the first stable release only the `sandbox` tag exists.
 
 ## What it reads and writes
 
-|        |                                                                                                                                                                       |
-| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Reads  | `.figma/design.json` (required), `.figma/assets.json`, `.figma/annotations.json` and `.figma/design.enriched.json` (optional), `syncline.config.json` (optional)      |
-| Writes | components, stories, vector assets, the theme and its `ThemeProvider`, Storybook docs and wiring (`.storybook/`), and the `tsconfig.json` entry for the theme typings |
+|        |                                                                                                                                                                                                                                       |
+| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Reads  | `.figma/design.json` (required), `.figma/assets.json`, `.figma/annotations.json` and `.figma/design.enriched.json` (optional), `.figma/fonts.resolved.json` (optional, written by the font lookup), `syncline.config.json` (optional) |
+| Writes | components, stories, vector assets, the theme and its `ThemeProvider`, Storybook docs and wiring (`.storybook/`), and the `tsconfig.json` entry for the theme typings                                                                 |
 
 Output is formatted with **your own prettier config**, so it matches what your
 commit hooks produce and a re-run shows no formatting churn.
@@ -58,6 +58,7 @@ Every key is optional; this is the full shape with its defaults. The Figma plugi
     "enriched": ".figma/design.enriched.json", // absent on disk => raw tier
     "assets": ".figma/assets.json",
     "annotations": ".figma/annotations.json", // the designer's intents; absent => none
+    "fonts": ".figma/fonts.resolved.json", // where each font can be loaded from; commit it
   },
   "paths": {
     "components": "src/components",
@@ -98,6 +99,19 @@ Every key is optional; this is the full shape with its defaults. The Figma plugi
       "surfaceToken": "Brand/Grey",
     },
   },
+  "fonts": {
+    "enabled": true, // false: no font loading or font diagnostics (components still read the --font-* variables)
+    "files": {
+      // fonts that are not on Google Fonts, mapped to files you own (never downloaded or published by Syncline)
+      "Acme Sans": [
+        {
+          "weight": 400,
+          "style": "normal",
+          "path": "src/fonts/AcmeSans-Regular.woff2",
+        },
+      ],
+    },
+  },
   "dependencies": {
     "install": false, // true: add missing react/styled-components/Storybook packages with your package manager
   },
@@ -239,6 +253,26 @@ cache, so a re-run does not ask again. It needs `vitest`, `jsdom` and
 `@storybook/react` in the project; without them nothing is written and the run
 says why. Set `verify` to `false` to write the proposals unchecked.
 
+## Fonts
+
+Components read each font through a CSS custom property with the family name as
+fallback: `font-family: var(--font-inter-tight, 'Inter Tight'), sans-serif`. An app
+binds its own loader (for example `next/font`) to the variable; the library ships
+no font files. See [Fonts](../../docs/fonts/README.md).
+
+`generate` asks [Fontsource](https://fontsource.org) (the Google Fonts as npm
+packages) about each family it has not seen and records the answer, "not found"
+included, in `.figma/fonts.resolved.json`; commit it so a re-run needs no network.
+`--check` and `--no-enrich` use that file and never go online, and a request that
+fails leaves the family unknown (retried next run), never "missing".
+`syncline fonts` runs just the lookup and lists where each family comes from.
+
+The generated Storybook loads what was found (`.storybook/fonts.css`, imported by
+the decorator) and `generate` adds the `@fontsource*` packages to the dependency
+check. A family Fontsource does not have, such as a proprietary font, is reported
+and is yours to load: map your own files in `fonts.files`, or define the variable
+in your app. Syncline never downloads or publishes a font it does not host.
+
 ## Dependencies
 
 The generated code imports `react`, `react-dom`, `styled-components` and, with

package/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as e } from "./run-oaaRlk5Q.js";
+import { r as e } from "./run-CGTUZWPk.js";
 //#region src/bin.ts
 e(process.argv.slice(2), {
 	out: (e) => process.stdout.write(e),

package/index.js

@@ -1,4 +1,4 @@
-import { A as e, C as t, D as n, E as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, k as g, l as _, m as v, n as y, o as b, p as x, r as S, s as C, t as w, u as T, v as E, w as D, x as O, y as k } from "./run-oaaRlk5Q.js";
+import { A as e, C as t, D as n, E as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, k as g, l as _, m as v, n as y, o as b, p as x, r as S, s as C, t as w, u as T, v as E, w as D, x as O, y as k } from "./run-CGTUZWPk.js";
 import { join as A } from "node:path";
 //#region src/stories/project-step.ts
 async function j(n) {
@@ -16,7 +16,7 @@ async function j(n) {
 		status: "no-design",
 		reason: s.error
 	};
-	let l = A(r, i.inputs.stories), u = n.env ?? process.env, d = await f({
+	let l = A(r, i.inputs.stories), u = n.env ?? process.env, f = await d({
 		input: {
 			...s.input,
 			existing: O(r)
@@ -35,17 +35,17 @@ async function j(n) {
 		fetch: n.fetch,
 		sleep: n.sleep
 	});
-	if (!d) return { status: "skipped" };
-	let p = i.enrichStories.verify ? await b({
+	if (!f) return { status: "skipped" };
+	let p = i.enrichStories.verify ? await c({
 		...n,
 		cachePath: l,
-		generate: c
+		generate: h
 	}) : void 0;
 	return {
 		status: "done",
-		proposals: d.size,
+		proposals: f.size,
 		...p && { verified: p }
 	};
 }
 //#endregion
-export { o as BridgeError, w as CLI_NAME, g as CLI_VERSION, n as CliConfigSchema, i as DEFAULT_CONFIG_FILE, C as applyVerification, E as bridgeClientProvider, T as cachedStoryEnrichment, r as createBridgeClient, k as enrichDesign, v as enrichStories, p as formatFiles, c as generate, D as getBridgeToken, l as hashFacts, m as hashStoryFacts, y as helpText, h as loadCliConfig, u as proposalKeys, d as readStoriesCache, S as run, s as runEnrichStep, j as runProjectStoriesStep, f as runStoriesStep, _ as runVitestHarness, x as selectProposals, b as verifyProposals };
+export { o as BridgeError, w as CLI_NAME, g as CLI_VERSION, n as CliConfigSchema, i as DEFAULT_CONFIG_FILE, b as applyVerification, s as bridgeClientProvider, _ as cachedStoryEnrichment, r as createBridgeClient, E as enrichDesign, x as enrichStories, m as formatFiles, h as generate, D as getBridgeToken, k as hashFacts, v as hashStoryFacts, y as helpText, l as loadCliConfig, C as proposalKeys, T as readStoriesCache, S as run, p as runEnrichStep, j as runProjectStoriesStep, d as runStoriesStep, u as runVitestHarness, f as selectProposals, c as verifyProposals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncline-design/cli",
-  "version": "0.1.0-sandbox.46",
+  "version": "0.1.0-sandbox.48",
   "description": "Generates a React component library from a Figma export (Syncline).",
   "license": "MIT",
   "repository": {