anhedral 0.6.1 → 0.7.0

package/dist/platforms/extension.js

@@ -1,5 +1,5 @@
-import { rmSync } from 'node:fs';
 import path from 'node:path';
+import { writeReactLintConfig } from './lint.js';
 import { writeFile } from '../util.js';
 import { EXTENSION_DEPENDENCIES } from '../dependencies.js';
 import { childPackageName, htmlText, jsString, markdownHeading } from '../render.js';
@@ -7,7 +7,8 @@ export async function scaffoldExtension(root, options) {
     const { projectName, displayName } = options;
     const dir = path.join(root, 'apps/extension');
     writePackageJson(dir, projectName);
-    cleanWxtStarterFiles(dir);
+    writeFile(path.join(dir, 'tsconfig.json'), JSON.stringify({ extends: './.wxt/tsconfig.json', compilerOptions: { strict: true, jsx: 'react-jsx', paths: { '@/*': ['./src/*'] } } }, null, 2) + '\n');
+    writeReactLintConfig(dir);
     writeWxtConfig(dir, displayName);
     writeEnvExample(dir);
     writePostcssConfig(dir);
@@ -22,16 +23,6 @@ export async function scaffoldExtension(root, options) {
     writeSidepanelApp(dir);
     writeStyles(dir);
 }
-function cleanWxtStarterFiles(dir) {
-    for (const relativePath of [
-        '.git',
-        'entrypoints',
-        'assets/react.svg',
-        'public/wxt.svg',
-    ]) {
-        rmSync(path.join(dir, relativePath), { recursive: true, force: true });
-    }
-}
 function writePackageJson(dir, projectName) {
     writeFile(path.join(dir, 'package.json'), JSON.stringify({
         name: childPackageName(projectName, 'chrome-ext'),
@@ -44,9 +35,10 @@ function writePackageJson(dir, projectName) {
             postinstall: 'wxt prepare',
             zip: 'wxt zip',
             typecheck: 'tsc --noEmit',
+            lint: 'eslint src --max-warnings 0',
         },
         dependencies: EXTENSION_DEPENDENCIES.dependencies,
-        devDependencies: EXTENSION_DEPENDENCIES.devDependencies,
+        devDependencies: { ...EXTENSION_DEPENDENCIES.devDependencies, '@workspace/eslint-config': 'workspace:*', eslint: '10.0.3' },
     }, null, 2) + '\n');
 }
 function writeWxtConfig(dir, displayName) {
@@ -68,7 +60,7 @@ export default defineConfig({
       version: '0.1.0',
       ...(crxPublicKey ? { key: crxPublicKey } : {}),
       minimum_chrome_version: '114',
-      permissions: ${"['activeTab', 'scripting', 'sidePanel']"},
+      permissions: ['activeTab', 'scripting', 'sidePanel'],
       host_permissions: [],
       action: {
         default_title: ${actionTitleLiteral},
@@ -143,7 +135,7 @@ import { cn } from '@/lib/utils';
 
 type ButtonVariant = 'default' | 'outline';
 
-export type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
+type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
   variant?: ButtonVariant;
 };
 
@@ -225,15 +217,6 @@ module.exports = {
 `);
 }
 function writeReadme(dir, displayName) {
-    const configuration = [
-        null,
-        null,
-        'Set `VITE_CRX_PUBLIC_KEY` only when you need a stable Chrome extension ID.',
-    ].filter((value) => value !== null).join(' ');
-    const networkIntegrations = [].join(' and ');
-    const hostPermissionsGuidance = networkIntegrations
-        ? `\n\nThe manifest derives deduplicated Chrome host permissions from ${networkIntegrations}. Only absolute HTTP(S) URLs are accepted; malformed configured URLs fail the build. Set production URLs in the extension environment before publishing—no source edit is required.`
-        : '';
     writeFile(path.join(dir, 'README.md'), `# ${markdownHeading(displayName)} Chrome Extension
 
 WXT side-panel extension generated by anhedral.
@@ -247,13 +230,13 @@ pnpm build
 pnpm zip
 \`\`\`
 
-Run these commands from \`apps/extension\`. Anhedral generates only \`.env.example\`; keep the local \`.env\` file uncommitted. ${configuration}
+Run these commands from \`apps/extension\`. Anhedral generates only \`.env.example\`; keep the local \`.env\` file uncommitted. Set \`VITE_CRX_PUBLIC_KEY\` only when you need a stable Chrome extension ID.
 
 ## Chrome
 
 Run \`pnpm build\`, then load \`.output/chrome-mv3\` as an unpacked extension from \`chrome://extensions\`.
 
-The extension uses Chrome's Side Panel API. The browser action opens \`sidepanel.html\`, \`wxt.config.ts\` declares the \`sidePanel\` permission and Chrome 114+ minimum version, and active-page reads use a user-triggered \`activeTab\` + \`scripting\` grant instead of persistent site access.${hostPermissionsGuidance}
+The extension uses Chrome's Side Panel API. The browser action opens \`sidepanel.html\`, \`wxt.config.ts\` declares the \`sidePanel\` permission and Chrome 114+ minimum version, and active-page reads use a user-triggered \`activeTab\` + \`scripting\` grant instead of persistent site access.
 `);
 }
 function writeBackground(dir) {
@@ -283,7 +266,7 @@ if (container) {
   const root = createRoot(container);
   root.render(
     <React.StrictMode>
-${"      <SidePanelApp />"}
+      <SidePanelApp />
     </React.StrictMode>
   );
 }
@@ -313,25 +296,25 @@ type PageSnapshot = {
   location: string;
 };
 
+async function readPageSnapshot(): Promise<PageSnapshot> {
+  const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
+  if (!tab?.id) throw new Error('No active tab is available.');
+  const [{ result }] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: () => ({ title: document.title, location: window.location.href }),
+  });
+  if (!result) throw new Error('The active page did not return a snapshot.');
+  return result as PageSnapshot;
+}
+
 export function SidePanelApp() {
   const [page, setPage] = React.useState<PageSnapshot | null>(null);
   const [pageError, setPageError] = React.useState<string | null>(null);
 
   const readActivePage = React.useCallback(async () => {
     setPageError(null);
-    const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
-    if (!tab.id) {
-      setPageError('No active tab is available.');
-      return;
-    }
-
     try {
-      const [injection] = await chrome.scripting.executeScript({
-        target: { tabId: tab.id },
-        func: () => ({ title: document.title, location: window.location.href }),
-      });
-      if (!injection?.result) throw new Error('The active page did not return a snapshot.');
-      setPage(injection.result as PageSnapshot);
+      setPage(await readPageSnapshot());
     } catch {
       setPageError('Chrome does not allow this page to be inspected. Open a normal website and try again.');
     }

package/dist/platforms/lint.d.ts

@@ -0,0 +1 @@
+export declare function writeReactLintConfig(directory: string): void;

package/dist/platforms/lint.js

@@ -0,0 +1,5 @@
+import path from 'node:path';
+import { writeFile } from '../util.js';
+export function writeReactLintConfig(directory) {
+    writeFile(path.join(directory, 'eslint.config.mjs'), 'import { config } from "@workspace/eslint-config/react-internal";\nexport default [...config, { files: ["**/*.{ts,tsx,cts}"], languageOptions: { parserOptions: { babelOptions: { babelrc: false, configFile: false, parserOpts: { plugins: ["jsx", "typescript"] } } } }, rules: { "no-undef": "off", "no-unused-vars": "off" } }];\n');
+}

package/dist/platforms/mobile.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import { writeReactLintConfig } from './lint.js';
 import { appendGitignore, writeFile } from '../util.js';
 import { childPackageName, jsString } from '../render.js';
 import { MOBILE_APP_DEPENDENCIES, MOBILE_NATIVEWIND_DEPENDENCIES, EAS_CLI_VERSION, } from '../dependencies.js';
@@ -29,6 +30,17 @@ import { twMerge } from 'tailwind-merge';
 export function cn(...inputs: ClassValue[]) {
   return twMerge(clsx(inputs));
 }
+`);
+    writeFile(path.join(dir, 'components/ui/button.tsx'), `import { Pressable, Text, type PressableProps } from 'react-native';
+import { cn } from '@/lib/utils';
+
+type ButtonProps = Omit<PressableProps, 'children'> & { children: string; className?: string };
+
+export function Button({ children, className, ...props }: ButtonProps) {
+  return <Pressable accessibilityRole="button" className={cn('h-10 items-center justify-center rounded-md bg-primary px-4', className)} {...props}>
+    <Text className="font-medium text-primary-foreground">{children}</Text>
+  </Pressable>;
+}
 `);
     writeFile(path.join(dir, 'babel.config.js'), `module.exports = function (api) {
   api.cache(true);
@@ -45,6 +57,7 @@ const config = getDefaultConfig(__dirname);
 module.exports = withNativeWind(config, { input: './global.css', inlineRem: 16 });
 `);
     writeFile(path.join(dir, 'nativewind-env.d.ts'), '/// <reference types="nativewind/types" />\n');
+    writeFile(path.join(dir, 'styles.d.ts'), "declare module '*.css';\n");
     writeFile(path.join(dir, 'tailwind.config.js'), `const { hairlineWidth } = require('nativewind/theme');
 
 /** @type {import('tailwindcss').Config} */
@@ -122,6 +135,7 @@ export async function scaffoldMobile(root, options) {
     const dir = path.join(root, 'apps/mobile');
     const { projectName, displayName } = options;
     const nameLiteral = jsString(displayName);
+    writeReactLintConfig(dir);
     writeFile(path.join(dir, 'package.json'), JSON.stringify({
         name: childPackageName(projectName, 'mobile'),
         version: '0.1.0',
@@ -142,9 +156,10 @@ export async function scaffoldMobile(root, options) {
             'submit:ios': `pnpm dlx eas-cli@${EAS_CLI_VERSION} submit --platform ios --profile production --latest`,
             'submit:android': `pnpm dlx eas-cli@${EAS_CLI_VERSION} submit --platform android --profile production --latest`,
             typecheck: 'tsc --noEmit',
+            lint: 'eslint app components lib --max-warnings 0',
         },
         dependencies: { ...MOBILE_APP_DEPENDENCIES.dependencies, ...MOBILE_NATIVEWIND_DEPENDENCIES.dependencies },
-        devDependencies: MOBILE_APP_DEPENDENCIES.devDependencies,
+        devDependencies: { ...MOBILE_APP_DEPENDENCIES.devDependencies, '@workspace/eslint-config': 'workspace:*', eslint: '10.0.3' },
     }, null, 2) + '\n');
     writeFile(path.join(dir, 'app.json'), JSON.stringify({
         expo: {
@@ -153,9 +168,8 @@ export async function scaffoldMobile(root, options) {
             version: '1.0.0',
             orientation: 'portrait',
             scheme: expoScheme(projectName),
-            userInterfaceStyle: 'automatic',
             web: { bundler: 'metro', output: 'static' },
-            plugins: ['expo-router', ...([]), 'expo-status-bar'],
+            plugins: ['expo-router', 'expo-status-bar'],
             experiments: { reactCompiler: true, typedRoutes: true },
         },
     }, null, 2) + '\n');
@@ -175,7 +189,6 @@ export async function scaffoldMobile(root, options) {
         ],
     }, null, 2) + '\n');
     writeReactNativeReusablesConfig(dir);
-    const layoutBody = `  return <>${"<Stack />"}<PortalHost /></>;`;
     writeFile(path.join(dir, 'app/_layout.tsx'), `import '@/global.css';
 
 import { PortalHost } from '@rn-primitives/portal';
@@ -183,15 +196,12 @@ import { Stack } from 'expo-router';
 
 
 export default function RootLayout() {
-${layoutBody}
+  return <><Stack /><PortalHost /></>;
 }
 `);
-    const homeImports = [].join('\n');
     writeFile(path.join(dir, 'app/index.tsx'), `import { StatusBar } from 'expo-status-bar';
-import { ${"ScrollView, StyleSheet, Text, View"} } from 'react-native';
-${homeImports}
-
-const enabledModules = [];
+import { Linking, ScrollView, StyleSheet, Text, View } from 'react-native';
+import { Button } from '@/components/ui/button';
 
 export default function HomeScreen() {
   return (
@@ -200,7 +210,7 @@ export default function HomeScreen() {
       <View style={styles.content}>
         <Text accessibilityRole="header" style={styles.title}>{${nameLiteral}}</Text>
         <Text selectable style={styles.subtitle}>Deterministic Expo application generated by Anhedral.</Text>
-        {enabledModules.map((moduleName) => <Text selectable key={moduleName} style={styles.module}>• {moduleName}</Text>)}
+        <Button onPress={() => void Linking.openURL('https://docs.expo.dev')}>Learn more</Button>
       </View>
     </ScrollView>
   );
@@ -210,12 +220,8 @@ const styles = StyleSheet.create({
   screen: { flex: 1, backgroundColor: '#f8fafc' },
   container: { flexGrow: 1, justifyContent: 'center', padding: 32 },
   content: { gap: 12 },
-  actions: { gap: 8, paddingTop: 8 },
   title: { color: '#0f172a', fontSize: 34, fontWeight: '700' },
   subtitle: { color: '#475569', fontSize: 17, paddingBottom: 12 },
-  module: { color: '#1e293b', fontSize: 15 },
-  status: { color: '#475569', fontSize: 14 },
-  error: { color: '#b91c1c', fontSize: 14 },
 });
 `);
     writeFile(path.join(dir, '.env.example'), '');

package/dist/readiness.d.ts

@@ -0,0 +1,20 @@
+import { type StandardProduct } from './standard-products.js';
+export declare function inspectProject(root: string): {
+    schemaVersion: number;
+    root: string;
+    checks: {
+        id: string;
+        ok: boolean;
+        detail: string;
+    }[];
+    localReady: boolean;
+    providerVerification: string;
+    productionReady: boolean;
+};
+export declare function validateSetupPlan(plan: unknown): asserts plan is {
+    schemaVersion: 1;
+    cliVersion: string;
+    registryVersion: 1;
+    products: StandardProduct[];
+    hosting: 'cloudflare' | 'vercel';
+};

package/dist/readiness.js

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { CAPABILITY_REGISTRY, resolveStandardProducts } from './capabilities.js';
+import { STANDARD_PRODUCTS } from './standard-products.js';
+export function inspectProject(root) {
+    const checks = [];
+    const record = (id, ok, detail) => checks.push({ id, ok, detail });
+    const read = (file) => JSON.parse(readFileSync(path.join(root, file), 'utf8'));
+    record('workspace', existsSync(path.join(root, 'pnpm-workspace.yaml')), 'pnpm workspace manifest');
+    record('lockfile', existsSync(path.join(root, 'pnpm-lock.yaml')), 'Committed dependency resolution required');
+    try {
+        const plan = read('anhedral.setup.json');
+        validateSetupPlan(plan);
+        const standard = read('anhedral.standard.json');
+        record('setup-plan', true, `Requirements recorded by CLI ${plan.cliVersion}`);
+        record('cli-compatibility', plan.cliVersion === CAPABILITY_REGISTRY.cliVersion, 'Use the project CLI version or review upgrade differences');
+        record('selection', standard.schemaVersion === 1 && JSON.stringify(standard.products) === JSON.stringify(plan.products) && standard.hosting === (plan.products.includes('next') ? plan.hosting : null), 'Setup plan matches project selection');
+    }
+    catch {
+        record('setup-plan', false, 'Missing, invalid or unsupported setup plan; inspect the project before changing it');
+    }
+    return { schemaVersion: 1, root, checks, localReady: checks.every((check) => check.ok), providerVerification: 'unverified', productionReady: false };
+}
+export function validateSetupPlan(plan) {
+    if (!plan || typeof plan !== 'object')
+        throw new Error('Invalid setup plan.');
+    const value = plan;
+    if (value.schemaVersion !== 1 || value.registryVersion !== 1 || typeof value.cliVersion !== 'string')
+        throw new Error('Unsupported setup plan version.');
+    if (!Array.isArray(value.products) || !value.products.length || !value.products.every((id) => STANDARD_PRODUCTS.includes(id)))
+        throw new Error('Unknown setup capabilities.');
+    if (value.hosting !== 'cloudflare' && value.hosting !== 'vercel')
+        throw new Error('Invalid hosting.');
+    validateRequirements(value.setup, value.products);
+    const selected = new Set(value.products);
+    resolveStandardProducts(selected, value.hosting, false);
+    if (selected.size !== value.products.length)
+        throw new Error('Invalid or incomplete setup selection.');
+}
+function validateRequirements(setup, products) {
+    if (!setup || typeof setup !== 'object')
+        throw new Error('Missing setup requirements.');
+    const value = setup;
+    if (value.resourcesProvisioned !== false || !Array.isArray(value.capabilities) || value.capabilities.length !== products.length)
+        throw new Error('Invalid capability requirements.');
+    const ids = value.capabilities.map((item) => validateCapability(item));
+    if (new Set(ids).size !== products.length || !products.every((id) => ids.includes(id)))
+        throw new Error('Capability selection mismatch.');
+}
+function validateCapability(item) {
+    if (!item || typeof item !== 'object')
+        throw new Error('Invalid capability.');
+    const value = item;
+    if (typeof value.id !== 'string' || typeof value.purpose !== 'string' || !['planned', 'starter'].includes(String(value.status)))
+        throw new Error('Invalid capability metadata.');
+    for (const key of ['tools', 'access', 'credentials', 'resources', 'verify']) {
+        if (!Array.isArray(value[key]) || !value[key].every((entry) => typeof entry === 'string'))
+            throw new Error('Invalid requirement fields.');
+    }
+    return value.id;
+}

package/dist/render.d.ts

@@ -4,7 +4,6 @@ export declare function jsString(value: string): string;
 export declare function htmlText(value: string): string;
 /** Keep generated Markdown headings on one line and prevent heading/code injection. */
 export declare function markdownHeading(value: string): string;
-export declare function assertPackageName(value: string): string;
 /** Derive a valid, deterministic unscoped npm package name from arbitrary text. */
 export declare function packageNameFromText(value: string): string;
 export declare function childPackageName(projectName: string, suffix: string): string;

package/dist/render.js

@@ -20,7 +20,7 @@ export function markdownHeading(value) {
     const normalized = value.replace(/[\r\n]+/g, ' ').trim() || 'Anhedral App';
     return normalized.replace(/([\\`*_{}\[\]()<>#+.!|~-])/g, '\\$1');
 }
-export function assertPackageName(value) {
+function assertPackageName(value) {
     const leafName = value.slice(value.lastIndexOf('/') + 1);
     if (value.length > MAX_PACKAGE_NAME_LENGTH
         || !PACKAGE_NAME_PATTERN.test(value)