@framingui/mcp-server 0.6.25 → 0.6.27

package/dist/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInG,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,CAoCpF;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,cAAc,CAgChB"}

package/dist/project-context.js

@@ -0,0 +1,78 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readPackageJson } from './utils/package-json-reader.js';
+const EXPO_CONFIG_CANDIDATES = ['app.json', 'app.config.js', 'app.config.ts', 'app.config.mjs'];
+export function detectProjectContext(projectPath) {
+    const readResult = readPackageJson(projectPath);
+    if (!readResult.success || !readResult.packageJson || !readResult.installedPackages) {
+        return {
+            success: false,
+            error: readResult.error || 'Failed to read package.json',
+        };
+    }
+    const rootPath = projectPath.endsWith('package.json') ? path.dirname(projectPath) : projectPath;
+    const resolvedRootPath = path.resolve(rootPath);
+    const packageJsonPath = path.resolve(projectPath.endsWith('package.json') ? projectPath : path.join(rootPath, 'package.json'));
+    const installedPackages = readResult.installedPackages;
+    const runtime = detectRuntime(resolvedRootPath, installedPackages);
+    return {
+        success: true,
+        context: {
+            projectPath: resolvedRootPath,
+            packageJsonPath,
+            platform: runtime === 'web' ? 'web' : 'react-native',
+            environment: {
+                runtime,
+                projectType: runtime,
+                packageManager: detectPackageManager(resolvedRootPath, typeof readResult.packageJson.packageManager === 'string'
+                    ? readResult.packageJson.packageManager
+                    : undefined),
+            },
+        },
+    };
+}
+export function detectPackageManager(projectPath, packageManagerField) {
+    if (packageManagerField) {
+        if (packageManagerField.startsWith('pnpm')) {
+            return 'pnpm';
+        }
+        if (packageManagerField.startsWith('yarn')) {
+            return 'yarn';
+        }
+        if (packageManagerField.startsWith('bun')) {
+            return 'bun';
+        }
+        if (packageManagerField.startsWith('npm')) {
+            return 'npm';
+        }
+    }
+    if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    if (fs.existsSync(path.join(projectPath, 'bun.lock')) ||
+        fs.existsSync(path.join(projectPath, 'bun.lockb'))) {
+        return 'bun';
+    }
+    if (fs.existsSync(path.join(projectPath, 'package-lock.json'))) {
+        return 'npm';
+    }
+    return 'unknown';
+}
+function detectRuntime(projectPath, installedPackages) {
+    const hasExpoDependency = Boolean(installedPackages.expo);
+    const hasReactNativeDependency = Boolean(installedPackages['react-native']);
+    const hasExpoConfig = EXPO_CONFIG_CANDIDATES.some(fileName => fs.existsSync(path.join(projectPath, fileName)));
+    const hasNativeFolders = fs.existsSync(path.join(projectPath, 'ios')) ||
+        fs.existsSync(path.join(projectPath, 'android'));
+    if (hasExpoDependency || hasExpoConfig) {
+        return 'expo';
+    }
+    if (hasReactNativeDependency || hasNativeFolders) {
+        return 'react-native';
+    }
+    return 'web';
+}
+//# sourceMappingURL=project-context.js.map

package/dist/project-context.js.map

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

