@nebutra/design-sync 0.1.2 → 2.0.0

package/dist/serialize/to-design-md.d.ts

@@ -20,7 +20,13 @@
  */
 import type { DesignTokenSet } from "../types";
 export interface ToDesignMdOptions {
-    /** Design system name. Default: "Nebutra" */
+    /**
+     * Design system name written into the exported artefact.
+     *
+     * Defaults to a generic label on purpose: this package is provider-agnostic
+     * and has no brand of its own, so naming one here would stamp it onto every
+     * downstream design system that did not pass this option.
+     */
     name?: string;
     /** One-line brand description for the front matter and prose Overview. */
     description?: string;

package/dist/serialize/to-design-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-design-md.d.ts","sourceRoot":"","sources":["../../src/serialize/to-design-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB/C,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA2C/F"}
+{"version":3,"file":"to-design-md.d.ts","sourceRoot":"","sources":["../../src/serialize/to-design-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB/C,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA2C/F"}

package/dist/serialize/to-design-md.js

@@ -28,7 +28,7 @@ import { buildIndex, buildIndexForSet, buildRounded, buildSpacing, buildTypograp
  * @returns A deterministic DESIGN.md string (YAML front matter + markdown prose).
  */
 export function serializeToDesignMd(sets, options) {
-    const name = options?.name ?? "Nebutra";
+    const name = options?.name ?? "Design System";
     const description = options?.description;
     // 1. Build a flat path→leaf index across ALL sets
     const index = buildIndex(sets);

package/dist/serialize/to-design-md.prose.d.ts

@@ -38,7 +38,7 @@ export interface ContainerInfo {
 }
 export interface ProseArgs {
     name: string;
-    /** Optional custom description. When provided, replaces the default Nebutra Overview paragraph. */
+    /** Optional custom description. Replaces the generated Overview paragraph. */
     description?: string;
     colors: ColorRoles;
     colorDescriptions: ColorDescriptions;
@@ -49,7 +49,7 @@ export interface ProseArgs {
 export declare const COLOR_ORDER: Array<keyof ColorRoles>;
 export declare const DESIGN_MD_GOVERNANCE: {
     readonly dos: readonly ["Use semantic tokens / CSS variables (`bg-primary`, `text-foreground`, `border-border`) — never raw hex values.", "Use the brand gradient (135° blue→cyan) for primary CTAs and gradient text effects.", "Use `AnimateIn` presets for entrance animations; never use raw `motion.div` with hardcoded transition values.", "Constrain layouts to the container width tiers; use the wide (1400px) container for feature sections.", "Give icon-only buttons an `aria-label`; rely on the global `:focus-visible` ring — do not add component-level focus rings."];
-    readonly donts: readonly ["Don't hardcode brand or status hex values in components — use token aliases (`var(--brand-primary)`, etc.).", "Don't use `max-w-5xl` or `max-w-7xl` for feature sections — use the wide container (`max-w-[1400px]`).", "Don't reintroduce hardcoded focus rings (they double-render with the global `:focus-visible` rule).", "Don't use raw form controls (`<input>`, `<select>`, `<textarea>`) in app surfaces — use the primitives from `@nebutra/ui/primitives`."];
+    readonly donts: readonly ["Don't hardcode brand or status hex values in components — use token aliases (`var(--brand-primary)`, etc.).", "Don't use `max-w-5xl` or `max-w-7xl` for feature sections — use the wide container (`max-w-wide`).", "Don't reintroduce hardcoded focus rings (they double-render with the global `:focus-visible` rule).", "Don't use raw form controls (`<input>`, `<select>`, `<textarea>`) in app surfaces — use the primitives from `@nebutra/ui/primitives`."];
 };
 export declare function buildProse(args: ProseArgs): string;
 //# sourceMappingURL=to-design-md.prose.d.ts.map

package/dist/serialize/to-design-md.prose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-design-md.prose.d.ts","sourceRoot":"","sources":["../../src/serialize/to-design-md.prose.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,aAAa,CAAC;CAC3B;AAID,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,MAAM,UAAU,CAS/C,CAAC;AAIF,eAAO,MAAM,oBAAoB;;;CAcvB,CAAC;AAIX,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAalD"}
+{"version":3,"file":"to-design-md.prose.d.ts","sourceRoot":"","sources":["../../src/serialize/to-design-md.prose.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,aAAa,CAAC;CAC3B;AAID,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,MAAM,UAAU,CAS/C,CAAC;AAIF,eAAO,MAAM,oBAAoB;;;CAcvB,CAAC;AAIX,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAalD"}

package/dist/serialize/to-design-md.prose.js

@@ -26,7 +26,7 @@ export const DESIGN_MD_GOVERNANCE = {
     ],
     donts: [
         "Don't hardcode brand or status hex values in components — use token aliases (`var(--brand-primary)`, etc.).",
-        "Don't use `max-w-5xl` or `max-w-7xl` for feature sections — use the wide container (`max-w-[1400px]`).",
+        "Don't use `max-w-5xl` or `max-w-7xl` for feature sections — use the wide container (`max-w-wide`).",
         "Don't reintroduce hardcoded focus rings (they double-render with the global `:focus-visible` rule).",
         "Don't use raw form controls (`<input>`, `<select>`, `<textarea>`) in app surfaces — use the primitives from `@nebutra/ui/primitives`.",
     ],
@@ -34,7 +34,7 @@ export const DESIGN_MD_GOVERNANCE = {
 // ─── Prose builder ────────────────────────────────────────────────────────────
 export function buildProse(args) {
     const sections = [];
-    sections.push(buildOverview(args.name, args.description));
+    sections.push(buildOverview(args.name, args.colors, args.description));
     sections.push(buildColors(args.colors, args.colorDescriptions));
     sections.push(buildTypographySection(args.typography));
     sections.push(buildLayout(args.containers));
@@ -45,11 +45,27 @@ export function buildProse(args) {
     return "\n" + sections.join("\n\n") + "\n";
 }
 // ─── Section helpers ──────────────────────────────────────────────────────────
-function buildOverview(name, description) {
-    const paragraph = description ??
-        `${name} is an AI-native SaaS design system built on the 云毓蓝 blue (#0033fe) → 云毓青 cyan (#0bf1c3) brand palette. ` +
-            `It targets Vercel/Geist visual parity, enforces semantic tokens over raw hex values, and ships with ` +
-            `a token-first architecture (DTCG W3C draft) that drives CSS variables, Tailwind utilities, and the Style Dictionary pipeline.`;
+/**
+ * The fallback paragraph is generated from the caller's own tokens.
+ *
+ * It used to be Nebutra's: it named 云毓蓝 #0033fe and 云毓青 #0bf1c3 as "the
+ * brand palette" and asserted Vercel/Geist parity, so every downstream design
+ * system exported a document describing someone else's colours as its own.
+ */
+function buildOverview(name, colors, description) {
+    if (description)
+        return `## Overview\n\n${description}`;
+    const palette = [
+        colors.primary ? `primary ${colors.primary}` : null,
+        colors.accent ? `accent ${colors.accent}` : null,
+    ]
+        .filter(Boolean)
+        .join(" → ");
+    const paragraph = `${name} is a token-first design system` +
+        (palette ? ` built on a ${palette} palette` : "") +
+        ". It favours semantic tokens over raw hex values and follows the DTCG " +
+        "(W3C draft) format, which drives CSS variables, Tailwind utilities and " +
+        "the Style Dictionary pipeline.";
     return `## Overview\n\n${paragraph}`;
 }
 const COLOR_LABELS = {

package/dist/serialize/to-preview-html.d.ts

@@ -16,7 +16,13 @@
  */
 import type { DesignTokenSet } from "../types";
 export interface ToPreviewHtmlOptions {
-    /** Design system name. Default: "Nebutra" */
+    /**
+     * Design system name written into the exported artefact.
+     *
+     * Defaults to a generic label on purpose: this package is provider-agnostic
+     * and has no brand of its own, so naming one here would stamp it onto every
+     * downstream design system that did not pass this option.
+     */
     name?: string;
     /**
      * Name of a theme token set (e.g. "themes/light") whose

package/dist/serialize/to-preview-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-preview-html.d.ts","sourceRoot":"","sources":["../../src/serialize/to-preview-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAkB/C,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EAAE,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CA2CR"}
+{"version":3,"file":"to-preview-html.d.ts","sourceRoot":"","sources":["../../src/serialize/to-preview-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAkB/C,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EAAE,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CA2CR"}

package/dist/serialize/to-preview-html.js

@@ -24,7 +24,7 @@ import { buildDocument, cssAttrValue, escapeHtml, } from "./to-preview-html.temp
  * @returns A deterministic, self-contained HTML string.
  */
 export function serializeToPreviewHtml(sets, options) {
-    const name = options?.name ?? "Nebutra";
+    const name = options?.name ?? "Design System";
     const escapedName = escapeHtml(name);
     // 1. Build flat indexes
     const index = buildIndex(sets);

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@nebutra/design-sync",
-  "version": "0.1.2",
+  "version": "2.0.0",
   "description": "Provider-agnostic design-tool sync. Figma + Tokens Studio | Penpot | git-only | design-md | memory.",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "core",
     "status": "foundation",
     "productionReady": false,
     "requires": [
@@ -73,8 +74,8 @@
   "dependencies": {
     "@google/design.md": "0.2.0",
     "zod": "^4.3.6",
-    "@nebutra/logger": "0.1.2",
-    "@nebutra/tokens": "0.1.2"
+    "@nebutra/logger": "2.0.0",
+    "@nebutra/tokens": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",