@refrakt-md/cli 0.24.6 → 0.25.0

package/dist/commands/install.js

@@ -0,0 +1,301 @@
+/** Shared install surface for distributable extensions (SPEC-110).
+ *
+ *  Source *resolution* (directory | tarball | registry → a concrete package
+ *  name) is common to themes, templates, and preset packs; only the *apply*
+ *  step differs per artifact (SPEC-110 §4). This module owns resolution,
+ *  package-manager invocation, refrakt-compat validation (ADR-023), and the
+ *  multi-site config helpers; the per-artifact apply lives alongside.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, isAbsolute } from 'node:path';
+import { gunzipSync } from 'node:zlib';
+import { checkRefraktCompat } from '@refrakt-md/types';
+import { detectPackageManager } from '../config-file.js';
+/** Extract the package name from a registry specifier, handling scopes and an
+ *  optional `@version` / `@tag` / `@range` suffix. */
+export function parsePackageName(spec) {
+    if (spec.startsWith('@')) {
+        const slash = spec.indexOf('/');
+        if (slash === -1)
+            return spec;
+        const at = spec.indexOf('@', slash);
+        return at === -1 ? spec : spec.slice(0, at);
+    }
+    const at = spec.indexOf('@');
+    return at <= 0 ? spec : spec.slice(0, at);
+}
+/** Read `package/package.json` from an npm `.tgz` (gzip + ustar tar), without a
+ *  tar dependency — npm tarballs are a flat `package/` tree, so a minimal
+ *  512-byte-record scan suffices (SPEC-110 §1). */
+export function readPackageJsonFromTarball(tgzPath) {
+    const buf = gunzipSync(readFileSync(tgzPath));
+    let offset = 0;
+    while (offset + 512 <= buf.length) {
+        const header = buf.subarray(offset, offset + 512);
+        const name = header.subarray(0, 100).toString('utf-8').replace(/\0.*$/, '');
+        if (name === '')
+            break; // end-of-archive (zero block)
+        const sizeOctal = header.subarray(124, 136).toString('utf-8').replace(/\0.*$/, '').trim();
+        const size = sizeOctal ? parseInt(sizeOctal, 8) : 0;
+        const contentStart = offset + 512;
+        // npm prefixes every entry with "package/"; the manifest is package/package.json
+        if (name === 'package/package.json') {
+            const content = buf.subarray(contentStart, contentStart + size).toString('utf-8');
+            try {
+                const pkg = JSON.parse(content);
+                return { name: pkg.name, version: pkg.version };
+            }
+            catch {
+                return {};
+            }
+        }
+        offset = contentStart + Math.ceil(size / 512) * 512;
+    }
+    return {};
+}
+/** Resolve a source (directory | tarball | registry name) to a concrete
+ *  package name + install source (SPEC-110 §1–§2, §4). Throws on a tarball or
+ *  directory whose name can't be determined. */
+export function resolveSource(source, cwd = process.cwd()) {
+    const abs = isAbsolute(source) ? source : resolve(cwd, source);
+    if (existsSync(abs)) {
+        if (source.endsWith('.tgz') || source.endsWith('.tar.gz')) {
+            const { name, version } = readPackageJsonFromTarball(abs);
+            if (!name) {
+                throw new Error(`Could not read a package name from tarball "${source}".`);
+            }
+            return { name, version, installSource: abs, sourceType: 'tarball' };
+        }
+        const pkgPath = resolve(abs, 'package.json');
+        if (!existsSync(pkgPath)) {
+            throw new Error(`No package.json found in "${abs}".`);
+        }
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        if (!pkg.name) {
+            throw new Error(`package.json in "${abs}" is missing a "name" field.`);
+        }
+        return { name: pkg.name, version: pkg.version, installSource: `file:${abs}`, sourceType: 'directory' };
+    }
+    // Registry specifier — name resolved up front; version known after install.
+    return { name: parsePackageName(source), installSource: source, sourceType: 'registry' };
+}
+/** Build a package-manager add command, optionally pinned to a registry
+ *  (SPEC-110 §2). Credentials are the package manager's concern, not refrakt's. */
+export function buildInstallCommand(installSource, options = {}) {
+    const pm = detectPackageManager(options.cwd);
+    const base = pm.installCmd(installSource);
+    const cmd = options.registry ? `${base} --registry ${options.registry}` : base;
+    return { name: pm.name, cmd };
+}
+/** Read an installed package's manifest from node_modules (post-install). */
+export function readInstalledManifest(cwd, pkgName) {
+    const pkgPath = resolve(cwd, 'node_modules', pkgName, 'package.json');
+    if (!existsSync(pkgPath))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The current refrakt version, read from the CLI's own package.json. */
+export function getProjectRefraktVersion(cwd) {
+    // Prefer an installed @refrakt-md/types (the version the project builds against).
+    const fromTypes = readInstalledManifest(cwd, '@refrakt-md/types');
+    if (fromTypes?.version)
+        return String(fromTypes.version);
+    const fromTransform = readInstalledManifest(cwd, '@refrakt-md/transform');
+    if (fromTransform?.version)
+        return String(fromTransform.version);
+    return undefined;
+}
+/** Validate a distributable's declared `refrakt` range against the project
+ *  (ADR-023). Returns a list of human messages: hard errors first, then
+ *  warnings (e.g. a malformed range). */
+export function validateCompat(declaredRange, projectVersion) {
+    const errors = [];
+    const warnings = [];
+    if (!declaredRange)
+        return { errors, warnings };
+    if (!projectVersion) {
+        warnings.push(`could not determine the project's refrakt version to validate "${declaredRange}"`);
+        return { errors, warnings };
+    }
+    const result = checkRefraktCompat(declaredRange, projectVersion);
+    if (!result.ok) {
+        if (result.malformed)
+            warnings.push(result.message);
+        else
+            errors.push(result.message);
+    }
+    return { errors, warnings };
+}
+/** Validate a theme's runtime exports, framework-aware (ADR-024): `./transform`
+ *  is the required contract; a framework export (`./svelte`, …) is optional and
+ *  its absence is NOT a warning. Returns warnings only. */
+export function validateThemeExports(manifest) {
+    const warnings = [];
+    if (!manifest)
+        return ['Theme directory not found in node_modules — install may have failed'];
+    const exportsMap = (manifest.exports ?? {});
+    if (!exportsMap['./transform']) {
+        warnings.push('Theme is missing ./transform export — CSS tree-shaking and identity-transform config will be unavailable');
+    }
+    return warnings;
+}
+/** List the framework component layers a theme provides (ADR-024). Empty = a
+ *  framework-agnostic theme, which is normal. */
+export function detectFrameworkLayers(manifest) {
+    if (!manifest)
+        return [];
+    const exportsMap = (manifest.exports ?? {});
+    const layers = [];
+    if (exportsMap['./svelte'] || exportsMap['./svelte/index.js'])
+        layers.push('svelte');
+    return layers;
+}
+// ─── Preset-pack validation (SPEC-111 §2–§4) ────────────────────────────────
+/** Chrome (skeleton) token keys a `syntax`-scoped preset must NOT set. A syntax
+ *  preset may touch only `syntax.*` and `color.code.*`; anything else under
+ *  `color` is chrome and makes it a `palette` preset (SPEC-111 §2). */
+export function presetChromeKeys(config) {
+    const keys = new Set();
+    const scanColor = (color, prefix) => {
+        if (!color || typeof color !== 'object')
+            return;
+        for (const k of Object.keys(color)) {
+            if (k === 'code')
+                continue; // code surface is syntax-adjacent, allowed
+            keys.add(`${prefix}color.${k}`);
+        }
+    };
+    scanColor(config.color, '');
+    const modes = config.modes;
+    if (modes && typeof modes === 'object') {
+        for (const [mode, layer] of Object.entries(modes)) {
+            scanColor(layer?.color, `modes.${mode}.`);
+        }
+    }
+    return [...keys];
+}
+/** Validate one preset entry against its resolved token config (SPEC-111 §2–§4):
+ *  declared `syntax` that sets chrome → warning; malformed `tunedFor` → warning. */
+export function validatePresetEntry(entry, config) {
+    const errors = [];
+    const warnings = [];
+    const id = typeof entry.id === 'string' ? entry.id : '(unnamed)';
+    if (entry.scope !== 'syntax' && entry.scope !== 'palette') {
+        errors.push(`preset "${id}" has an invalid scope "${String(entry.scope)}" (expected "syntax" | "palette")`);
+    }
+    if (entry.tunedFor !== undefined) {
+        if (!Array.isArray(entry.tunedFor) || entry.tunedFor.some((t) => typeof t !== 'string')) {
+            warnings.push(`preset "${id}" has a malformed "tunedFor" (expected an array of theme package names)`);
+        }
+    }
+    if (config && entry.scope === 'syntax') {
+        const chrome = presetChromeKeys(config);
+        if (chrome.length > 0) {
+            warnings.push(`preset "${id}" is declared scope "syntax" but sets chrome tokens (${chrome.join(', ')}) — it is really a "palette" preset`);
+        }
+    }
+    return { errors, warnings };
+}
+// ─── Multi-site config helpers (SPEC-110 §3) ────────────────────────────────
+/** Enumerate the site keys declared by a config, in either shape. The singular
+ *  `site` shape reports as the implicit key `default`. */
+export function listSiteKeys(raw) {
+    if (raw.site)
+        return ['default'];
+    if (raw.sites)
+        return Object.keys(raw.sites);
+    return [];
+}
+/** Resolve which site an install targets.
+ *  - `existing`: pick the site to update. Inferred when exactly one exists;
+ *    ambiguous (→ list + exit) when multiple and no `--site`.
+ *  - `new`: the key must NOT collide with an existing site (full-site templates
+ *    don't overlay — SPEC-109). */
+export function resolveTargetSite(raw, siteFlag, mode) {
+    const keys = listSiteKeys(raw);
+    if (mode === 'existing') {
+        if (siteFlag) {
+            if (!keys.includes(siteFlag)) {
+                return { error: `site "${siteFlag}" is not declared in refrakt.config.json`, candidates: keys };
+            }
+            return { key: siteFlag };
+        }
+        if (keys.length <= 1)
+            return { key: keys[0] ?? 'default' };
+        return { error: 'multiple sites declared; pass --site <name> to choose one', candidates: keys };
+    }
+    // mode === 'new'
+    const key = siteFlag ?? 'default';
+    if (keys.includes(key)) {
+        return { error: `site "${key}" already exists; full-site templates create a new site (choose a fresh --site name)`, candidates: keys };
+    }
+    return { key };
+}
+/** Read a site's `SiteConfig` from either config shape by key. */
+function getSite(raw, key) {
+    if (key === 'default' && raw.site)
+        return raw.site;
+    return raw.sites?.[key];
+}
+/** Point a site's `theme` field at a package, preserving an existing object
+ *  form's `presets`/`tokens`/`modes`/`colorScheme`. Returns the previous
+ *  package name. The site must already exist. */
+export function setSiteTheme(raw, key, pkgName) {
+    const apply = (current) => {
+        if (current === undefined || typeof current === 'string') {
+            return { previous: typeof current === 'string' ? current : undefined, next: pkgName };
+        }
+        return { previous: current.package, next: { ...current, package: pkgName } };
+    };
+    const site = getSite(raw, key);
+    if (!site) {
+        // Fall back to the legacy flat top-level theme.
+        const { previous, next } = apply(raw.theme);
+        raw.theme = next;
+        return previous;
+    }
+    const { previous, next } = apply(site.theme);
+    site.theme = next;
+    return previous;
+}
+/** Append a preset module to a site's `theme.presets`, normalising a string
+ *  theme to the object form. No-op if already present. */
+export function appendSitePreset(raw, key, presetModule) {
+    const site = getSite(raw, key);
+    if (!site)
+        return;
+    const theme = site.theme;
+    const obj = typeof theme === 'string' ? { package: theme } : { ...(theme ?? { package: '' }) };
+    const presets = obj.presets ? [...obj.presets] : [];
+    if (!presets.includes(presetModule))
+        presets.push(presetModule);
+    obj.presets = presets;
+    site.theme = obj;
+}
+/** Create a new site entry under `key`, migrating a singular `site:` config to
+ *  the plural `sites: { default, <key> }` shape when adding a second site
+ *  (SPEC-110 §3). */
+export function createSite(raw, key, site) {
+    if (raw.sites) {
+        raw.sites[key] = site;
+        return;
+    }
+    if (raw.site) {
+        // Migrate singular → plural.
+        raw.sites = { default: raw.site, [key]: site };
+        delete raw.site;
+        return;
+    }
+    if (key === 'default') {
+        raw.site = site;
+    }
+    else {
+        raw.sites = { [key]: site };
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/presets.d.ts

@@ -0,0 +1,33 @@
+/** Preset-pack discovery, listing, and validation (SPEC-111 §4).
+ *
+ *  A preset pack is any installed package carrying a `presets.json` — a
+ *  capability scanned independently of `kind` (SPEC-111 §1), so a theme that
+ *  also ships presets is found here too. */
+import type { PresetScope } from '@refrakt-md/types';
+export interface PresetsListOptions {
+    scope?: PresetScope;
+}
+export interface PresetsValidateOptions {
+    /** Pack package name or directory; defaults to scanning all installed packs. */
+    pack?: string;
+}
+export interface PresetsInstallOptions {
+    source: string;
+    /** Preset id to append to the target site's `theme.presets`. */
+    use?: string;
+    site?: string;
+    registry?: string;
+}
+/** `refrakt theme presets list` — list presets from installed packs + the active
+ *  theme, filterable by `--scope` and flagged by compatibility (SPEC-111 §4). */
+export declare function themePresetsListCommand(options: PresetsListOptions): Promise<void>;
+/** `refrakt theme presets install <source>` — the lightest apply (SPEC-110 §4):
+ *  resolve via the shared resolver, add the dependency, validate `presets.json`
+ *  + compat, and optionally append `--use <id>` to the target site's
+ *  `theme.presets`. No scaffold-copy, no site creation, no `theme`-field change. */
+export declare function themePresetsInstallCommand(options: PresetsInstallOptions): Promise<void>;
+/** `refrakt theme presets validate` — validate pack manifests: scope vs actual
+ *  tokens (for JSON-carrier presets), `tunedFor` well-formedness, and module
+ *  resolvability (SPEC-111 §4). Returns a non-zero exit on errors. */
+export declare function themePresetsValidateCommand(options: PresetsValidateOptions): Promise<void>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/commands/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/commands/presets.ts"],"names":[],"mappings":"AAAA;;;;4CAI4C;AAI5C,OAAO,KAAK,EAAmC,WAAW,EAAE,MAAM,mBAAmB,CAAC;AActF,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACtC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAmDD;iFACiF;AACjF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BxF;AAUD;;;oFAGoF;AACpF,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD9F;AAED;;sEAEsE;AACtE,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhG"}

package/dist/commands/presets.js

@@ -0,0 +1,234 @@
+/** Preset-pack discovery, listing, and validation (SPEC-111 §4).
+ *
+ *  A preset pack is any installed package carrying a `presets.json` — a
+ *  capability scanned independently of `kind` (SPEC-111 §1), so a theme that
+ *  also ships presets is found here too. */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { execSync } from 'node:child_process';
+import { loadRefraktConfigFile, writeRefraktConfigFile } from '../config-file.js';
+import { validatePresetEntry, resolveSource, buildInstallCommand, readInstalledManifest, getProjectRefraktVersion, validateCompat, resolveTargetSite, appendSitePreset, } from './install.js';
+/** Find installed packages carrying a `presets.json`. */
+function discoverPacks(cwd) {
+    const modulesDir = resolve(cwd, 'node_modules');
+    if (!existsSync(modulesDir))
+        return [];
+    const packs = [];
+    const consider = (pkgDir, packageName) => {
+        const manifestPath = resolve(pkgDir, 'presets.json');
+        if (!existsSync(manifestPath))
+            return;
+        try {
+            const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            if (Array.isArray(manifest.presets))
+                packs.push({ packageName, dir: pkgDir, manifest });
+        }
+        catch {
+            // skip malformed
+        }
+    };
+    const isDir = (e) => e.isDirectory() || e.isSymbolicLink();
+    for (const entry of readdirSync(modulesDir, { withFileTypes: true })) {
+        if (!isDir(entry))
+            continue;
+        if (entry.name.startsWith('@')) {
+            const scopeDir = resolve(modulesDir, entry.name);
+            for (const sub of readdirSync(scopeDir, { withFileTypes: true })) {
+                if (isDir(sub))
+                    consider(resolve(scopeDir, sub.name), `${entry.name}/${sub.name}`);
+            }
+        }
+        else if (!entry.name.startsWith('.')) {
+            consider(resolve(modulesDir, entry.name), entry.name);
+        }
+    }
+    return packs;
+}
+/** Active theme package(s) across all sites — used to flag compatibility. */
+function activeThemes(raw) {
+    const out = new Set();
+    const add = (t) => {
+        if (!t)
+            return;
+        out.add(typeof t === 'string' ? t : t.package);
+    };
+    if (raw.site)
+        add(raw.site.theme);
+    for (const site of Object.values(raw.sites ?? {}))
+        add(site.theme);
+    add(raw.theme);
+    return [...out];
+}
+/** `refrakt theme presets list` — list presets from installed packs + the active
+ *  theme, filterable by `--scope` and flagged by compatibility (SPEC-111 §4). */
+export async function themePresetsListCommand(options) {
+    const cwd = process.cwd();
+    let raw;
+    try {
+        raw = loadRefraktConfigFile(cwd).raw;
+    }
+    catch {
+        // listing works without a project config; compatibility flags are just omitted
+    }
+    const themes = raw ? activeThemes(raw) : [];
+    const packs = discoverPacks(cwd);
+    if (packs.length === 0) {
+        console.log('No preset packs (packages with presets.json) found in node_modules.');
+        return;
+    }
+    let total = 0;
+    for (const pack of packs) {
+        const entries = pack.manifest.presets.filter((p) => !options.scope || p.scope === options.scope);
+        if (entries.length === 0)
+            continue;
+        console.log(`\n${pack.packageName}:`);
+        for (const p of entries) {
+            total++;
+            console.log(`  ${formatEntry(p, themes)}`);
+        }
+    }
+    if (total === 0) {
+        console.log(`No presets${options.scope ? ` with scope "${options.scope}"` : ''} found.`);
+    }
+    else if (themes.length) {
+        console.log(`\n  ⚠ = palette preset not tuned for the active theme (${themes.join(', ')}); still applies, may need adjustment`);
+    }
+}
+function formatEntry(p, activeThemeNames) {
+    const ref = `${p.id} — ${p.title} [${p.scope}]`;
+    // Universal (syntax, or no tunedFor) is always compatible.
+    if (p.scope === 'syntax' || !p.tunedFor || p.tunedFor.length === 0)
+        return ref;
+    const tuned = activeThemeNames.some((t) => p.tunedFor.includes(t));
+    return tuned ? ref : `⚠ ${ref}`;
+}
+/** `refrakt theme presets install <source>` — the lightest apply (SPEC-110 §4):
+ *  resolve via the shared resolver, add the dependency, validate `presets.json`
+ *  + compat, and optionally append `--use <id>` to the target site's
+ *  `theme.presets`. No scaffold-copy, no site creation, no `theme`-field change. */
+export async function themePresetsInstallCommand(options) {
+    const cwd = process.cwd();
+    let resolved;
+    try {
+        resolved = resolveSource(options.source, cwd);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+    const { name: pmName, cmd } = buildInstallCommand(resolved.installSource, { registry: options.registry, cwd });
+    console.log(`Using ${pmName} to install preset pack "${resolved.name}"...`);
+    try {
+        execSync(cmd, { cwd, stdio: 'inherit' });
+    }
+    catch {
+        console.error(`\nError: Failed to install. Command: ${cmd}`);
+        process.exit(1);
+    }
+    // Validate the installed pack's manifest + compat.
+    const packDir = resolve(cwd, 'node_modules', resolved.name);
+    const manifestPath = resolve(packDir, 'presets.json');
+    if (!existsSync(manifestPath)) {
+        console.error(`Error: "${resolved.name}" has no presets.json — it is not a preset pack.`);
+        process.exit(1);
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    const compat = validateCompat(manifest.refrakt ?? readInstalledManifest(cwd, resolved.name)?.refrakt, getProjectRefraktVersion(cwd));
+    for (const w of compat.warnings)
+        console.log(`  ⚠ ${w}`);
+    if (compat.errors.length) {
+        for (const e of compat.errors)
+            console.error(`  ✗ ${e}`);
+        console.error('The pack was installed but no preset was applied.');
+        process.exit(1);
+    }
+    // Optionally append the chosen preset to the target site.
+    if (options.use) {
+        const entry = manifest.presets.find((p) => p.id === options.use);
+        if (!entry) {
+            console.error(`Error: preset "${options.use}" not found in ${resolved.name} (have: ${manifest.presets.map((p) => p.id).join(', ')}).`);
+            process.exit(1);
+        }
+        const configData = loadRefraktConfigFile(cwd);
+        const selection = resolveTargetSite(configData.raw, options.site, 'existing');
+        if (!selection.key) {
+            console.error(`Error: ${selection.error}.`);
+            process.exit(1);
+        }
+        // The preset module identifier the loader resolves: package + export subpath.
+        const moduleId = `${resolved.name}/${entry.id}`;
+        appendSitePreset(configData.raw, selection.key, moduleId);
+        writeRefraktConfigFile(configData.path, configData.raw);
+        console.log(`\nApplied preset "${entry.id}" → ${selection.key !== 'default' ? `site "${selection.key}" ` : ''}theme.presets ("${moduleId}").`);
+        console.log('Ensure the pack exports that preset subpath (e.g. "./' + entry.id + '" → its module).');
+    }
+    else {
+        console.log(`\nInstalled. Apply a preset with: refrakt theme presets install ${options.source} --use <id>`);
+        console.log(`Available: ${manifest.presets.map((p) => p.id).join(', ')}`);
+    }
+}
+/** `refrakt theme presets validate` — validate pack manifests: scope vs actual
+ *  tokens (for JSON-carrier presets), `tunedFor` well-formedness, and module
+ *  resolvability (SPEC-111 §4). Returns a non-zero exit on errors. */
+export async function themePresetsValidateCommand(options) {
+    const cwd = process.cwd();
+    let packs = discoverPacks(cwd);
+    if (options.pack) {
+        packs = packs.filter((p) => p.packageName === options.pack);
+        if (packs.length === 0) {
+            // Allow a direct directory path.
+            const dir = resolve(cwd, options.pack);
+            const manifestPath = resolve(dir, 'presets.json');
+            if (existsSync(manifestPath)) {
+                packs = [{ packageName: options.pack, dir, manifest: JSON.parse(readFileSync(manifestPath, 'utf-8')) }];
+            }
+        }
+    }
+    if (packs.length === 0) {
+        console.error('No preset packs found to validate.');
+        process.exit(1);
+    }
+    let errors = 0;
+    let warnings = 0;
+    for (const pack of packs) {
+        console.log(`\n${pack.packageName}:`);
+        for (const entry of pack.manifest.presets) {
+            const modulePath = resolve(pack.dir, entry.module ?? '');
+            let config;
+            let resolveError;
+            if (!entry.module) {
+                resolveError = `preset "${entry.id}" has no "module"`;
+            }
+            else if (!existsSync(modulePath)) {
+                resolveError = `preset "${entry.id}" module "${entry.module}" does not resolve`;
+            }
+            else if (entry.module.endsWith('.json')) {
+                // JSON carrier — read directly for scope-vs-tokens validation.
+                try {
+                    config = JSON.parse(readFileSync(modulePath, 'utf-8'));
+                }
+                catch (err) {
+                    resolveError = `preset "${entry.id}" JSON is invalid: ${err.message}`;
+                }
+            }
+            // JS/TS carriers aren't loaded here (may need a build) — scope-vs-tokens
+            // is skipped for them, but resolvability is still checked.
+            const { errors: e, warnings: w } = validatePresetEntry(entry, config);
+            const all = [...(resolveError ? [resolveError] : []), ...e];
+            for (const msg of all) {
+                console.log(`  ✗ ${msg}`);
+                errors++;
+            }
+            for (const msg of w) {
+                console.log(`  ⚠ ${msg}`);
+                warnings++;
+            }
+            if (all.length === 0 && w.length === 0)
+                console.log(`  ✓ ${entry.id} [${entry.scope}]`);
+        }
+    }
+    console.log(`\n${errors} error(s), ${warnings} warning(s).`);
+    if (errors > 0)
+        process.exit(1);
+}
+//# sourceMappingURL=presets.js.map

package/dist/commands/presets.js.map

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

package/dist/commands/template.d.ts

@@ -0,0 +1,20 @@
+/** `refrakt template install` — add a full-site template as a NEW site in an
+ *  existing project (SPEC-110 §4 kind:"site"). The greenfield path is
+ *  `create-refrakt --template`; this is the add-to-existing-project surface.
+ *
+ *  v1 resolves a **local directory** template (the directly-readable, portable
+ *  case). Tarball/registry templates are scaffold-copied artifacts — fetch them
+ *  with `create-refrakt` for now. */
+import type { RefraktConfig } from '@refrakt-md/types';
+export interface TemplateInstallOptions {
+    source: string;
+    site?: string;
+}
+/** Compose a template into a new site of `raw` and return the dependency names
+ *  to install. Pure w.r.t. the package manager (caller installs). Copies the
+ *  template's content/sandboxes into the new site's derived destinations. */
+export declare function applyTemplateSite(raw: RefraktConfig, templateDir: string, siteKey: string, projectRoot: string): {
+    deps: string[];
+};
+export declare function templateInstallCommand(options: TemplateInstallOptions): Promise<void>;
+//# sourceMappingURL=template.d.ts.map

package/dist/commands/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;;qCAMqC;AAKrC,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AASnE,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAQD;;6EAE6E;AAC7E,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA8BpB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD3F"}