package/dist/prompts/getting-started.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;EA2GtC"}
+{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;EA+HtC"}

package/dist/prompts/getting-started.js

@@ -67,7 +67,19 @@ You can call \`list-themes\` and \`preview-theme\` directly after authentication
 - pebble - Round minimal
 - square-minimalism - Square minimalism
 
-## Step 4: Check Component Availability
+## Step 4: Bootstrap Project Context
+
+If the project path is known, call \`detect-project-context\` before the main workflow.
+
+\`\`\`
+1. Call detect-project-context with the project root or package.json path
+2. Let FramingUI store the detected default platform/runtime for the session
+3. Continue with discovery tools without repeating platform flags unless overriding on purpose
+\`\`\`
+
+For Expo / React Native targets, this is the preferred path. If no project path is available, you can still pass \`platform: "react-native"\` explicitly as a fallback.
+
+## Step 5: Check Component Availability
 
 Before creating screen definitions:
 
@@ -77,19 +89,26 @@ Before creating screen definitions:
 3. Identify components needed for your screen
 \`\`\`
 
-## Step 5: Generate Your First Screen
+## Step 6: Generate Your First Screen
 
 Follow the 3-step workflow:
 
 **Step 1/3:** Call \`get-screen-generation-context\` with your screen description
 - Returns: Template hints, component suggestions with inline props, schema
 - Use \`includeExamples: false\` when you want a smaller response and do not need sample screen definitions
+- If \`detect-project-context\` already ran, omit \`platform\` and let the stored default apply
 
 **Step 2/3:** Create Screen Definition JSON, then call \`validate-screen-definition\`
 - Returns: Validation results, errors with auto-fix patches, suggestions
 
 **After validation passes:** Write React code directly using the components and props from Step 1
 
+For Expo / React Native targets:
+- use the direct-write guidance from \`get-screen-generation-context\`
+- prefer \`@framingui/react-native\` exports where that runtime surface exists
+- do **not** import \`@framingui/ui\`
+- run \`validate-environment\` with \`sourceFiles\` before handoff
+
 **Step 3/3 (Optional):** Call \`validate-environment\` with project path
 - Returns: Missing packages, install commands, Tailwind config status
 
@@ -98,11 +117,12 @@ Follow the 3-step workflow:
 1. ❌ Skipping authentication - All themes require licenses
 2. ❌ Assuming whoami is a hard prerequisite - it is optional session inspection, not a hidden unlock step
 3. ❌ Using non-existent theme IDs - Only 6 themes exist
-4. ❌ Skipping validate-screen-definition - Always validate before writing code
-5. ❌ Ignoring dependencies warnings - Check required packages before running code
-6. ❌ Using unlicensed themes - Only use themes from whoami licensedThemes list
-7. ❌ Parsing MCP transcript text with shell/python/json tools - Use tool output directly instead
-8. ❌ Treating templateMatch as the source of truth - components and preview tools are the contract
+4. ❌ Skipping detect-project-context when the project path is known - you lose automatic platform defaults
+5. ❌ Skipping validate-screen-definition for web work - Always validate before writing code
+6. ❌ Ignoring dependencies warnings - Check required packages before running code
+7. ❌ Using unlicensed themes - Only use themes from whoami licensedThemes list
+8. ❌ Parsing MCP transcript text with shell/python/json tools - Use tool output directly instead
+9. ❌ Treating templateMatch as the source of truth - components and preview tools are the contract
 
 ## Need Help?
 

package/dist/prompts/getting-started.js.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.js","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA+FkD;iBACzD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getting-started.js","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEAmHkD;iBACzD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/screen-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,uBAAuB;;;;;;;;EAuJtC"}
+{"version":3,"file":"screen-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,uBAAuB;;;;;;;;EA0MtC"}

package/dist/prompts/screen-workflow.js

@@ -24,10 +24,29 @@ The production workflow is **guarded direct write**:
 - ✅ Write React code directly using FramingUI components and props from context
 - ✅ Verify dependencies, Tailwind setup, and raw HTML/style escapes before delivery
 
+React Native is also supported through a **direct-write contract path**:
+- ✅ Prefer \`detect-project-context\` once when the project path is known
+- ✅ Gather platform-aware component guidance without repeating platform flags
+- ✅ Write Expo / React Native code directly using \`@framingui/react-native\` where available, then host primitives or app abstractions for the rest
+- ✅ Use \`validate-environment\` with \`sourceFiles\` for package checks and QC
+- 🚫 Do not import \`@framingui/ui\` into React Native projects
+
 This is **not** the old \`generate_screen\`-first workflow.
 \`generate_screen\` may still be used as an optional helper, but the default production path is:
 
-\`preview-theme\` → \`get-screen-generation-context\` → \`preview-component\` / \`list-icon-libraries\` when needed → \`validate-screen-definition\` → write code directly → \`validate-environment\`
+If the project path is known:
+
+\`detect-project-context\` → \`preview-theme\` → \`get-screen-generation-context\` → \`preview-component\` / \`list-icon-libraries\` when needed → \`validate-screen-definition\` → write code directly → \`validate-environment\`
+
+If the project path is not known, start at \`get-screen-generation-context\` and use explicit platform overrides only when needed.
+
+## React Native Note
+
+For Expo or React Native projects:
+- pass \`"platform": "react-native"\` to \`get-screen-generation-context\`
+- prefer \`@framingui/react-native\` exports over app-local wrappers for common UI
+- write code directly with \`StyleSheet.create\`
+- run \`validate-environment\` with \`sourceFiles\` to catch web-only imports, \`className\`, and raw token drift
 
 ## Step 1/4: Gather Context
 
@@ -46,6 +65,15 @@ Use this at the start of every screen task.
 
 Set \`includeExamples: false\` when you want a smaller response and do not need example screen definitions.
 
+For React Native direct-write work without a detected session default, pass:
+\`\`\`json
+{
+  "description": "Profile screen with subscription card and settings actions",
+  "platform": "react-native",
+  "includeExamples": false
+}
+\`\`\`
+
 **What to review from the response:**
 - \`templateMatch\` as a layout hint only
 - \`components\` as the source of truth for imports, props, and variants
@@ -136,15 +164,38 @@ Use it to verify:
 
 If the tool reports missing setup or raw primitive drift, fix the code before delivery.
 
+## React Native Direct-Write Path
+
+Use this instead of the web screen-definition path when the target app is Expo or React Native.
+
+1. Call \`detect-project-context\` with \`projectPath\` when the app path is available
+2. Call \`get-screen-generation-context\` and let the stored session default pick React Native automatically
+3. If the project path is not available, call \`get-screen-generation-context\` with \`platform: "react-native"\`
+4. Review React Native compatible components and hints
+5. Write the screen directly using \`@framingui/react-native\` exports where available, then \`react-native\` primitives or local app abstractions
+6. Run \`validate-environment\` with:
+   - \`platform: "react-native"\`
+   - \`projectPath\`
+   - \`requiredPackages\`
+   - \`sourceFiles\`
+7. Fix missing packages, hardcoded color/spacing/radius values, and web-only patterns such as \`className\`
+
+React Native rules:
+- Do **not** import \`@framingui/ui\`
+- Do **not** require Tailwind or CSS imports
+- Prefer \`StyleSheet\` plus \`@framingui/react-native\` helpers or host app token helpers over raw style literals
+- Treat \`@framingui/react-native\` as a minimal runtime, not as full \`@framingui/ui\` parity or code generation
+
 ## Best Practices
 
-1. Start with \`get-screen-generation-context\`
+1. Start with \`detect-project-context\` when project path is known
 2. Use \`includeExamples: false\` unless examples are actually needed
 3. Treat \`templateMatch\` as a hint, not a hard constraint
 4. Treat \`components\` as the source of truth
 5. Validate the definition before writing JSX
 6. Never parse MCP transcript text with shell or Python JSON tooling
 7. Run \`validate-environment\` before handoff
+8. Use the React Native direct-write path when the target project is Expo or React Native
 
 ## Optional Helper Path
 

package/dist/prompts/screen-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen-workflow.js","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gMA2IgL;iBACvL;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"screen-workflow.js","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gMA8LgL;iBACvL;aACF;SACF;KACF,CAAC;AACJ,CAAC"}