@stag-build/phonebook 0.1.0

package/dist/ios/snapshotTestClass.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Scans a project's .swift files for a `class X: SnapshotTest` subclass,
+ * skipping build-output/dependency directories (.build, DerivedData, Pods,
+ * .git) and any path segment named "checkouts" — SPM package sources
+ * (including SnapshotPreviews' own SnapshotTest subclasses, if any) must not
+ * count towards this check.
+ */
+export declare function findSnapshotTestSubclass(projectDir: string): Promise<{
+    className: string;
+    relativePath: string;
+    importsSnapshottingTests: boolean;
+} | undefined>;
+/**
+ * Reads the project's .pbxproj text: from the configured `ios.project` path
+ * when given, otherwise by discovering the first *.xcodeproj directly under
+ * projectDir (mirroring how `doctor` locates it for a workspace-only config).
+ */
+export declare function readPbxprojText(projectDir: string, projectPath?: string): Promise<string>;
+/** A PBXNativeTarget whose body references SnapshottingTests (i.e. links the product). */
+export interface SnapshottingTestsTarget {
+    id: string;
+    name: string;
+    body: string;
+}
+/**
+ * Finds every PBXNativeTarget in the pbxproj that links the SnapshottingTests
+ * product. In practice there's exactly one (the app-hosted unit-test target);
+ * returned as a list to stay defensive.
+ */
+export declare function findSnapshottingTestsTargets(pbxproj: string): SnapshottingTestsTarget[];
+/**
+ * Heuristically checks whether the pbxproj target that links
+ * SnapshottingTests has TEST_HOST/BUNDLE_LOADER set in any of its build
+ * configurations (i.e. is hosted in the app, as SnapshotPreviews requires).
+ * Returns a note string when the wiring is present but hosting can't be
+ * confirmed; undefined otherwise (including when parsing fails — this is a
+ * best-effort heuristic, not a hard failure).
+ */
+export declare function findMissingTestHostNote(pbxproj: string): string | undefined;
+/** Where to put the missing SnapshotTest subclass, derived from the pbxproj. */
+export interface SnapshotTestClassLocation {
+    /** Name of the PBXNativeTarget that links SnapshottingTests. */
+    targetName: string;
+    /**
+     * Folder path (relative to the project, "/"-joined) covered by a
+     * PBXFileSystemSynchronizedRootGroup tied to the target, if the project
+     * uses Xcode's synchronized groups (objectVersion >= ~77). When set,
+     * simply creating a .swift file in this folder is enough — Xcode picks it
+     * up automatically, no project-file edit required.
+     */
+    synchronizedFolder?: string;
+}
+/**
+ * Identifies the target that links SnapshottingTests and, for a project
+ * using filesystem-synchronized groups, the folder a new source file can be
+ * dropped into to be picked up automatically. Best-effort/heuristic — returns
+ * undefined if the target can't be identified or parsing fails.
+ */
+export declare function findSnapshotTestClassLocation(pbxproj: string): SnapshotTestClassLocation | undefined;

package/dist/ios/snapshotTestClass.js

@@ -0,0 +1,195 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+/**
+ * Shared iOS SnapshotTest-subclass discovery: scanning project sources for an
+ * existing subclass, and (heuristically) parsing a .pbxproj to find which
+ * target links SnapshottingTests, whether it's properly hosted (TEST_HOST),
+ * and — for projects using Xcode's filesystem-synchronized groups — which
+ * folder a new file should be dropped into.
+ *
+ * Used by both `doctor` (to report on the setup) and `init --write-snapshot-class`
+ * (to safely write the missing file). Lives outside doctor.ts/init.ts to avoid a
+ * circular import between those two modules.
+ */
+const SNAPSHOT_TEST_SUBCLASS_PATTERN = /class\s+(\w+)\s*:\s*SnapshotTest\b/;
+const SNAPSHOT_TEST_SCAN_SKIP_DIRS = new Set(['.build', 'DerivedData', 'Pods', '.git']);
+async function readTextIfExists(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Scans a project's .swift files for a `class X: SnapshotTest` subclass,
+ * skipping build-output/dependency directories (.build, DerivedData, Pods,
+ * .git) and any path segment named "checkouts" — SPM package sources
+ * (including SnapshotPreviews' own SnapshotTest subclasses, if any) must not
+ * count towards this check.
+ */
+export async function findSnapshotTestSubclass(projectDir) {
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return undefined;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SNAPSHOT_TEST_SCAN_SKIP_DIRS.has(entry.name) || entry.name === 'checkouts')
+                    continue;
+                const found = await walk(full);
+                if (found)
+                    return found;
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith('.swift'))
+                continue;
+            const text = await readTextIfExists(full);
+            const match = text.match(SNAPSHOT_TEST_SUBCLASS_PATTERN);
+            if (match) {
+                return {
+                    className: match[1],
+                    relativePath: relative(projectDir, full),
+                    // The SnapshotTest base class lives in the SnapshottingTests module;
+                    // any other import (e.g. SnapshotPreviews) fails to compile.
+                    importsSnapshottingTests: /^\s*import\s+SnapshottingTests\b/m.test(text),
+                };
+            }
+        }
+        return undefined;
+    }
+    return walk(projectDir);
+}
+/**
+ * Extracts the bodies of every object with the given `isa` from a raw
+ * .pbxproj text, keyed by object id. Minimal/defensive regex parsing — no
+ * plist library — matched against the standard pbxproj indentation.
+ */
+function extractPbxprojObjects(pbxproj, isa) {
+    const map = new Map();
+    const re = new RegExp(`\\n\\t\\t([0-9A-F]{24}) [^\\n]*=\\s*\\{\\n\\t\\t\\tisa = ${isa};([\\s\\S]*?)\\n\\t\\t\\};`, 'g');
+    let match;
+    while ((match = re.exec(pbxproj))) {
+        map.set(match[1], match[2]);
+    }
+    return map;
+}
+function unquote(value) {
+    const trimmed = value.trim();
+    return trimmed.startsWith('"') && trimmed.endsWith('"') ? trimmed.slice(1, -1) : trimmed;
+}
+/**
+ * Reads the project's .pbxproj text: from the configured `ios.project` path
+ * when given, otherwise by discovering the first *.xcodeproj directly under
+ * projectDir (mirroring how `doctor` locates it for a workspace-only config).
+ */
+export async function readPbxprojText(projectDir, projectPath) {
+    if (projectPath) {
+        return readTextIfExists(join(projectPath, 'project.pbxproj'));
+    }
+    try {
+        const texts = [];
+        for (const entry of await readdir(projectDir)) {
+            if (entry.endsWith('.xcodeproj')) {
+                const text = await readTextIfExists(join(projectDir, entry, 'project.pbxproj'));
+                if (text)
+                    texts.push(text);
+            }
+        }
+        return texts.join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Finds every PBXNativeTarget in the pbxproj that links the SnapshottingTests
+ * product. In practice there's exactly one (the app-hosted unit-test target);
+ * returned as a list to stay defensive.
+ */
+export function findSnapshottingTestsTargets(pbxproj) {
+    const targets = extractPbxprojObjects(pbxproj, 'PBXNativeTarget');
+    const result = [];
+    for (const [id, body] of targets) {
+        if (!body.includes('SnapshottingTests'))
+            continue;
+        const nameMatch = body.match(/\n\t\t\tname = ([^\n;]+);/);
+        result.push({ id, name: nameMatch ? unquote(nameMatch[1]) : id, body });
+    }
+    return result;
+}
+/**
+ * Heuristically checks whether the pbxproj target that links
+ * SnapshottingTests has TEST_HOST/BUNDLE_LOADER set in any of its build
+ * configurations (i.e. is hosted in the app, as SnapshotPreviews requires).
+ * Returns a note string when the wiring is present but hosting can't be
+ * confirmed; undefined otherwise (including when parsing fails — this is a
+ * best-effort heuristic, not a hard failure).
+ */
+export function findMissingTestHostNote(pbxproj) {
+    if (!pbxproj.includes('SnapshottingTests'))
+        return undefined;
+    try {
+        const targets = findSnapshottingTestsTargets(pbxproj);
+        const configLists = extractPbxprojObjects(pbxproj, 'XCConfigurationList');
+        const buildConfigs = extractPbxprojObjects(pbxproj, 'XCBuildConfiguration');
+        for (const target of targets) {
+            const confListMatch = target.body.match(/buildConfigurationList = ([0-9A-F]{24})/);
+            const confListBody = confListMatch ? configLists.get(confListMatch[1]) : undefined;
+            if (!confListBody)
+                continue;
+            const buildConfigIds = [...confListBody.matchAll(/([0-9A-F]{24}) \/\*/g)].map((m) => m[1]);
+            if (buildConfigIds.length === 0)
+                continue;
+            const hasHost = buildConfigIds.some((id) => {
+                const cfgBody = buildConfigs.get(id);
+                return cfgBody !== undefined && (cfgBody.includes('TEST_HOST') || cfgBody.includes('BUNDLE_LOADER'));
+            });
+            if (!hasHost) {
+                return 'the target linking SnapshottingTests appears to have no TEST_HOST; SnapshotPreviews must run in a test target hosted in the app';
+            }
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Identifies the target that links SnapshottingTests and, for a project
+ * using filesystem-synchronized groups, the folder a new source file can be
+ * dropped into to be picked up automatically. Best-effort/heuristic — returns
+ * undefined if the target can't be identified or parsing fails.
+ */
+export function findSnapshotTestClassLocation(pbxproj) {
+    try {
+        const targets = findSnapshottingTestsTargets(pbxproj);
+        if (targets.length === 0)
+            return undefined;
+        const target = targets[0];
+        const syncGroups = extractPbxprojObjects(pbxproj, 'PBXFileSystemSynchronizedRootGroup');
+        const groupsMatch = target.body.match(/fileSystemSynchronizedGroups = \(([\s\S]*?)\)/);
+        let synchronizedFolder;
+        if (groupsMatch) {
+            const groupIds = [...groupsMatch[1].matchAll(/([0-9A-F]{24})/g)].map((m) => m[1]);
+            for (const gid of groupIds) {
+                const groupBody = syncGroups.get(gid);
+                const pathMatch = groupBody?.match(/\n\t\t\tpath = ([^\n;]+);/);
+                if (pathMatch) {
+                    synchronizedFolder = unquote(pathMatch[1]);
+                    break;
+                }
+            }
+        }
+        return { targetName: target.name, synchronizedFolder };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=snapshotTestClass.js.map

package/dist/ios/snapshotTestClass.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,32 @@
+export declare const SCHEMA_VERSION = 1;
+export type Platform = 'android' | 'ios';
+export interface ManifestEntry {
+    /** Display name of the component, e.g. "Button" */
+    component: string;
+    /** Display name of the state, e.g. "Disabled" */
+    state: string;
+    /** Gradle module / Xcode target the preview lives in */
+    module: string;
+    /** Path of the source file containing the preview, relative to the project root, when known */
+    sourceFile?: string;
+    /** Fully qualified original preview identifier (FQN of the preview function / test) */
+    previewName: string;
+    /** Image path relative to the bundle root, e.g. "images/ab12cd.png" */
+    image: string;
+    width?: number;
+    height?: number;
+    theme?: 'light' | 'dark';
+    device?: string;
+    tags?: string[];
+}
+export interface Manifest {
+    schemaVersion: typeof SCHEMA_VERSION;
+    platform: Platform;
+    app: {
+        name: string;
+        commit?: string;
+        generatedAt: string;
+    };
+    entries: ManifestEntry[];
+}
+export declare function validateManifest(data: unknown): Manifest;

package/dist/manifest.js

@@ -0,0 +1,23 @@
+export const SCHEMA_VERSION = 1;
+export function validateManifest(data) {
+    const m = data;
+    if (!m || typeof m !== 'object')
+        throw new Error('manifest.json is not an object');
+    if (m.schemaVersion !== SCHEMA_VERSION) {
+        throw new Error(`Unsupported manifest schemaVersion ${m.schemaVersion}, expected ${SCHEMA_VERSION}`);
+    }
+    if (m.platform !== 'android' && m.platform !== 'ios') {
+        throw new Error(`Unknown platform "${m.platform}"`);
+    }
+    if (!Array.isArray(m.entries))
+        throw new Error('manifest.entries is not an array');
+    for (const e of m.entries) {
+        for (const key of ['component', 'state', 'module', 'previewName', 'image']) {
+            if (typeof e[key] !== 'string' || e[key].length === 0) {
+                throw new Error(`manifest entry missing "${key}": ${JSON.stringify(e)}`);
+            }
+        }
+    }
+    return m;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAmChC,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,CAAC,GAAG,IAAgB,CAAC;IAC3B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACnF,IAAI,CAAC,CAAC,aAAa,KAAK,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,aAAa,cAAc,cAAc,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAU,EAAE,CAAC;YACpF,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1 @@
+export declare function runMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,226 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { collectDoctorChecks } from '../commands/doctor.js';
+import { generateAndroid } from '../engines/android.js';
+import { generateIos } from '../engines/ios.js';
+import { buildSite } from '../site/build.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function readPackageVersion() {
+    try {
+        const raw = await readFile(resolve(__dirname, '../../package.json'), 'utf8');
+        const pkg = JSON.parse(raw);
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function errorResult(message) {
+    return { isError: true, content: [{ type: 'text', text: message }] };
+}
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function summarizeCoverage(report) {
+    const { stats } = report;
+    const withoutPreview = stats.components - stats.withPreview;
+    const orphanCount = report.orphanPreviews.length;
+    return [
+        `Components: ${stats.components}`,
+        `With preview: ${stats.withPreview}`,
+        `Without preview: ${withoutPreview}`,
+        `With dark preview: ${stats.withDarkPreview}`,
+        orphanCount > 0
+            ? `Orphan previews (could not be matched to a component in the same file): ${orphanCount}`
+            : `Orphan previews (unmatched to a component): ${orphanCount}`,
+    ].join('\n');
+}
+const HINT_LIST_CAP = 40;
+function summarizeHints(report) {
+    const allPreviews = [
+        ...report.components.flatMap((c) => c.previews),
+        ...report.orphanPreviews,
+    ];
+    const entries = allPreviews.flatMap((p) => (p.hints ?? []).map((h) => ({
+        file: p.file,
+        line: p.line,
+        functionName: p.name,
+        hint: h,
+    })));
+    if (entries.length === 0) {
+        return 'Configuration hints (0)';
+    }
+    const shown = entries.slice(0, HINT_LIST_CAP);
+    const lines = shown.map((e) => `${e.file}:${e.line} ${e.functionName} [${e.hint.rule}] ${e.hint.message} -> ${e.hint.suggestion}`);
+    const remaining = entries.length - shown.length;
+    if (remaining > 0) {
+        lines.push(`... and ${remaining} more (see JSON)`);
+    }
+    return [`Configuration hints (${entries.length})`, ...lines].join('\n');
+}
+const NAMING_GUIDANCE = `Naming convention (see docs/naming-convention.md):
+1. A display name containing "/" splits into component/state (e.g. "Button/Enabled").
+2. A display name without "/" becomes the state; the component comes from the function name.
+3. No display name: the function name (minus a leading/trailing "Preview") is the component, and the state is "Default".
+Component names are camel-case-spaced ("UserCard" -> "User Card", acronym runs kept together: "URLBar" -> "URL Bar").
+Dark mode: Android infers "Dark" state from uiMode = UI_MODE_NIGHT_YES and strips a trailing Dark/Night suffix from the function name; iOS has no such inference, so give the preview an explicit "Component/Dark" name and add .preferredColorScheme(.dark).
+
+Configuration hints: analyze_coverage also flags previews whose name implies a configuration (landscape, dark, tablet, RTL, large font, ...) that the annotation doesn't actually declare — e.g. a function named "...Landscape" with a plain @Preview() renders portrait. Fix by adding the declared trait the hint suggests (device/orientation spec, uiMode, locale, fontScale, traits: for iOS, etc.), or renaming if the config was never intended.
+
+Canvas size (Android): preview dimensions come only from the @Preview annotation — widthDp/heightDp or device = "spec:width=..dp,height=..dp,...". Wrapping the composable in Modifier.size(...)/width(...)/height(...) in the preview body does NOT resize the canvas: the content is sized inside a canvas that stays the default phone size, so wide or large content is clipped, not fit. Correct: @Preview(widthDp = 891, heightDp = 411) fun ... { LoginContentLandscape() } — no size Modifier needed.
+
+Canvas size (iOS): preview dimensions come from traits: (e.g. .fixedLayout(width:height:)) or .previewDevice on the #Preview, not from a frame modifier in the view body.
+
+Snapshot test class (iOS): the SnapshotTest subclass that records previews must live in the app-hosted unit-test target's own folder (the target linking SnapshottingTests, hosted via TEST_HOST/BUNDLE_LOADER) — run \`phonebook doctor\` to see which target and where. In a project using Xcode's filesystem-synchronized groups, just creating the file in that folder is enough (Xcode picks it up automatically); \`phonebook init --write-snapshot-class\` can do this for you when that condition holds.`;
+function androidTemplate(component, states) {
+    const name = component || 'Component';
+    const stateList = states.length > 0 ? states : ['Default'];
+    const blocks = stateList
+        .filter((s) => s.toLowerCase() !== 'dark')
+        .map((state) => `@Preview(name = "${name}/${state}")
+@Composable
+private fun ${name}${state}Preview() {
+    ${name}(/* TODO: pass ${state} state props */)
+}`)
+        .join('\n\n');
+    const dark = `@Preview(name = "${name}/Dark", uiMode = Configuration.UI_MODE_NIGHT_YES)
+@Composable
+private fun ${name}DarkPreview() {
+    ${name}(/* TODO: pass default props */)
+}`;
+    return `${blocks}\n\n${dark}`;
+}
+function iosTemplate(component, states) {
+    const name = component || 'Component';
+    const stateList = states.length > 0 ? states : ['Default'];
+    const blocks = stateList
+        .filter((s) => s.toLowerCase() !== 'dark')
+        .map((state) => `#Preview("${name}/${state}", traits: .sizeThatFitsLayout) {
+    ${name}(/* TODO: pass ${state} state props */)
+}`)
+        .join('\n\n');
+    const dark = `#Preview("${name}/Dark", traits: .sizeThatFitsLayout) {
+    ${name}(/* TODO: pass default props */)
+        .preferredColorScheme(.dark)
+}`;
+    return `${blocks}\n\n${dark}`;
+}
+export async function runMcpServer() {
+    const version = await readPackageVersion();
+    const server = new McpServer({ name: 'phonebook', version });
+    server.registerTool('analyze_coverage', {
+        description: 'Scan the codebase for UI components and the previews that cover them: which have previews, which states/themes are missing. Read-only.',
+        inputSchema: {
+            dir: z.string().default('.').describe('Project directory containing phonebook.config.json'),
+        },
+    }, async ({ dir }) => {
+        let projectDir;
+        let platform;
+        let modules;
+        try {
+            const loaded = await loadConfig(dir);
+            projectDir = loaded.projectDir;
+            platform = loaded.config.platform;
+            modules = loaded.config.android?.modules ?? [':app'];
+        }
+        catch (err) {
+            return errorResult(`${err.message}\nRun \`phonebook init\` first to scaffold phonebook.config.json.`);
+        }
+        let report;
+        try {
+            if (platform === 'android') {
+                const { scanAndroid } = await import('../scan/android.js');
+                report = await scanAndroid(projectDir, modules);
+            }
+            else {
+                const { scanIos } = await import('../scan/ios.js');
+                report = await scanIos(projectDir);
+            }
+        }
+        catch (err) {
+            return errorResult(`Failed to analyze coverage: ${err.message}`);
+        }
+        const summary = summarizeCoverage(report);
+        const hints = summarizeHints(report);
+        return textResult(`${summary}\n\n${hints}\n\n${JSON.stringify(report, null, 2)}`);
+    });
+    server.registerTool('check_setup', {
+        description: "Check that the project is correctly set up for `phonebook generate` (same checks as `phonebook doctor`): libraries wired, test target present, JDK/Xcode/simulator available.",
+        inputSchema: {
+            dir: z.string().default('.').describe('Project directory containing phonebook.config.json'),
+        },
+    }, async ({ dir }) => {
+        const { lines, ok } = await collectDoctorChecks(dir);
+        const text = [...lines, ok ? 'READY' : 'NOT READY'].join('\n');
+        return textResult(text);
+    });
+    server.registerTool('get_preview_guidance', {
+        description: 'Return the preview naming convention plus a ready-to-paste preview code template for a component, so any agent writes consistent previews.',
+        inputSchema: {
+            platform: z.enum(['android', 'ios']).describe('Target platform'),
+            component: z.string().optional().describe('Component name, e.g. "Button"'),
+            states: z.array(z.string()).optional().describe('State names, e.g. ["Enabled", "Disabled"]'),
+        },
+    }, async ({ platform, component, states }) => {
+        const name = component ?? 'Component';
+        const stateList = states && states.length > 0 ? states : ['Default'];
+        const template = platform === 'android' ? androidTemplate(name, stateList) : iosTemplate(name, stateList);
+        const text = `${NAMING_GUIDANCE}\n\nTemplate for ${name} (${platform}):\n\n${template}`;
+        return textResult(text);
+    });
+    server.registerTool('run_generate', {
+        description: 'Run the platform engine to render all previews and produce a bundle (manifest + images), same as `phonebook generate`.',
+        inputSchema: {
+            dir: z.string().default('.').describe('Project directory containing phonebook.config.json'),
+        },
+    }, async ({ dir }) => {
+        let projectDir;
+        try {
+            const loaded = await loadConfig(dir);
+            projectDir = loaded.projectDir;
+            const outputDir = resolve(projectDir, loaded.config.output ?? 'phonebook-out');
+            const manifest = loaded.config.platform === 'android'
+                ? await generateAndroid(loaded.config, projectDir, outputDir, { quiet: true })
+                : await generateIos(loaded.config, projectDir, outputDir, { quiet: true });
+            const componentStates = manifest.entries.map((e) => `${e.component}/${e.state}`).sort();
+            const text = [
+                `Recorded ${manifest.entries.length} previews -> ${outputDir}`,
+                '',
+                ...componentStates,
+            ].join('\n');
+            return textResult(text);
+        }
+        catch (err) {
+            return errorResult(`${err.message}\nRun the check_setup tool (or \`phonebook doctor\`) to diagnose the project setup.`);
+        }
+    });
+    server.registerTool('run_build', {
+        description: 'Build the static gallery site from a bundle, same as `phonebook build <bundle>`.',
+        inputSchema: {
+            bundle: z.string().describe('Bundle directory produced by run_generate / `phonebook generate`'),
+            output: z
+                .string()
+                .optional()
+                .describe('Site output directory (default: the bundle directory itself, reusing its images)'),
+        },
+    }, async ({ bundle, output }) => {
+        try {
+            // Default to building in place so the site reuses the bundle's images
+            // instead of duplicating every screenshot into a sibling directory.
+            const outDir = output ? resolve(output) : resolve(bundle);
+            const count = await buildSite(resolve(bundle), outDir);
+            return textResult(`Built gallery with ${count} screenshots -> ${outDir}/index.html`);
+        }
+        catch (err) {
+            return errorResult(err.message);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/naming.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Naming convention: turn a raw preview identifier into { component, state }.
+ *
+ * Precedence:
+ * 1. An explicit preview display name containing "/" splits into component/state
+ *    (e.g. @Preview(name = "Button/Disabled")).
+ * 2. An explicit preview display name without "/" becomes the state; the
+ *    component is derived from the function name.
+ * 3. Otherwise the function name minus a leading/trailing "Preview" is the
+ *    component and the state is "Default".
+ */
+export interface ComponentState {
+    component: string;
+    state: string;
+}
+export declare function parsePreviewName(functionName: string, displayName?: string): ComponentState;
+/** "PrimaryButton" -> "Primary Button"; leaves acronym runs intact ("URLBar" -> "URL Bar") */
+export declare function spaceCamelCase(s: string): string;

package/dist/naming.js

@@ -0,0 +1,34 @@
+export function parsePreviewName(functionName, displayName) {
+    const component = stripPreview(functionName);
+    const name = displayName?.trim();
+    if (name) {
+        const slash = name.indexOf('/');
+        if (slash > 0 && slash < name.length - 1) {
+            return {
+                component: spaceCamelCase(name.slice(0, slash).trim()),
+                state: name.slice(slash + 1).trim(),
+            };
+        }
+        return { component, state: name };
+    }
+    return { component, state: 'Default' };
+}
+function stripPreview(functionName) {
+    let n = functionName;
+    if (n.endsWith('Preview'))
+        n = n.slice(0, -'Preview'.length);
+    else if (n.startsWith('Preview'))
+        n = n.slice('Preview'.length);
+    if (n.length === 0)
+        n = functionName;
+    return spaceCamelCase(n);
+}
+/** "PrimaryButton" -> "Primary Button"; leaves acronym runs intact ("URLBar" -> "URL Bar") */
+export function spaceCamelCase(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .replace(/_/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,WAAoB;IACzE,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;aACpC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,YAAoB;IACxC,IAAI,CAAC,GAAG,YAAY,CAAC;IACrB,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SACxD,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,CAAC,GAAG,YAAY,CAAC;IACrC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,CAAC;SACL,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/scan/android.d.ts

@@ -0,0 +1,7 @@
+import type { CoverageReport } from './types.js';
+/**
+ * Regex-based heuristic scanner for Jetpack Compose `@Composable` / `@Preview`
+ * functions. Walks each module's `src/main` tree and matches previews to
+ * components by file + name-prefix.
+ */
+export declare function scanAndroid(projectDir: string, modules: string[]): Promise<CoverageReport>;