@framingui/mcp-server 0.6.9 → 0.6.11

package/dist/prompts/a11y-workflow.d.ts

@@ -0,0 +1,10 @@
+export declare function getA11yWorkflowPrompt(): {
+    messages: {
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }[];
+};
+//# sourceMappingURL=a11y-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/a11y-workflow.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB;;;;;;;;EA4CpC"}

package/dist/prompts/a11y-workflow.js

@@ -0,0 +1,46 @@
+export function getA11yWorkflowPrompt() {
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `# FramingUI Accessibility Workflow
+
+Use this workflow when the user asks for accessibility review or fixes.
+
+## Primary command
+
+\`/a11y <target> [--fix] [--scope full|form|dialog|nav]\`
+
+## What to inspect
+
+- heading hierarchy
+- landmark structure
+- form labels and descriptions
+- dialog semantics
+- focus order and keyboard traps
+- tap target size
+- contrast risks based on current theme and token usage
+
+## Workflow
+
+1. Inspect the target definition or rendered structure.
+2. Use \`validate-screen-definition\` as the contract baseline.
+3. Use \`preview-component\` when component semantics or variants are relevant.
+4. Report issues grouped by severity.
+5. If \`--fix\` or an equivalent request is present, return a patch or regenerated output only when the fix is safe and contract-preserving.
+
+## Expected output
+
+- findings
+- severity
+- likely impact
+- recommended fix
+- optional patch or regenerated output`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=a11y-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-workflow.js","sourceRoot":"","sources":["../../src/prompts/a11y-workflow.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAgCuB;iBAC9B;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/command-help.d.ts

@@ -0,0 +1,10 @@
+export declare function getCommandHelpPrompt(commandName?: string): {
+    messages: {
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }[];
+};
+//# sourceMappingURL=command-help.d.ts.map

package/dist/prompts/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../src/prompts/command-help.ts"],"names":[],"mappings":"AAUA,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM;;;;;;;;EAqGxD"}

package/dist/prompts/command-help.js

@@ -0,0 +1,101 @@
+import { getSlashCommand } from '../commands/slash-command-registry.js';
+function formatValues(values) {
+    if (!values || values.length === 0) {
+        return '';
+    }
+    return ` Values: ${values.join(', ')}`;
+}
+export function getCommandHelpPrompt(commandName) {
+    const command = commandName ? getSlashCommand(commandName) : undefined;
+    if (!command) {
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# FramingUI Command Help
+
+No slash command matched \`${commandName ?? ''}\`.
+
+Use the \`slash-commands\` prompt to inspect the full catalog, then call \`command-help\` again with one of:
+- /screen
+- /section
+- /draft
+- /responsive
+- /a11y
+- /theme-swap
+- /doctor
+- /install-check
+- /export
+- /update`,
+                    },
+                },
+            ],
+        };
+    }
+    const argLines = command.args.length > 0
+        ? command.args
+            .map(arg => `- \`${arg.name}\`${arg.required ? ' (required)' : ''} - ${arg.description}`)
+            .join('\n')
+        : '- None';
+    const optionLines = command.options.length > 0
+        ? command.options
+            .map(option => `- \`${option.name}\` - ${option.description}${formatValues(option.values)}`)
+            .join('\n')
+        : '- None';
+    const exampleLines = command.examples.map(example => `- \`${example}\``).join('\n');
+    const workflowLines = command.workflow.map(step => `- \`${step}\``).join('\n');
+    const preflightLines = command.preflight
+        ? [
+            `Required: \`${command.preflight.required ? 'yes' : 'no'}\``,
+            `When: ${command.preflight.when}`,
+            `Steps:`,
+            ...command.preflight.steps.map(step => `- \`${step}\``),
+            `Blocking conditions:`,
+            ...command.preflight.blockingConditions.map(condition => `- ${condition}`),
+        ].join('\n')
+        : 'None';
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `# ${command.name}
+
+${command.summary}
+
+## Usage
+
+\`${command.usage}\`
+
+## Arguments
+
+${argLines}
+
+## Options
+
+${optionLines}
+
+## Examples
+
+${exampleLines}
+
+## MCP workflow
+
+${workflowLines}
+
+## Required preflight
+
+${preflightLines}
+
+## Prompt fallback
+
+\`${command.promptRecipe}\``,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=command-help.js.map

