groundwork-method 0.0.1 → 0.10.0

package/dist/src/generators/shared/brand-tokens.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEUTRAL_MOTION = exports.NEUTRAL_TYPE_ROLES = exports.NEUTRAL_SURFACE = exports.NEUTRAL_SHADOW = exports.NEUTRAL_BLUR = exports.PALETTE_TO_SHADCN = exports.SHADCN_VARS = exports.BRAND_TOKENS_PATH = void 0;
+exports.validColor = validColor;
+exports.validLen = validLen;
+exports.safeCss = safeCss;
+exports.composeShadow = composeShadow;
+exports.resolveVisual = resolveVisual;
+/**
+ * Shared brand-token projection.
+ *
+ * `resolveVisual(tree)` reads `.groundwork/config/brand-tokens.json` and resolves
+ * the per-app palette + atmosphere layer into a single `ResolvedVisual` shape that
+ * surface generators project onto their own theming model:
+ *   - `nextjs-app` → Tailwind-v4/shadcn `app/brand.css` (`renderBrandCss`, kept in
+ *     that generator because the variable names + utilities are shadcn-specific).
+ *   - `docs-site` → Fumadocs `--fd-*` theme variables (`renderDocsBrandCss`).
+ *
+ * The resolver itself is theme-system-agnostic: it validates and normalises the
+ * token values, falling back to a neutral starter so generation always emits valid
+ * CSS even when no brand-tokens.json exists or the file is malformed.
+ */
+exports.BRAND_TOKENS_PATH = '.groundwork/config/brand-tokens.json';
+/** shadcn structural CSS variables with their neutral defaults (light/dark) —
+ *  the palette app/globals.css carried before brand projection. The generator
+ *  overrides the brand-mappable subset from brand-tokens.json's visual block;
+ *  the rest stay these tuned neutrals so component contrast stays safe. */
+exports.SHADCN_VARS = {
+    background: { light: 'oklch(1 0 0)', dark: 'oklch(0.145 0 0)' },
+    foreground: { light: 'oklch(0.145 0 0)', dark: 'oklch(0.985 0 0)' },
+    card: { light: 'oklch(1 0 0)', dark: 'oklch(0.145 0 0)' },
+    'card-foreground': { light: 'oklch(0.145 0 0)', dark: 'oklch(0.985 0 0)' },
+    popover: { light: 'oklch(1 0 0)', dark: 'oklch(0.145 0 0)' },
+    'popover-foreground': { light: 'oklch(0.145 0 0)', dark: 'oklch(0.985 0 0)' },
+    primary: { light: 'oklch(0.205 0 0)', dark: 'oklch(0.985 0 0)' },
+    'primary-foreground': { light: 'oklch(0.985 0 0)', dark: 'oklch(0.205 0 0)' },
+    secondary: { light: 'oklch(0.97 0 0)', dark: 'oklch(0.269 0 0)' },
+    'secondary-foreground': { light: 'oklch(0.205 0 0)', dark: 'oklch(0.985 0 0)' },
+    muted: { light: 'oklch(0.97 0 0)', dark: 'oklch(0.269 0 0)' },
+    'muted-foreground': { light: 'oklch(0.556 0 0)', dark: 'oklch(0.708 0 0)' },
+    accent: { light: 'oklch(0.97 0 0)', dark: 'oklch(0.269 0 0)' },
+    'accent-foreground': { light: 'oklch(0.205 0 0)', dark: 'oklch(0.985 0 0)' },
+    destructive: { light: 'oklch(0.577 0.245 27.325)', dark: 'oklch(0.396 0.141 25.723)' },
+    success: { light: 'oklch(0.6 0.13 160)', dark: 'oklch(0.7 0.12 160)' },
+    warning: { light: 'oklch(0.7 0.14 85)', dark: 'oklch(0.78 0.13 85)' },
+    info: { light: 'oklch(0.6 0.14 250)', dark: 'oklch(0.72 0.12 250)' },
+    border: { light: 'oklch(0.922 0 0)', dark: 'oklch(0.269 0 0)' },
+    input: { light: 'oklch(0.922 0 0)', dark: 'oklch(0.269 0 0)' },
+    ring: { light: 'oklch(0.708 0 0)', dark: 'oklch(0.556 0 0)' },
+    'chart-1': { light: 'oklch(0.646 0.222 41.116)', dark: 'oklch(0.488 0.243 264.376)' },
+    'chart-2': { light: 'oklch(0.6 0.118 184.714)', dark: 'oklch(0.696 0.17 162.48)' },
+    'chart-3': { light: 'oklch(0.398 0.07 227.392)', dark: 'oklch(0.769 0.188 70.08)' },
+    'chart-4': { light: 'oklch(0.828 0.189 84.429)', dark: 'oklch(0.627 0.265 303.9)' },
+    'chart-5': { light: 'oklch(0.769 0.188 70.08)', dark: 'oklch(0.645 0.246 16.439)' },
+    sidebar: { light: 'oklch(0.985 0 0)', dark: 'oklch(0.145 0 0)' },
+    'sidebar-foreground': { light: 'oklch(0.145 0 0)', dark: 'oklch(0.985 0 0)' },
+    'sidebar-primary': { light: 'oklch(0.205 0 0)', dark: 'oklch(0.488 0.243 264.376)' },
+    'sidebar-primary-foreground': { light: 'oklch(0.985 0 0)', dark: 'oklch(0.985 0 0)' },
+    'sidebar-accent': { light: 'oklch(0.97 0 0)', dark: 'oklch(0.269 0 0)' },
+    'sidebar-accent-foreground': { light: 'oklch(0.205 0 0)', dark: 'oklch(0.985 0 0)' },
+    'sidebar-border': { light: 'oklch(0.922 0 0)', dark: 'oklch(0.269 0 0)' },
+    'sidebar-ring': { light: 'oklch(0.708 0 0)', dark: 'oklch(0.556 0 0)' },
+};
+/** Which shadcn vars each visual.palette role drives. Only the contrast-safe
+ *  slots are mapped: a surface role onto surfaces, the text role onto
+ *  foregrounds, brand hues onto primary/ring/charts. Contrast-sensitive
+ *  foregrounds-on-colour keep their tuned neutral defaults. */
+exports.PALETTE_TO_SHADCN = {
+    surface: ['background', 'card', 'popover', 'sidebar'],
+    surfaceAlt: ['secondary', 'muted', 'accent', 'sidebar-accent'],
+    textBody: ['foreground', 'card-foreground', 'popover-foreground', 'sidebar-foreground'],
+    primary: ['primary', 'ring', 'sidebar-primary', 'sidebar-ring', 'chart-1'],
+    accent: ['chart-2'],
+    info: ['info', 'chart-3'],
+    success: ['success', 'chart-4'],
+    warning: ['warning', 'chart-5'],
+    error: ['destructive'],
+};
+/** CSS colour — hex (3/4/6/8) or OKLCH with optional alpha. */
+function validColor(value) {
+    if (typeof value !== 'string')
+        return null;
+    const v = value.trim();
+    if (/^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(v))
+        return v.toLowerCase();
+    if (/^oklch\(\s*[\d.]+%?\s+[\d.]+\s+[\d.]+(?:deg)?(?:\s*\/\s*[\d.]+%?)?\s*\)$/i.test(v))
+        return v;
+    return null;
+}
+/** CSS length: px/rem/em/% or a bare number treated as px. */
+function validLen(value) {
+    if (typeof value !== 'string' && typeof value !== 'number')
+        return null;
+    const m = String(value).trim().match(/^([\d.]+)\s*(px|rem|em|%)?$/i);
+    if (!m || !Number.isFinite(parseFloat(m[1])))
+        return null;
+    return `${m[1]}${(m[2] || 'px').toLowerCase()}`;
+}
+/** A guarded passthrough for composite CSS values (shadow stacks, gradients,
+ *  transforms, easing). Rejects anything that could break out of a declaration
+ *  so a malformed token degrades to the neutral default instead of corrupting
+ *  the stylesheet. */
+function safeCss(value, maxLen = 240) {
+    if (typeof value !== 'string')
+        return null;
+    const v = value.trim();
+    if (!v || v.length > maxLen)
+        return null;
+    if (/[;{}@<>]/.test(v) || v.includes('//') || v.includes('/*'))
+        return null;
+    return v;
+}
+/** Compose an elevation layer array into a box-shadow string (x is always 0).
+ *  Returns null if any layer is malformed, so the level falls back to neutral. */
+function composeShadow(layers) {
+    if (!Array.isArray(layers) || layers.length === 0)
+        return null;
+    const parts = [];
+    for (const l of layers) {
+        const y = validLen(l?.y);
+        const blur = validLen(l?.blur);
+        const color = validColor(l?.color);
+        if (!y || !blur || !color)
+            return null;
+        const spread = l?.spread != null ? validLen(l.spread) : null;
+        parts.push(`0 ${y} ${blur}${spread ? ` ${spread}` : ''} ${color}`);
+    }
+    return parts.join(', ');
+}
+exports.NEUTRAL_BLUR = { subtle: '8px', standard: '12px', heavy: '20px' };
+exports.NEUTRAL_SHADOW = {
+    low: {
+        light: '0 1px 2px oklch(0% 0 0 / 0.06)',
+        dark: '0 1px 2px oklch(0% 0 0 / 0.3)',
+    },
+    mid: {
+        light: '0 1px 2px oklch(0% 0 0 / 0.06), 0 4px 8px oklch(0% 0 0 / 0.04)',
+        dark: '0 1px 2px oklch(0% 0 0 / 0.3), 0 4px 8px oklch(0% 0 0 / 0.25)',
+    },
+    high: {
+        light: '0 1px 2px oklch(0% 0 0 / 0.06), 0 4px 8px oklch(0% 0 0 / 0.04), 0 12px 24px oklch(0% 0 0 / 0.03)',
+        dark: '0 1px 2px oklch(0% 0 0 / 0.3), 0 4px 8px oklch(0% 0 0 / 0.25), 0 12px 24px oklch(0% 0 0 / 0.2)',
+    },
+};
+exports.NEUTRAL_SURFACE = {
+    glass: {
+        tint: { light: 'oklch(98% 0.005 250 / 0.72)', dark: 'oklch(22% 0.01 250 / 0.6)' },
+        border: { light: 'oklch(0% 0 0 / 0.08)', dark: 'oklch(100% 0 0 / 0.08)' },
+    },
+    elevated: {
+        tint: { light: 'oklch(98% 0.005 250 / 0.85)', dark: 'oklch(24% 0.01 250 / 0.75)' },
+        border: { light: 'oklch(0% 0 0 / 0.1)', dark: 'oklch(100% 0 0 / 0.12)' },
+    },
+    hero: {
+        tint: { light: 'oklch(98% 0.005 250 / 0.65)', dark: 'oklch(20% 0.01 250 / 0.55)' },
+        border: { light: 'oklch(0% 0 0 / 0.08)', dark: 'oklch(100% 0 0 / 0.1)' },
+    },
+};
+exports.NEUTRAL_TYPE_ROLES = {
+    display: { size: '2.5rem', line: '1.1', weight: '600', tracking: '-0.02em' },
+    title: { size: '1.5rem', line: '1.25', weight: '600', tracking: '-0.01em' },
+    body: { size: '1rem', line: '1.6', weight: '400', tracking: '0' },
+    caption: { size: '0.875rem', line: '1.5', weight: '400', tracking: '0.01em' },
+};
+exports.NEUTRAL_MOTION = {
+    hover: { duration: '150ms', ease: 'cubic-bezier(0, 0, 0.2, 1)', transform: 'translateY(-1px)' },
+    press: { duration: '100ms', ease: 'cubic-bezier(0.4, 0, 1, 1)', transform: 'scale(0.97)' },
+    enter: { duration: '200ms', ease: 'cubic-bezier(0, 0, 0.2, 1)', transform: 'scale(0.98)' },
+    stagger: { duration: '30ms', ease: 'linear', transform: 'none' },
+};
+/** Read brand-tokens.json and resolve the per-app palette + atmosphere layer.
+ *  Mirrors electron-app/flutter-app token handling: a visual block projects in
+ *  full; Tier-1-only seeds the brand hue from identity; absent/malformed tokens
+ *  fall back to the neutral starter so generation always emits valid CSS. */
+function resolveVisual(tree) {
+    const shadcn = {};
+    for (const [k, v] of Object.entries(exports.SHADCN_VARS))
+        shadcn[k] = { ...v };
+    const resolved = {
+        shadcn,
+        radius: '0.625rem',
+        blur: { ...exports.NEUTRAL_BLUR },
+        shadow: { low: { ...exports.NEUTRAL_SHADOW.low }, mid: { ...exports.NEUTRAL_SHADOW.mid }, high: { ...exports.NEUTRAL_SHADOW.high } },
+        gradientHero: { light: 'none', dark: 'none' },
+        surfaces: JSON.parse(JSON.stringify(exports.NEUTRAL_SURFACE)),
+        typeRoles: JSON.parse(JSON.stringify(exports.NEUTRAL_TYPE_ROLES)),
+        motion: JSON.parse(JSON.stringify(exports.NEUTRAL_MOTION)),
+        source: 'default',
+    };
+    if (!tree.exists(exports.BRAND_TOKENS_PATH))
+        return resolved;
+    let raw = null;
+    try {
+        raw = JSON.parse(tree.read(exports.BRAND_TOKENS_PATH, 'utf-8') || '{}');
+    }
+    catch {
+        return resolved;
+    }
+    const visual = raw?.visual;
+    if (!visual || typeof visual !== 'object') {
+        // Tier-1-only: seed the brand hue from identity onto primary/ring/charts.
+        const primary = validColor(raw?.identity?.primary);
+        const accent = validColor(raw?.identity?.accent);
+        if (primary) {
+            for (const v of exports.PALETTE_TO_SHADCN.primary)
+                shadcn[v] = { light: primary, dark: primary };
+            resolved.source = 'identity-only';
+        }
+        if (accent)
+            for (const v of exports.PALETTE_TO_SHADCN.accent)
+                shadcn[v] = { light: accent, dark: accent };
+        return resolved;
+    }
+    resolved.source = 'visual-block';
+    // Palette → shadcn structural vars (safe subset).
+    for (const [role, targets] of Object.entries(exports.PALETTE_TO_SHADCN)) {
+        const entry = visual.palette?.[role];
+        const light = validColor(entry?.light);
+        const dark = validColor(entry?.dark);
+        if (!light && !dark)
+            continue;
+        for (const v of targets) {
+            shadcn[v] = {
+                light: light ?? shadcn[v].light,
+                dark: dark ?? shadcn[v].dark,
+            };
+        }
+    }
+    // Shape → radius.
+    const radius = validLen(visual.shape?.radiusBase);
+    if (radius)
+        resolved.radius = radius;
+    // Blur levels.
+    for (const lvl of ['subtle', 'standard', 'heavy']) {
+        const b = validLen(visual.blur?.[lvl]);
+        if (b)
+            resolved.blur[lvl] = b;
+    }
+    // Elevation stacks → box-shadow strings (one geometry serves both themes).
+    for (const lvl of ['low', 'mid', 'high']) {
+        const composed = composeShadow(visual.elevation?.[lvl]);
+        if (composed)
+            resolved.shadow[lvl] = { light: composed, dark: composed };
+    }
+    // Surface treatments: tint/border per named treatment.
+    for (const name of ['glass', 'elevated', 'hero']) {
+        const s = visual.surface?.[name];
+        if (!s || typeof s !== 'object')
+            continue;
+        const tint = validColor(s.tint);
+        const border = validColor(s.border);
+        if (tint)
+            resolved.surfaces[name].tint = { light: tint, dark: tint };
+        if (border)
+            resolved.surfaces[name].border = { light: border, dark: border };
+    }
+    // Hero gradient: the hero surface names a gradient → resolve from visual.gradients.
+    const heroGradientKey = visual.surface?.hero?.gradient;
+    if (typeof heroGradientKey === 'string') {
+        const g = visual.gradients?.[heroGradientKey];
+        if (typeof g === 'string') {
+            const v = safeCss(g);
+            if (v)
+                resolved.gradientHero = { light: v, dark: v };
+        }
+        else if (g && typeof g === 'object') {
+            const l = safeCss(g.light);
+            const d = safeCss(g.dark);
+            if (l || d)
+                resolved.gradientHero = { light: l ?? 'none', dark: d ?? l ?? 'none' };
+        }
+    }
+    // Typography roles.
+    for (const role of Object.keys(exports.NEUTRAL_TYPE_ROLES)) {
+        const r = visual.typography?.roles?.[role];
+        if (!r || typeof r !== 'object')
+            continue;
+        const size = validLen(r.size);
+        const line = typeof r.lineHeight === 'number' || typeof r.lineHeight === 'string' ? String(r.lineHeight) : null;
+        const weight = r.weight != null ? String(Number(r.weight) || resolved.typeRoles[role].weight) : null;
+        const tracking = safeCss(r.tracking, 16);
+        if (size)
+            resolved.typeRoles[role].size = size;
+        if (line && /^[\d.]+$/.test(line))
+            resolved.typeRoles[role].line = line;
+        if (weight)
+            resolved.typeRoles[role].weight = weight;
+        if (tracking)
+            resolved.typeRoles[role].tracking = tracking;
+    }
+    // Motion interaction profiles.
+    for (const ctx of Object.keys(exports.NEUTRAL_MOTION)) {
+        const m = visual.motion?.interactions?.[ctx];
+        if (!m || typeof m !== 'object')
+            continue;
+        const duration = Number.isFinite(Number(m.durationMs)) ? `${Number(m.durationMs)}ms` : null;
+        const ease = safeCss(m.ease, 48);
+        const transform = safeCss(m.transform, 48);
+        if (duration)
+            resolved.motion[ctx].duration = duration;
+        if (ease)
+            resolved.motion[ctx].ease = ease;
+        if (transform)
+            resolved.motion[ctx].transform = transform;
+    }
+    return resolved;
+}
+//# sourceMappingURL=brand-tokens.js.map

