@stag-build/phonebook 0.1.0

package/dist/scan/android.js

@@ -0,0 +1,222 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { previewHints } from './hints.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 async function scanAndroid(projectDir, modules) {
+    const components = [];
+    const orphanPreviews = [];
+    for (const module of modules) {
+        const moduleDir = join(projectDir, ...module.split(':').filter(Boolean));
+        const srcRoot = join(moduleDir, 'src', 'main');
+        const files = await walkKotlinFiles(srcRoot);
+        for (const file of files) {
+            const relFile = relative(projectDir, file);
+            const content = await readFile(file, 'utf8');
+            const { fileComponents, filePreviews } = scanKotlinFile(content, relFile);
+            for (const comp of fileComponents)
+                components.push(comp);
+            matchPreviewsToComponents(filePreviews, fileComponents, orphanPreviews);
+        }
+    }
+    components.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+    orphanPreviews.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+    return {
+        platform: 'android',
+        components,
+        orphanPreviews,
+        stats: computeStats(components, orphanPreviews),
+    };
+}
+function scanKotlinFile(content, relFile) {
+    const functions = findAnnotatedFunctions(content);
+    const fileComponents = [];
+    const filePreviews = [];
+    const previewComposables = [];
+    for (const fn of functions) {
+        const isComposable = /@Composable\b/.test(fn.annotations);
+        if (!isComposable)
+            continue;
+        const previewMatches = [...fn.annotations.matchAll(/@Preview\b(\([^)]*\))?/g)];
+        if (previewMatches.length > 0) {
+            // @Preview @Composable: either a wrapper preview of a separate component, or
+            // a "self-preview" (a screen-level composable that previews itself via
+            // default parameters). Decided below once all non-preview components in the
+            // file are known.
+            let displayName;
+            let dark = false;
+            for (const m of previewMatches) {
+                const args = m[1] ?? '';
+                const nameMatch = args.match(/name\s*=\s*"([^"]*)"/);
+                if (nameMatch && !displayName)
+                    displayName = nameMatch[1];
+                if (/UI_MODE_NIGHT_YES/.test(args))
+                    dark = true;
+            }
+            if (/(Dark|Night)$/.test(fn.name))
+                dark = true;
+            const annotationText = previewMatches.map((m) => m[0]).join('\n');
+            const bodyText = captureBodyText(content, fn.funIndex);
+            const hints = previewHints({
+                platform: 'android',
+                functionName: fn.name,
+                displayName,
+                annotationText,
+                bodyText,
+            });
+            previewComposables.push({
+                fn,
+                preview: {
+                    name: fn.name,
+                    ...(displayName ? { displayName } : {}),
+                    file: relFile,
+                    line: fn.line,
+                    dark,
+                    annotationText,
+                    ...(bodyText ? { bodyText } : {}),
+                    ...(hints.length > 0 ? { hints } : {}),
+                },
+            });
+        }
+        else {
+            fileComponents.push({
+                name: fn.name,
+                file: relFile,
+                line: fn.line,
+                previews: [],
+            });
+        }
+    }
+    // Classify each @Preview-annotated composable: if its name matches an existing
+    // non-preview component in this file by the prefix heuristic, it's a wrapper
+    // preview of that component (existing behavior). Otherwise it's a self-preview:
+    // the function is both a component and its own preview.
+    for (const { fn, preview } of previewComposables) {
+        const wrapperTarget = bestPrefixMatch(fn.name, fileComponents);
+        if (wrapperTarget) {
+            filePreviews.push(preview);
+        }
+        else {
+            fileComponents.push({
+                name: fn.name,
+                file: relFile,
+                line: fn.line,
+                previews: [preview],
+            });
+        }
+    }
+    return { fileComponents, filePreviews };
+}
+/** Longest-name-prefix match, same heuristic as `matchPreviewsToComponents`. */
+function bestPrefixMatch(name, components) {
+    let best;
+    for (const comp of components) {
+        if (name.startsWith(comp.name)) {
+            if (!best || comp.name.length > best.name.length)
+                best = comp;
+        }
+    }
+    return best;
+}
+/**
+ * Finds `fun Name(` declarations preceded by uppercase-first names, along with
+ * the block of annotations (e.g. `@Composable`, `@Preview(...)`) found within
+ * roughly 5 lines above the `fun` keyword.
+ */
+function findAnnotatedFunctions(content) {
+    const results = [];
+    const funRegex = /\bfun\s+([A-Z]\w*)\s*\(/g;
+    let match;
+    while ((match = funRegex.exec(content)) !== null) {
+        const name = match[1];
+        const funIndex = match.index;
+        const line = lineNumberAt(content, funIndex);
+        // Look back up to 5 lines above the `fun` line for annotations.
+        const linesBefore = content.slice(0, funIndex).split('\n');
+        const contextLines = linesBefore.slice(Math.max(0, linesBefore.length - 6));
+        const annotations = contextLines.join('\n');
+        results.push({ name, line, annotations, funIndex });
+    }
+    return results;
+}
+function lineNumberAt(content, index) {
+    let line = 1;
+    for (let i = 0; i < index; i++) {
+        if (content[i] === '\n')
+            line++;
+    }
+    return line;
+}
+const BODY_LINE_CAP = 20;
+/** Captures the preview function's body from its opening brace, capped to ~20 lines.
+ * A simple line cap (no brace matching) -- good enough for hints to pattern-match against. */
+function captureBodyText(content, funIndex) {
+    const braceIndex = content.indexOf('{', funIndex);
+    if (braceIndex === -1)
+        return undefined;
+    const lines = content.slice(braceIndex).split('\n').slice(0, BODY_LINE_CAP);
+    return lines.join('\n');
+}
+/**
+ * Matches previews to components using: same file + preview name starts with
+ * component name (longest component-name match wins). Unmatched previews are
+ * pushed to `orphanPreviews`.
+ */
+function matchPreviewsToComponents(previews, components, orphanPreviews) {
+    for (const preview of previews) {
+        let best;
+        for (const comp of components) {
+            if (preview.name.startsWith(comp.name)) {
+                if (!best || comp.name.length > best.name.length)
+                    best = comp;
+            }
+        }
+        if (best) {
+            best.previews.push(preview);
+        }
+        else {
+            orphanPreviews.push(preview);
+        }
+    }
+}
+function computeStats(components, orphanPreviews) {
+    const withPreview = components.filter((c) => c.previews.length > 0).length;
+    const withDarkPreview = components.filter((c) => c.previews.some((p) => p.dark)).length;
+    const totalPreviews = components.reduce((sum, c) => sum + c.previews.length, 0) + orphanPreviews.length;
+    const allPreviews = [...components.flatMap((c) => c.previews), ...orphanPreviews];
+    const hintCount = allPreviews.reduce((sum, p) => sum + (p.hints?.length ?? 0), 0);
+    const selfPreviewed = components.filter((c) => c.previews.some((p) => p.name === c.name && p.line === c.line)).length;
+    return {
+        components: components.length,
+        withPreview,
+        withDarkPreview,
+        totalPreviews,
+        hintCount,
+        selfPreviewed,
+    };
+}
+async function walkKotlinFiles(dir) {
+    const results = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (entry.name === 'build')
+                continue;
+            results.push(...(await walkKotlinFiles(join(dir, entry.name))));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.kt')) {
+            results.push(join(dir, entry.name));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=android.js.map

package/dist/scan/android.js.map

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

package/dist/scan/hints.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Preview configuration hints: heuristics that catch a preview whose *name*
+ * (composable/View function name, or its `@Preview`/`#Preview` display name)
+ * implies a configuration — landscape, dark theme, tablet, RTL, etc. — that
+ * the annotation never actually declares. Real finding that motivated this:
+ * `fun SplashContentLandscape()` annotated with plain
+ * `@Preview(showBackground = true)` rendered portrait, so the gallery showed
+ * a screenshot named "Landscape" that wasn't.
+ */
+export interface PreviewHint {
+    rule: string;
+    severity: 'warning' | 'info';
+    message: string;
+    suggestion: string;
+}
+export interface PreviewHintInput {
+    platform: 'android' | 'ios';
+    functionName: string;
+    displayName?: string;
+    annotationText: string;
+    /** Text of the preview function's body (from the opening brace, capped to ~20 lines).
+     * Android-only for now; used by the `size-in-body` rule. */
+    bodyText?: string;
+}
+export declare function previewHints(input: PreviewHintInput): PreviewHint[];

package/dist/scan/hints.js

@@ -0,0 +1,338 @@
+/**
+ * Preview configuration hints: heuristics that catch a preview whose *name*
+ * (composable/View function name, or its `@Preview`/`#Preview` display name)
+ * implies a configuration — landscape, dark theme, tablet, RTL, etc. — that
+ * the annotation never actually declares. Real finding that motivated this:
+ * `fun SplashContentLandscape()` annotated with plain
+ * `@Preview(showBackground = true)` rendered portrait, so the gallery showed
+ * a screenshot named "Landscape" that wasn't.
+ */
+import { spaceCamelCase } from '../naming.js';
+/** Extracts width/height (in dp) from a `device = "spec:width=..dp,height=..dp,..."` value,
+ * or from standalone `widthDp = N` / `heightDp = N` params. */
+function extractDims(text) {
+    const deviceMatch = text.match(/device\s*=\s*"([^"]*)"/);
+    const scope = deviceMatch ? deviceMatch[1] : '';
+    const widthMatch = scope.match(/width\s*=\s*(\d+)dp/i) ?? text.match(/widthDp\s*=\s*(\d+)/i);
+    const heightMatch = scope.match(/height\s*=\s*(\d+)dp/i) ?? text.match(/heightDp\s*=\s*(\d+)/i);
+    return {
+        width: widthMatch ? Number(widthMatch[1]) : undefined,
+        height: heightMatch ? Number(heightMatch[1]) : undefined,
+    };
+}
+function androidDeclaresLandscape(text) {
+    if (/orientation\s*=\s*landscape/i.test(text))
+        return true;
+    const { width, height } = extractDims(text);
+    return width !== undefined && height !== undefined && width > height;
+}
+const ANDROID_RULES = [
+    {
+        rule: 'orientation-landscape',
+        severity: 'warning',
+        namePattern: /landscape/i,
+        declared: (ctx) => androidDeclaresLandscape(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies landscape orientation, but the @Preview annotation doesn't declare a landscape device/orientation.`,
+        suggestion: () => 'on the @Preview annotation: device = "spec:width=891dp,height=411dp,orientation=landscape"',
+    },
+    {
+        rule: 'orientation-portrait',
+        severity: 'warning',
+        namePattern: /portrait/i,
+        declared: (ctx) => !androidDeclaresLandscape(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies portrait orientation, but the @Preview annotation declares a landscape device.`,
+        suggestion: () => 'on the @Preview annotation: device = "spec:width=411dp,height=891dp,orientation=portrait"',
+    },
+    {
+        rule: 'theme-dark',
+        severity: 'warning',
+        namePattern: /\b(dark|night)\b/i,
+        declared: (ctx) => /UI_MODE_NIGHT_YES/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies dark theme, but the @Preview annotation doesn't set UI_MODE_NIGHT_YES.`,
+        suggestion: () => 'uiMode = Configuration.UI_MODE_NIGHT_YES (import android.content.res.Configuration)',
+    },
+    {
+        rule: 'theme-light',
+        severity: 'warning',
+        namePattern: /\blight\b/i,
+        declared: (ctx) => !/UI_MODE_NIGHT_YES/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies light theme, but the @Preview annotation sets UI_MODE_NIGHT_YES.`,
+        suggestion: () => 'remove uiMode, or set uiMode = Configuration.UI_MODE_NIGHT_NO',
+    },
+    {
+        rule: 'device-tablet',
+        severity: 'warning',
+        namePattern: /\b(tablet|foldable|expanded|large ?screen)\b/i,
+        declared: (ctx) => /device\s*=/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies a tablet/foldable/expanded device, but the @Preview annotation doesn't set device.`,
+        suggestion: (ctx) => /foldable/i.test(ctx.matchedName)
+            ? 'on the @Preview annotation: device = "spec:width=673dp,height=841dp" (unfolded foldable spec)'
+            : 'on the @Preview annotation: device = Devices.TABLET',
+    },
+    {
+        rule: 'locale-rtl',
+        severity: 'warning',
+        namePattern: /\b(rtl|arabic|hebrew)\b/i,
+        declared: (ctx) => /locale\s*=/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies an RTL locale, but the @Preview annotation doesn't set locale.`,
+        suggestion: (ctx) => (/hebrew/i.test(ctx.matchedName) ? 'locale = "he"' : 'locale = "ar"'),
+    },
+    {
+        rule: 'font-scale',
+        severity: 'warning',
+        namePattern: /\b(large ?font|font ?scale|accessibility|a11y)\b/i,
+        declared: (ctx) => /fontScale\s*=/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies a large font scale, but the @Preview annotation doesn't set fontScale.`,
+        suggestion: () => 'fontScale = 1.5f',
+    },
+    {
+        rule: 'size-compact',
+        severity: 'warning',
+        namePattern: /\b(compact|small ?screen|phone ?small)\b/i,
+        declared: (ctx) => /widthDp\s*=/.test(ctx.annotationText) || /device\s*=/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies a compact/small-screen size, but the @Preview annotation doesn't set widthDp or device.`,
+        suggestion: () => 'on the @Preview annotation: widthDp = 320',
+    },
+];
+/** Matches a fixed-size Modifier call (e.g. `.size(width = 891.dp, height = 411.dp)`) with
+ * a simple, non-nested argument list — the shape these calls take in practice. A call whose
+ * argument contains its own parens (e.g. `.size(dimensionResource(R.dimen.x))`) deliberately
+ * doesn't match: we have no literal dp value to reason about, so there's nothing to report. */
+const SIZE_MODIFIER_RE = /\.(size|requiredSize|width|height|requiredWidth|requiredHeight)\s*\(([^()]*)\)/g;
+/** Scans (a segment of) a preview body for fixed-size Modifier calls and, where parseable, the
+ * dp values they set. Handles `.size(48.dp)`, `.size(300.dp, 200.dp)`,
+ * `.size(width = 891.dp, height = 411.dp)`, and separate `.width(...)`/`.height(...)` calls. */
+function parseBodySize(text) {
+    const modifiers = [];
+    let width;
+    let height;
+    for (const match of text.matchAll(SIZE_MODIFIER_RE)) {
+        const mod = match[1];
+        const args = match[2];
+        modifiers.push(mod);
+        const widthArg = args.match(/width\s*=\s*(\d+(?:\.\d+)?)\.dp/i);
+        const heightArg = args.match(/height\s*=\s*(\d+(?:\.\d+)?)\.dp/i);
+        const dpValues = [...args.matchAll(/(\d+(?:\.\d+)?)\.dp/g)].map((m) => Number(m[1]));
+        if (mod === 'size' || mod === 'requiredSize') {
+            if (widthArg)
+                width = Number(widthArg[1]);
+            if (heightArg)
+                height = Number(heightArg[1]);
+            if (!widthArg && !heightArg) {
+                if (dpValues.length === 1) {
+                    width = dpValues[0];
+                    height = dpValues[0];
+                }
+                else if (dpValues.length >= 2) {
+                    width = dpValues[0];
+                    height = dpValues[1];
+                }
+            }
+        }
+        else if (mod === 'width' || mod === 'requiredWidth') {
+            if (dpValues.length >= 1)
+                width = dpValues[0];
+        }
+        else if (mod === 'height' || mod === 'requiredHeight') {
+            if (dpValues.length >= 1)
+                height = dpValues[0];
+        }
+    }
+    if (modifiers.length === 0)
+        return undefined;
+    return { modifiers, width, height };
+}
+function androidDeclaresExplicitSize(annotationText) {
+    return (/widthDp\s*=/.test(annotationText) ||
+        /heightDp\s*=/.test(annotationText) ||
+        /device\s*=/.test(annotationText));
+}
+/**
+ * The default Compose preview canvas (a Pixel-ish phone) when no widthDp/heightDp/device
+ * is declared: 392dp wide, 892dp tall. A size set on the root composable only causes visible
+ * harm (clipping) when it exceeds these — an icon's `.size(40.dp)` is completely harmless.
+ */
+const DEFAULT_CANVAS_WIDTH_DP = 392;
+const DEFAULT_CANVAS_HEIGHT_DP = 892;
+/**
+ * Isolates the modifier chain of the preview body's ROOT composable call: the text from the
+ * start of the body up to the first `{` that opens that root call's content lambda. Nested
+ * composables (anything inside that lambda) are deliberately excluded — almost every preview
+ * body has *some* inner `.size(...)` (an icon, a row height, ...), and those never affect the
+ * canvas, so scanning the whole body would be all noise. A simple line/brace-position
+ * approximation, not a real parser: robust enough for the common `Root(modifier = ...) { ... }`
+ * shape, and for a bare `Root(...)` call with no trailing lambda (root segment == whole body).
+ */
+function rootComposableSegment(bodyText) {
+    // bodyText always starts with the function's own opening brace (see captureBodyText).
+    const searchStart = 1;
+    const lambdaOpen = bodyText.indexOf('{', searchStart);
+    return lambdaOpen === -1 ? bodyText.slice(searchStart) : bodyText.slice(searchStart, lambdaOpen);
+}
+/**
+ * `size-in-body`: the preview body's ROOT composable sets a fixed size via a Modifier
+ * (`.size`/`.requiredSize`/`.width`/`.height`/`.requiredWidth`/`.requiredHeight`) that exceeds
+ * the default preview canvas (392dp wide / 892dp tall), while the annotation declares no canvas
+ * size of its own -- so the content is clipped instead of resized. This is a distinct mistake
+ * from `orientation-landscape`/`device-tablet`/`size-compact` (which key off the preview's
+ * *name*): here the body itself proves the mistake, regardless of naming. Both may fire together
+ * on the same preview -- a landscape-named preview that also over-sizes itself via Modifier is
+ * doubly wrong -- but their messages don't contradict: this rule only ever talks about the root
+ * Modifier size exceeding the canvas, never about orientation/name.
+ *
+ * Requires a literal, parseable dp value that actually exceeds the canvas: an in-bounds size
+ * (an icon's `.size(40.dp)`, a row's `.width(360.dp)`) or an unparseable expression (a
+ * dimension resource, a variable) never fires. No evidence, no warning.
+ */
+function checkSizeInBody(annotationText, bodyText) {
+    if (!bodyText)
+        return undefined;
+    if (androidDeclaresExplicitSize(annotationText))
+        return undefined;
+    const parsed = parseBodySize(rootComposableSegment(bodyText));
+    if (!parsed)
+        return undefined;
+    const { width, height } = parsed;
+    if (width === undefined && height === undefined)
+        return undefined;
+    const widthExceeds = width !== undefined && width > DEFAULT_CANVAS_WIDTH_DP;
+    const heightExceeds = height !== undefined && height > DEFAULT_CANVAS_HEIGHT_DP;
+    if (!widthExceeds && !heightExceeds)
+        return undefined;
+    const reasons = [];
+    if (widthExceeds) {
+        reasons.push(`${width}dp of width, but the preview canvas is only ${DEFAULT_CANVAS_WIDTH_DP}dp wide`);
+    }
+    if (heightExceeds) {
+        reasons.push(`${height}dp of height, but the preview canvas is only ${DEFAULT_CANVAS_HEIGHT_DP}dp tall`);
+    }
+    const suggestedParts = [];
+    if (width !== undefined)
+        suggestedParts.push(`widthDp = ${width}`);
+    if (height !== undefined)
+        suggestedParts.push(`heightDp = ${height}`);
+    return {
+        rule: 'size-in-body',
+        severity: 'warning',
+        message: `The preview body's root composable requests ${reasons.join(' and ')}, so it is clipped ` +
+            `instead of resized. A size Modifier in the preview body sizes content inside the canvas -- ` +
+            `it does not resize the canvas itself.`,
+        suggestion: `on the @Preview annotation: @Preview(${suggestedParts.join(', ')})`,
+    };
+}
+const IOS_RULES = [
+    {
+        rule: 'orientation-landscape',
+        severity: 'warning',
+        namePattern: /landscape/i,
+        declared: (ctx) => /\.landscapeLeft|\.landscapeRight|previewInterfaceOrientation/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies landscape orientation, but the #Preview doesn't declare .previewInterfaceOrientation(.landscape*).`,
+        suggestion: () => '.previewInterfaceOrientation(.landscapeLeft)',
+    },
+    {
+        rule: 'theme-dark',
+        severity: 'warning',
+        namePattern: /\b(dark|night)\b/i,
+        declared: (ctx) => /\.preferredColorScheme\(\s*\.dark\s*\)/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies dark theme, but the #Preview doesn't declare .preferredColorScheme(.dark).`,
+        suggestion: () => '.preferredColorScheme(.dark)',
+    },
+    {
+        rule: 'theme-light',
+        severity: 'warning',
+        namePattern: /\blight\b/i,
+        declared: (ctx) => !/\.preferredColorScheme\(\s*\.dark\s*\)/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies light theme, but the #Preview declares .preferredColorScheme(.dark).`,
+        suggestion: () => '.preferredColorScheme(.light)',
+    },
+    {
+        rule: 'device-tablet',
+        severity: 'warning',
+        namePattern: /\b(tablet|ipad)\b/i,
+        declared: (ctx) => /\.previewDevice/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies an iPad/tablet device, but the #Preview doesn't declare .previewDevice.`,
+        suggestion: () => '.previewDevice("iPad Pro 13-inch (M4)")',
+    },
+    {
+        rule: 'locale-rtl',
+        severity: 'warning',
+        namePattern: /\b(rtl|arabic|hebrew)\b/i,
+        declared: (ctx) => /layoutDirection/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies an RTL locale, but the #Preview doesn't set layoutDirection.`,
+        suggestion: () => '.environment(\\.layoutDirection, .rightToLeft)',
+    },
+    {
+        rule: 'font-scale',
+        severity: 'warning',
+        namePattern: /\b(large ?font|dynamic ?type|accessibility|a11y)\b/i,
+        declared: (ctx) => /dynamicTypeSize/.test(ctx.annotationText),
+        message: (ctx) => `"${ctx.matchedName}" implies a large/accessibility font size, but the #Preview doesn't set dynamicTypeSize.`,
+        suggestion: () => '.dynamicTypeSize(.accessibility3)',
+    },
+    {
+        rule: 'sizing',
+        severity: 'info',
+        namePattern: /.*/,
+        declared: (ctx) => /traits\s*:/.test(ctx.annotationText),
+        skip: (ctx) => /(Screen|Page|Content)$/i.test(ctx.matchedName),
+        message: (ctx) => `"${ctx.matchedName}" doesn't declare a traits: value, so it renders at full device size instead of fit-to-content.`,
+        suggestion: () => 'traits: .sizeThatFitsLayout',
+    },
+];
+function nameCandidates(functionName, displayName) {
+    const candidates = [functionName];
+    if (displayName)
+        candidates.push(displayName);
+    return candidates;
+}
+function evalRules(rules, functionName, displayName, annotationText) {
+    const hints = [];
+    const candidates = nameCandidates(functionName, displayName);
+    for (const rule of rules) {
+        let matchedName;
+        for (const candidate of candidates) {
+            // Match against both the raw candidate (handles "/"-separated or
+            // already-spaced display names) and its camelCase-split form, so a
+            // word like "Landscape" is found inside "SplashContentLandscape" too.
+            if (rule.namePattern.test(candidate) || rule.namePattern.test(spaceCamelCase(candidate))) {
+                matchedName = candidate;
+                break;
+            }
+        }
+        if (matchedName === undefined)
+            continue;
+        const ctx = { functionName, displayName, annotationText, matchedName };
+        if (rule.skip?.(ctx))
+            continue;
+        if (rule.declared(ctx))
+            continue;
+        hints.push({
+            rule: rule.rule,
+            severity: rule.severity,
+            message: rule.message(ctx),
+            suggestion: rule.suggestion(ctx),
+        });
+    }
+    return hints;
+}
+export function previewHints(input) {
+    const { platform, functionName, displayName, annotationText, bodyText } = input;
+    const rules = platform === 'android' ? ANDROID_RULES : IOS_RULES;
+    const hints = evalRules(rules, functionName, displayName, annotationText);
+    if (platform === 'android') {
+        const sizeHint = checkSizeInBody(annotationText, bodyText);
+        if (sizeHint)
+            hints.push(sizeHint);
+    }
+    if (!displayName) {
+        const example = platform === 'android' ? '@Preview(name = "<Component>/<State>")' : '#Preview("<Component>/<State>")';
+        hints.push({
+            rule: 'unnamed-preview',
+            severity: 'info',
+            message: `"${functionName}" has no display name, so the gallery groups it under "Default" instead of a real state.`,
+            suggestion: `${example} per the naming convention`,
+        });
+    }
+    return hints;
+}
+//# sourceMappingURL=hints.js.map

package/dist/scan/hints.js.map

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

package/dist/scan/ios.d.ts

@@ -0,0 +1,7 @@
+import type { CoverageReport } from './types.js';
+/**
+ * Regex-based heuristic scanner for SwiftUI `View` structs and `#Preview`
+ * macros (plus legacy `PreviewProvider` structs). Walks the project tree and
+ * matches previews to components by file + name heuristics.
+ */
+export declare function scanIos(projectDir: string): Promise<CoverageReport>;