package/dist/prompts/command-help.js.map

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

package/dist/prompts/doctor-workflow.d.ts

@@ -0,0 +1,10 @@
+export declare function getDoctorWorkflowPrompt(): {
+    messages: {
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }[];
+};
+//# sourceMappingURL=doctor-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/doctor-workflow.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB;;;;;;;;EAqCtC"}

package/dist/prompts/doctor-workflow.js

@@ -0,0 +1,39 @@
+export function getDoctorWorkflowPrompt() {
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `# FramingUI Doctor Workflow
+
+Use this workflow when the user asks why FramingUI generation or styling is not working in their project.
+
+## Primary commands
+
+- \`/doctor [<project-path>] [--auth] [--tailwind] [--themes] [--fix-hints]\`
+- \`/install-check [<project-path>] [--for <screen|section|file>] [--packages-only]\`
+
+## Workflow
+
+1. Inspect session status with \`whoami\` when auth or entitlement issues are suspected.
+2. Confirm theme access with \`list-themes\`.
+3. Run \`validate-environment\` for package presence, Tailwind compatibility, and style contract detection.
+4. Inspect the style contract result and decide whether the project should stay utility-first or migrate to FramingUI-native variables.
+5. Return the smallest set of fixes needed to restore a working FramingUI setup.
+
+## Expected output
+
+- auth status when relevant
+- theme availability when relevant
+- missing packages
+- install commands
+- Tailwind or style-import issues
+- style contract classification and migration recommendation when relevant
+- prioritized next actions`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=doctor-workflow.js.map

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

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

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;;;;;;;;EAwGtC"}
+{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;EAyHtC"}

package/dist/prompts/getting-started.js

@@ -77,7 +77,24 @@ Before creating screen definitions:
 3. Identify components needed for your screen
 \`\`\`
 
-## Step 5: Generate Your First Screen
+## Step 5: Discover Slash Commands (Optional but Recommended)
+
+If your MCP client supports slash menus, tab completion, or command palettes, expose the FramingUI command registry:
+
+- \`/screen\` - full screen generation
+- \`/section\` - section generation or replacement
+- \`/draft\` - structural screen draft before codegen
+- \`/responsive\` - responsive optimization with density controls
+- \`/a11y\` - accessibility review
+- \`/theme-swap\` - reapply a screen under a different theme
+- \`/doctor\` - setup diagnosis
+- \`/install-check\` - dependency and environment checks
+- \`/export\` - artifact export
+- \`/update\` - refresh installed FramingUI packages in a project
+
+If your client does not support native slash commands, use the \`slash-commands\` and \`command-help\` prompts as a fallback help surface.
+
+## Step 6: Generate Your First Screen
 
 Follow the 3-step workflow:
 

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA4FkD;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA6GkD;iBACzD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/prompt-catalog.d.ts

@@ -0,0 +1,26 @@
+export interface PromptArgumentDefinition {
+    name: string;
+    required?: boolean;
+    description: string;
+}
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments: PromptArgumentDefinition[];
+    getPrompt: (args?: Record<string, string>) => {
+        messages: Array<{
+            role: string;
+            content: {
+                type: string;
+                text: string;
+            };
+        }>;
+    };
+}
+export declare function listPromptDefinitions(): Array<{
+    name: string;
+    description: string;
+    arguments: PromptArgumentDefinition[];
+}>;
+export declare function getPromptDefinition(name: string): PromptDefinition | undefined;
+//# sourceMappingURL=prompt-catalog.d.ts.map

package/dist/prompts/prompt-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-catalog.d.ts","sourceRoot":"","sources":["../../src/prompts/prompt-catalog.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK;QAC5C,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM,CAAC;gBACb,IAAI,EAAE,MAAM,CAAC;aACd,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;CACH;AAkED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC,CAAC,CAMD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E"}

package/dist/prompts/prompt-catalog.js

@@ -0,0 +1,82 @@
+import { getA11yWorkflowPrompt } from './a11y-workflow.js';
+import { getCommandHelpPrompt } from './command-help.js';
+import { getDoctorWorkflowPrompt } from './doctor-workflow.js';
+import { getGettingStartedPrompt } from './getting-started.js';
+import { getResponsiveWorkflowPrompt } from './responsive-workflow.js';
+import { getScreenWorkflowPrompt } from './screen-workflow.js';
+import { getSlashCommandsPrompt } from './slash-commands.js';
+import { getThemeSwapWorkflowPrompt } from './theme-swap-workflow.js';
+import { getUpdateWorkflowPrompt } from './update-workflow.js';
+const promptCatalog = [
+    {
+        name: 'getting-started',
+        description: 'Complete getting started guide for FramingUI including authentication, theme exploration, slash command discovery, and screen generation workflow',
+        arguments: [],
+        getPrompt: () => getGettingStartedPrompt(),
+    },
+    {
+        name: 'screen-workflow',
+        description: 'Detailed screen generation workflow for /screen, /section, and /draft flows',
+        arguments: [],
+        getPrompt: () => getScreenWorkflowPrompt(),
+    },
+    {
+        name: 'responsive-workflow',
+        description: 'Responsive optimization workflow backing the /responsive command',
+        arguments: [],
+        getPrompt: () => getResponsiveWorkflowPrompt(),
+    },
+    {
+        name: 'a11y-workflow',
+        description: 'Accessibility audit workflow backing the /a11y command',
+        arguments: [],
+        getPrompt: () => getA11yWorkflowPrompt(),
+    },
+    {
+        name: 'theme-swap-workflow',
+        description: 'Theme application workflow backing the /theme-swap command',
+        arguments: [],
+        getPrompt: () => getThemeSwapWorkflowPrompt(),
+    },
+    {
+        name: 'doctor-workflow',
+        description: 'Environment and setup diagnosis workflow backing /doctor and /install-check',
+        arguments: [],
+        getPrompt: () => getDoctorWorkflowPrompt(),
+    },
+    {
+        name: 'update-workflow',
+        description: 'Package update workflow backing the /update command',
+        arguments: [],
+        getPrompt: () => getUpdateWorkflowPrompt(),
+    },
+    {
+        name: 'slash-commands',
+        description: 'Slash command catalog for FramingUI design workflows',
+        arguments: [],
+        getPrompt: () => getSlashCommandsPrompt(),
+    },
+    {
+        name: 'command-help',
+        description: 'Detailed help metadata for one slash command',
+        arguments: [
+            {
+                name: 'command',
+                required: true,
+                description: 'Slash command name such as /screen, /responsive, or /update',
+            },
+        ],
+        getPrompt: args => getCommandHelpPrompt(args?.command),
+    },
+];
+export function listPromptDefinitions() {
+    return promptCatalog.map(({ name, description, arguments: args }) => ({
+        name,
+        description,
+        arguments: args,
+    }));
+}
+export function getPromptDefinition(name) {
+    return promptCatalog.find(prompt => prompt.name === name);
+}
+//# sourceMappingURL=prompt-catalog.js.map

package/dist/prompts/prompt-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-catalog.js","sourceRoot":"","sources":["../../src/prompts/prompt-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,MAAM,aAAa,GAAuB;IACxC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mJAAmJ;QACrJ,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6EAA6E;QAC1F,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,kEAAkE;QAC/E,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,2BAA2B,EAAE;KAC/C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAE;KACzC;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,4DAA4D;QACzE,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,0BAA0B,EAAE;KAC9C;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6EAA6E;QAC1F,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,qDAAqD;QAClE,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,sDAAsD;QACnE,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,sBAAsB,EAAE;KAC1C;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,8CAA8C;QAC3D,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,6DAA6D;aAC3E;SACF;QACD,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC;KACvD;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB;IAKnC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI;QACJ,WAAW;QACX,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/prompts/responsive-workflow.d.ts

@@ -0,0 +1,10 @@
+export declare function getResponsiveWorkflowPrompt(): {
+    messages: {
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }[];
+};
+//# sourceMappingURL=responsive-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/responsive-workflow.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B;;;;;;;;EAkD1C"}

package/dist/prompts/responsive-workflow.js

@@ -0,0 +1,52 @@
+export function getResponsiveWorkflowPrompt() {
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `# FramingUI Responsive Optimization Workflow
+
+Use this workflow when the user asks to adapt an existing screen for smaller viewports, touch ergonomics, or density changes.
+
+## Primary command
+
+\`/responsive <target> [--mode mobile-first|tablet-safe|touch-optimized] [--density preserve|denser|lighter] [--breakpoint sm|md|lg]\`
+
+## Workflow
+
+1. Inspect the target screen or screen definition.
+2. Call \`list_tokens\` to confirm breakpoint and layout token options when layout changes are needed.
+3. Preserve the existing information architecture unless the current layout is clearly broken on smaller screens.
+4. Apply one primary responsive strategy:
+   - \`mobile-first\`: prioritize stacked layouts, simplified nav, compressed controls
+   - \`tablet-safe\`: preserve layout intent while preventing breakage around medium widths
+   - \`touch-optimized\`: increase hit targets, action spacing, and gesture-safe layouts
+5. Apply density refinement inside this command, not as a separate command:
+   - \`preserve\`: keep current information density, mainly reflow layout
+   - \`denser\`: preserve more information in constrained layouts
+   - \`lighter\`: reduce clutter and collapse secondary content
+6. Validate the updated definition with \`validate-screen-definition\`.
+7. If code output is requested, re-run \`generate_screen\`.
+
+## Expected output
+
+- Breakpoint-specific recommendations
+- Layout changes by section
+- Mobile/tablet nav strategy
+- Table/card/list transformations where relevant
+- Any overflow or cramped-interaction risks
+- Updated definition or regenerated code when requested
+
+## Important constraints
+
+- Do not invent unsupported layout tokens.
+- Do not split density into a standalone workflow; keep it under responsive optimization.
+- Prefer safe reflow over aesthetic-only changes.
+- If the current screen is already responsive, report that explicitly instead of forcing unnecessary edits.`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=responsive-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-workflow.js","sourceRoot":"","sources":["../../src/prompts/responsive-workflow.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4GAsC4F;iBACnG;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -1,6 +1,6 @@
 /**
  * MCP Prompts: Screen Generation Workflow
- * Step-by-step guide for the 4-step screen generation process
+ * Step-by-step guide for the production screen generation process
  */
 /**
  * Screen Workflow prompt with detailed 4-step process

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;;GAEG;AACH,wBAAgB,uBAAuB;;;;;;;;EAgPtC"}
+{"version":3,"file":"screen-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,uBAAuB;;;;;;;;EAsRtC"}

package/dist/prompts/screen-workflow.js

@@ -1,6 +1,6 @@
 /**
  * MCP Prompts: Screen Generation Workflow
- * Step-by-step guide for the 4-step screen generation process
+ * Step-by-step guide for the production screen generation process
  */
 /**
  * Screen Workflow prompt with detailed 4-step process
@@ -21,12 +21,39 @@ Optional: call \`whoami\` if you want to inspect the current session and license
 
 ## Overview
 
-The 4-step workflow ensures:
+The workflow ensures:
 - ✅ Correct component usage with inline props/variants
 - ✅ Validated screen structure with auto-fix patches
 - ✅ Theme recipes applied via the theme engine (generate_screen)
 - ✅ All dependencies installed
 - ✅ Tailwind CSS properly configured
+- ✅ Style contract compatibility checked before relying on FramingUI component defaults
+
+## Step 0: Detect Style Contract
+
+Before generating or integrating a screen, determine which styling contract the target project already uses.
+
+- \`framingui-native\`: project imports FramingUI styles or defines the full FramingUI variable contract
+- \`host-utility\`: project styles screens with direct Tailwind utilities and does not expose FramingUI variables
+- \`mixed\`: project defines only some FramingUI variables, which is the highest-risk state for broken component styling
+
+**Rule:** do not silently mix a utility-first host page with FramingUI component default variants in the same screen. Either:
+- stay utility-first and use explicit classes, or
+- migrate the page to the FramingUI variable contract after confirming with the user
+
+**Enforcement:** if \`projectPath\` is known, Step 0 preflight is required before \`/screen\` or \`/section\` generation.
+Use:
+\`\`\`json
+{
+  "projectPath": "/path/to/project",
+  "requiredPackages": [],
+  "checkTailwind": true,
+  "checkStyles": true
+}
+\`\`\`
+Block generation when:
+- \`styles.styleContract === "mixed"\`
+- \`styles.styleContract === "host-utility"\` and the user did not explicitly choose \`--style-contract host-utility\`
 
 ## Step 1/4: Get Screen Generation Context
 
@@ -152,7 +179,8 @@ The 4-step workflow ensures:
 {
   "projectPath": "/path/to/package.json",
   "requiredPackages": ["@radix-ui/react-slot", "@radix-ui/react-avatar"],
-  "checkTailwind": true
+  "checkTailwind": true,
+  "checkStyles": true
 }
 \`\`\`
 
@@ -163,6 +191,10 @@ The 4-step workflow ensures:
 - \`tailwind\`: Tailwind config validation results
   - \`issues\`: Problems found
   - \`fixes\`: How to fix each issue
+- \`styles\`: Style contract validation results
+  - \`styleContract\`: framingui-native, host-utility, mixed, or unknown
+  - \`issues\`: CSS contract mismatch risks
+  - \`fixes\`: Recommended next actions before integration
 
 **Tailwind Validation Checks:**
 - ✅ tailwind.config.{ts,js,mjs,cjs} exists
@@ -181,6 +213,9 @@ The 4-step workflow ensures:
 \`\`\`
 User: "Create a login page with email/password fields"
 
+0. Call validate-environment({ projectPath: "...", requiredPackages: [], checkStyles: true })
+   -> Classify style contract and decide host-utility vs framingui-native before generation
+
 1. Call get-screen-generation-context({ description: "login page..." })
    → Receive template matches, components with inline props, schema
 
@@ -220,19 +255,22 @@ User: "Create a login page with email/password fields"
 **Components render without styles:**
 - Verify Tailwind content paths include @framingui/ui
 - Check tailwindcss-animate plugin is configured
+- Check whether the target project is \`host-utility\`, \`mixed\`, or \`framingui-native\`
+- If the project is utility-first, prefer explicit classes instead of relying on FramingUI component defaults
 - Run validate-environment to diagnose
 
 ---
 
 ## Best Practices
 
-1. ✅ Always follow all 4 steps in order
+1. ✅ Always run Step 0 preflight before generation when projectPath is known
 2. ✅ Validate before generating code (Step 2)
 3. ✅ Use generate_screen for theme application (Step 3) - do NOT write code manually
 4. ✅ Check environment before delivering code (Step 4)
 5. ✅ Use strict validation mode for production
 6. ✅ Include theme recipes for visual consistency
 7. ✅ Use inline props from context instead of guessing
+8. ✅ Confirm the target style contract before relying on CSS variables or component defaults
 
 ## Alternative Workflows
 

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;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAoOwB;iBAC/B;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"screen-workflow.js","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA0QwB;iBAC/B;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/slash-commands.d.ts

@@ -0,0 +1,10 @@
+export declare function getSlashCommandsPrompt(): {
+    messages: {
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }[];
+};
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/prompts/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/prompts/slash-commands.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB;;;;;;;;EA8BrC"}

package/dist/prompts/slash-commands.js

@@ -0,0 +1,32 @@
+import { listSlashCommands } from '../commands/slash-command-registry.js';
+export function getSlashCommandsPrompt() {
+    const commandLines = listSlashCommands()
+        .map(command => `- \`${command.name}\` - ${command.summary}\n  Usage: \`${command.usage}\``)
+        .join('\n');
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `# FramingUI Slash Commands
+
+FramingUI exposes an intent-level command registry on top of MCP tools. Clients with slash menus or tab completion can render these commands directly. Clients without native command UX can use this registry for \`--help\` style guidance.
+
+## Command catalog
+
+${commandLines}
+
+## Notes
+
+- \`/responsive\` includes density control via \`--density preserve|denser|lighter\`
+- \`/screen\` and \`/section\` require a style-contract preflight (\`validate-environment\` with \`checkStyles: true\`) when project path is known
+- \`/update\` refreshes installed FramingUI packages in a target project
+- There is no standalone \`/density\`, \`/hierarchy\`, \`/palette\`, or \`/tone\` command in this phase
+- Use the \`command-help\` prompt with a command name to get detailed help for one command`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/prompts/slash-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/prompts/slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,UAAU,sBAAsB;IACpC,MAAM,YAAY,GAAG,iBAAiB,EAAE;SACrC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,QAAQ,OAAO,CAAC,OAAO,gBAAgB,OAAO,CAAC,KAAK,IAAI,CAAC;SAC3F,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;EAMd,YAAY;;;;;;;;2FAQ6E;iBAClF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}