package/dist/src/generators/shared/brand-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-tokens.js","sourceRoot":"","sources":["../../../../src/generators/shared/brand-tokens.ts"],"names":[],"mappings":"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"}

package/dist/src/generators/shared/capabilities.d.ts

@@ -0,0 +1,101 @@
+import { Tree } from '@nx/devkit';
+import { RunnerSpec } from './scaffold-helpers';
+/**
+ * Composable capabilities and providers (plan WS-F).
+ *
+ * The core depends on an interface it owns; the implementation is wired in at
+ * the edge and is swappable. This module turns that into scaffold mechanics. A
+ * *capability* (e.g. `llm`) is an interface plus a catalog of *providers*;
+ * choosing a provider selects the implementation wired in at the edge, and each
+ * provider declares an operational *footprint* — `env` (just config),
+ * `compose-service`, `runner`, or `none` (the bare interface, no provider).
+ *
+ * The registry is data, not code (src/generators/capabilities/<cap>/...), so
+ * adding a provider is a folder, not a generator change. Both the service
+ * generators (scaffold time) and the standalone `add-capability` generator
+ * (Day 2 / inside a bet) call applyCapability() — one injector, no drift.
+ */
+export type FootprintKind = 'env' | 'compose-service' | 'runner' | 'none';
+export interface EnvVar {
+    name: string;
+    required?: boolean;
+    default?: string;
+}
+/** A `compose-service`-footprint provider declares the container it injects into
+ *  the workspace docker-compose (e.g. a self-hosted model-inference server). */
+export interface ComposeServiceFootprint {
+    name: string;
+    definition: Record<string, unknown>;
+    /** Top-level named volumes the service references (declared under `volumes:`). */
+    volumes?: string[];
+}
+export interface ProviderFootprint {
+    kind: FootprintKind;
+    summary?: string;
+    env?: EnvVar[];
+    stacks?: Record<string, {
+        dependencies?: string[];
+    }>;
+    /** Present iff kind === 'runner': the native process to register with `./dev`. */
+    runner?: RunnerSpec;
+    /** Present iff kind === 'compose-service': the container to inject. */
+    composeService?: ComposeServiceFootprint;
+}
+export interface CapabilityStack {
+    port: string;
+    portSymbol: string;
+    adapter: string;
+    adapterSymbol: string;
+    contractTest: string;
+    /** The example env file to record the provider's env footprint in
+     *  (`.env.example` for python, `.env` for go). Defaults to `.env.example`. */
+    envFile?: string;
+    /** When true, the stack's templates need the service's module/import path
+     *  (Go: the `module` line in go.mod) substituted as `moduleName`. */
+    module?: boolean;
+    wiring?: string;
+}
+export interface Capability {
+    id: string;
+    title: string;
+    description?: string;
+    default: string;
+    providers: string[];
+    stacks: Record<string, CapabilityStack>;
+}
+export declare function loadCapability(capability: string): Capability;
+export declare function loadFootprint(capability: string, provider: string): ProviderFootprint;
+export interface ApplyCapabilityResult {
+    capability: string;
+    provider: string;
+    stack: string;
+    footprint: FootprintKind;
+    wiring?: string;
+    /** True once the footprint's infra/runner was actually materialised (compose
+     *  service injected or runner registered). False when the workspace context was
+     *  missing (no compose file / no dev.config.json) and the caller must finish it. */
+    materialized: boolean;
+    files: {
+        port: string;
+        adapter: string;
+        contractTest: string;
+    };
+}
+/**
+ * Materialize a capability+provider into a service: the port, the chosen
+ * adapter (or the `none` stub), the contract test, the provider's stack
+ * dependencies, and its env footprint — plus its operational footprint. An
+ * `env`/`none` footprint is service-local; a `compose-service` footprint injects
+ * the container into the workspace docker-compose and a `runner` footprint
+ * registers a native process with `./dev` (both no-op gracefully when the
+ * workspace file is absent, reported via `materialized`).
+ *
+ * Idempotent: capability-owned files are overwritten with identical content on
+ * re-run; deps and env are added only if absent.
+ */
+export declare function applyCapability(tree: Tree, opts: {
+    capability: string;
+    provider: string;
+    stack: string;
+    serviceRoot: string;
+}): ApplyCapabilityResult;