npm - @salesforce/vite-plugin-lwc-ui-bundle - Versions diffs - 1.131.2 → 1.131.3 - Mend

@salesforce/vite-plugin-lwc-ui-bundle 1.131.2 → 1.131.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +36 -0
package/dist/providers/index.js +2 -2
package/dist/providers/index.js.map +1 -1
package/docs/consumer-guide.md +429 -0
package/package.json +4 -3
package/skills/setup-lwc-vite-plugin/SKILL.md +242 -0
package/docs/user-guide.md +0 -377

package/README.md CHANGED Viewed

@@ -2,6 +2,9 @@
 Vite plugin for compiling and running LWC components off-platform. Bundles the full compilation pipeline — scoped module providers, Lightning npm resolution, missing CSS handling, and the Vite/LWC bridge — behind a single configurable entry point.
+> **Getting started?** See the [Consumer Guide](docs/consumer-guide.md) for a
+> step-by-step walkthrough of adding this plugin to an existing LWC project.
 ## Installation
 ```bash
@@ -220,3 +223,36 @@ globalThis.__sfdc_sdk__ = await createDataSDK({ uiBundle: { basePath: "/" } });
 | ---------- | --------- | ------------------ | ------------------------------------ |
 | `orgAlias` | `string`  | sf CLI default org | Salesforce org alias                 |
 | `debug`    | `boolean` | `false`            | Log each proxied request to terminal |
+## Claude Code Skill
+This package includes a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skill that interactively sets up the plugin in your LWC project. It detects your project structure, asks which component to use as the root, inspects the component tree for GraphQL/label/base-component usage, and generates all the config files.
+### Installing the skill
+**Option A — Global (available in all projects):**
+```bash
+cp -r node_modules/@salesforce/vite-plugin-lwc-ui-bundle/skills/setup-lwc-vite-plugin \
+  ~/.claude/skills/setup-lwc-vite-plugin
+```
+**Option B — Project-scoped (available only in this project):**
+```bash
+mkdir -p .claude/skills
+cp -r node_modules/@salesforce/vite-plugin-lwc-ui-bundle/skills/setup-lwc-vite-plugin \
+  .claude/skills/setup-lwc-vite-plugin
+```
+### Using the skill
+Once installed, the skill triggers automatically in Claude Code when you ask things like:
+- "Set up vite-plugin-lwc-ui-bundle in my project"
+- "I want to run my LWC components outside Salesforce"
+- "Build a static LWC bundle"
+- "Add Vite to my SFDX project"
+- "Compile LWC off-platform"
+You can also invoke it explicitly with `/setup-lwc-vite-plugin`.

package/dist/providers/index.js CHANGED Viewed

@@ -321,7 +321,7 @@ export class graphql {
         try {
             // 1. UIBundle / local dev: use globalThis.__sfdc_sdk__.graphql if available
             if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {
-                const result = await globalThis.__sfdc_sdk__.graphql(query, variables);
+                const result = await globalThis.__sfdc_sdk__.graphql({ query, variables });
                 this._emit({ data: result?.data, errors: result?.errors });
                 return;
             }
@@ -389,7 +389,7 @@ export async function executeMutation(config) {
     try {
         // 1. UIBundle / local dev
         if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {
-            const result = await globalThis.__sfdc_sdk__.graphql(query, variables ?? {});
+            const result = await globalThis.__sfdc_sdk__.graphql({ query, variables: variables ?? {} });
             return { data: result?.data, errors: result?.errors };
         }
         // 2. MCP surface

package/dist/providers/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sources":["../../src/providers/label.ts","../../src/providers/i18n.ts","../../src/providers/gate.ts","../../src/providers/access-check.ts","../../src/providers/client.ts","../../src/providers/primitive-utils.ts","../../src/providers/lightning-graphql.ts"],"sourcesContent":["/*\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst LABEL_DEFAULTS: Record<string, string> = {\n\t\"LightningForm.edit\": \"Edit\",\n\t\"LightningForm.save\": \"Save\",\n\t\"LightningForm.cancel\": \"Cancel\",\n\t\"LightningForm.error\": \"Error\",\n\t\"RecordDetailUC.Expand\": \"Expand\",\n\t\"RecordDetailUC.Collapse\": \"Collapse\",\n\t\"Global_Entity.created_by\": \"Created By\",\n\t\"Global_Entity.last_modified_by\": \"Last Modified By\",\n\t\"DetailError.GenericSaveError\": \"An error occurred while saving.\",\n\t\"MobileWebError.NoPreEditAccess\": \"You don't have access to edit this record.\",\n\t\"DuplicateList.ToastMessageBlock\": \"Duplicate records were found.\",\n\t\"DuplicateList.NonBlockingHeaderText\": \"Duplicate records found\",\n\t\"DuplicateList.ToastMessageAlertEdit\": \"Duplicate records were found. You can continue editing.\",\n\t\"Errors.ErrorPopoverHeading\": \"Error\",\n};\n\nexport function label(overrides: Record<string, string> = {}): Provider {\n\tconst defaults = { ...LABEL_DEFAULTS, ...overrides };\n\treturn {\n\t\tprefix: \"@salesforce/label/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/label/\")) return null;\n\n\t\t\tconst key = specifier.slice(\"@salesforce/label/\".length);\n\t\t\tconst fallbackLabel = key\n\t\t\t\t.split(\".\")\n\t\t\t\t.at(-1)!\n\t\t\t\t.replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n\t\t\t\t.replace(/_/g, \" \")\n\t\t\t\t.trim();\n\t\t\tconst value = defaults[key] ?? fallbackLabel;\n\t\t\treturn `export default ${JSON.stringify(value)};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst BROWSER_DERIVED = new Set([\n\t\"lang\",\n\t\"dir\",\n\t\"locale\",\n\t\"currency\",\n\t\"timeZone\",\n\t\"firstDayOfWeek\",\n]);\n\nconst STATIC_DEFAULTS: Record<string, string> = {\n\t\"dateTime.shortDateFormat\": \"M/d/yyyy\",\n\t\"dateTime.mediumDateFormat\": \"MMM d, yyyy\",\n\t\"dateTime.longDateFormat\": \"MMMM d, yyyy\",\n\t\"dateTime.shortTimeFormat\": \"h:mm a\",\n\t\"dateTime.mediumTimeFormat\": \"h:mm:ss a\",\n\t\"dateTime.longTimeFormat\": \"h:mm:ss a z\",\n\t\"dateTime.shortDateTimeFormat\": \"M/d/yyyy, h:mm a\",\n\t\"number.numberFormat\": \"#,##0.##\",\n\t\"number.currencyFormat\": \"¤#,##0.00\",\n\t\"number.decimalSeparator\": \".\",\n\t\"number.groupingSeparator\": \",\",\n\t\"number.percentFormat\": \"#,##0%\",\n\t\"number.percentSign\": \"%\",\n\t\"number.plusSign\": \"+\",\n\t\"number.minusSign\": \"-\",\n\t\"number.exponentialSign\": \"E\",\n\t\"number.superscriptingExponentSign\": \"×\",\n\t\"number.perMilleSign\": \"‰\",\n\t\"number.infinity\": \"∞\",\n\t\"number.nan\": \"NaN\",\n\t\"number.currencySymbol\": \"$\",\n\tdefaultCalendar: \"gregory\",\n\tdefaultNumberingSystem: \"latn\",\n};\n\nconst MONTHS_WIDE = [\n\t\"January\",\n\t\"February\",\n\t\"March\",\n\t\"April\",\n\t\"May\",\n\t\"June\",\n\t\"July\",\n\t\"August\",\n\t\"September\",\n\t\"October\",\n\t\"November\",\n\t\"December\",\n];\nconst MONTHS_ABBR = [\n\t\"Jan\",\n\t\"Feb\",\n\t\"Mar\",\n\t\"Apr\",\n\t\"May\",\n\t\"Jun\",\n\t\"Jul\",\n\t\"Aug\",\n\t\"Sep\",\n\t\"Oct\",\n\t\"Nov\",\n\t\"Dec\",\n];\nconst DAYS_WIDE = [\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"];\nconst DAYS_ABBR = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\nconst OBJECT_DEFAULTS: Record<string, unknown> = {\n\t\"common.digits\": { latn: \"0123456789\" },\n\t\"common.calendarData\": {\n\t\tgregory: { calendarSystem: \"solar\", eras: {} },\n\t},\n\tcalendarData: {\n\t\tgregory: {\n\t\t\tmonths: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: MONTHS_WIDE,\n\t\t\t\t\tabbreviated: MONTHS_ABBR,\n\t\t\t\t\tnarrow: MONTHS_ABBR,\n\t\t\t\t},\n\t\t\t},\n\t\t\tdays: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: DAYS_WIDE,\n\t\t\t\t\tabbreviated: DAYS_ABBR,\n\t\t\t\t\tnarrow: DAYS_ABBR,\n\t\t\t\t},\n\t\t\t},\n\t\t\tdayPeriods: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: [\"AM\", \"PM\"],\n\t\t\t\t\tabbreviated: [\"am\", \"pm\"],\n\t\t\t\t\tnarrow: [\"a\", \"p\"],\n\t\t\t\t},\n\t\t\t},\n\t\t\teras: {\n\t\t\t\teraAbbr: [\"AD\"],\n\t\t\t\teraNames: [\"Anno Domini\"],\n\t\t\t\teraNarrow: [\"A\"],\n\t\t\t},\n\t\t},\n\t},\n};\n\nconst RUNTIME_SOURCE = `\nconst RTL_LANGS = new Set([\n 'ar', 'arc', 'dv', 'fa', 'ha', 'he', 'khw', 'ks', 'ku', 'ps', 'ur', 'yi',\n]);\n\nfunction getLocale() {\n if (typeof navigator === 'undefined') return 'en-US';\n return navigator.language \|\| 'en-US';\n}\n\nfunction getLang() {\n return getLocale().split('-')[0];\n}\n\nfunction getDir() {\n return RTL_LANGS.has(getLang()) ? 'rtl' : 'ltr';\n}\n\nfunction getCurrency() {\n try {\n const parts = new Intl.NumberFormat(getLocale(), {\n style: 'currency',\n currency: 'USD',\n currencyDisplay: 'code',\n }).resolvedOptions();\n return parts.currency \|\| 'USD';\n } catch {\n return 'USD';\n }\n}\n\nfunction getTimeZone() {\n try {\n return Intl.DateTimeFormat().resolvedOptions().timeZone \|\| 'UTC';\n } catch {\n return 'UTC';\n }\n}\n\nfunction getFirstDayOfWeek() {\n try {\n const loc = new Intl.Locale(getLocale());\n if (loc.weekInfo) return String(loc.weekInfo.firstDay);\n if (typeof loc.getWeekInfo === 'function') return String(loc.getWeekInfo().firstDay);\n } catch { / unsupported in this browser / }\n return '7';\n}\n\nconst values = {\n lang: getLang(),\n dir: getDir(),\n locale: getLocale(),\n currency: getCurrency(),\n timeZone: getTimeZone(),\n firstDayOfWeek: getFirstDayOfWeek(),\n};\n\nexport default values['__KEY__'];\n`;\n\nexport interface I18nOptions {\n\tstaticOverrides?: Record<string, string>;\n\tobjectOverrides?: Record<string, unknown>;\n}\n\nexport function i18n(options: I18nOptions = {}): Provider {\n\tconst { staticOverrides = {}, objectOverrides = {} } = options;\n\tconst statics = { ...STATIC_DEFAULTS, ...staticOverrides };\n\tconst objects = { ...OBJECT_DEFAULTS, ...objectOverrides };\n\n\treturn {\n\t\tprefix: \"@salesforce/i18n/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/i18n/\")) return null;\n\n\t\t\tconst key = specifier.slice(\"@salesforce/i18n/\".length);\n\n\t\t\tif (BROWSER_DERIVED.has(key)) {\n\t\t\t\treturn RUNTIME_SOURCE.replace(\"__KEY__\", key);\n\t\t\t}\n\n\t\t\tif (key in objects) {\n\t\t\t\treturn `export default ${JSON.stringify(objects[key])};`;\n\t\t\t}\n\n\t\t\tconst value = statics[key] ?? key;\n\t\t\treturn `export default ${JSON.stringify(value)};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function gate(overrides: Record<string, boolean> = {}): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/gate/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/gate/\")) return null;\n\t\t\tconst name = specifier.slice(\"@salesforce/gate/\".length);\n\t\t\tconst isOpen = overrides[name] ?? true;\n\t\t\treturn `export default { isOpen: () => ${isOpen} };`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function accessCheck(overrides: Record<string, boolean> = {}): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/accessCheck/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/accessCheck/\")) return null;\n\t\t\tconst name = specifier.slice(\"@salesforce/accessCheck/\".length);\n\t\t\tconst value = overrides[name] ?? false;\n\t\t\treturn `export default ${value};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst FORM_FACTOR_SOURCE = `\nfunction getFormFactor() {\n if (typeof window === 'undefined') return 'Large';\n if (window.matchMedia('(max-width: 767px)').matches) return 'Small';\n if (window.matchMedia('(max-width: 1023px)').matches) return 'Medium';\n return 'Large';\n}\n\nexport default getFormFactor();\n`;\n\nexport function client(): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/client/\",\n\t\tresolve(specifier) {\n\t\t\tif (specifier === \"@salesforce/client/formFactor\") {\n\t\t\t\treturn FORM_FACTOR_SOURCE;\n\t\t\t}\n\t\t\treturn null;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function primitiveUtils(): Provider {\n\treturn {\n\t\tprefix: \"lightning/primitiveUtils\",\n\t\tmatch(id) {\n\t\t\treturn id === \"lightning/primitiveUtils\";\n\t\t},\n\t\tresolve(specifier) {\n\t\t\tif (specifier !== \"lightning/primitiveUtils\") return null;\n\n\t\t\treturn `export function normalizeBoolean(value) {\n return typeof value === 'string' \|\| !!value;\n}\n\nexport function reflectAttribute(element, attrName, value) {\n if (!element) return;\n if (typeof value === 'string') {\n element.setAttribute(attrName, value);\n } else if (value === true) {\n element.setAttribute(attrName, '');\n } else if (!value) {\n element.removeAttribute(attrName);\n } else {\n console.warn(\\`Invalid attribute value for \"\\${attrName}\": \\${value}\\`);\n }\n}\n`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport interface LightningGraphqlOptions {\n\t/\n\t Name of the MCP tool to call for GraphQL query execution.\n\t * Defaults to `'graphqlQuery'`.\n\t \n\t The tool must accept `{ query: string; variables?: Record<string, unknown> }`\n\t * and return a GraphQL-shaped response: `{ data: unknown; errors?: unknown[] }`.\n\t \n\t The result is normalised across surfaces:\n\t * - OpenAI surface: `sdk.callTool()` resolves with `{ result: \"<JSON string>\" }`\n\t * - MCP Apps surface: `sdk.callTool()` resolves with `{ structuredContent, content }`\n\t /\n\ttoolName?: string;\n}\n\n/\n Off-platform implementation of `lightning/graphql`.\n \n Provides the `gql` tagged-template helper and a `graphql` wire adapter that\n * executes GraphQL queries by calling an MCP tool via `@salesforce/sdk-chat`.\n \n `getChatSDK()` auto-detects the host surface:\n * - `window.openai` present → OpenAI/ChatGPT bridge (`window.openai.callTool`)\n * - Inside an iframe → MCP Apps JSON-RPC session (with OpenAI fallback)\n * - Neither → UIBundle stub (no callTool; adapter emits an error)\n \n The tool name is configurable via `options.toolName` (default `'graphqlQuery'`).\n * Requires `@salesforce/sdk-chat` as a peer dependency.\n */\nfunction buildGraphqlSource(toolName: string): string {\n\treturn `\nimport { getChatSDK } from '@salesforce/sdk-chat';\n\nexport function gql(strings, ...values) {\n let result = '';\n strings.forEach((string, i) => {\n result += string;\n if (i < values.length) result += String(values[i]);\n });\n return result;\n}\n\nexport class graphql {\n _dataCallback;\n _config;\n\n constructor(dataCallback) {\n this._dataCallback = dataCallback;\n }\n\n connect() { this._fetch(); }\n disconnect() {}\n\n update(config) {\n this._config = config;\n this._fetch();\n }\n\n refresh() {\n return this._fetch();\n }\n\n async _fetch() {\n const query = this._config?.query;\n const variables = this._config?.variables ?? {};\n\n if (!query) {\n this._emit({ data: undefined, errors: undefined });\n return;\n }\n\n try {\n // 1. UIBundle / local dev: use globalThis.__sfdc_sdk__.graphql if available\n if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {\n const result = await globalThis.__sfdc_sdk__.graphql(query, variables);\n this._emit({ data: result?.data, errors: result?.errors });\n return;\n }\n\n // 2. MCP surface: use getChatSDK().callTool\n const sdk = await getChatSDK();\n\n if (typeof sdk.callTool !== 'function') {\n throw new Error(\n '[lightning/graphql] No data surface available. ' +\n 'Either initialise globalThis.__sfdc_sdk__ with createDataSDK, ' +\n 'or run inside a ChatGPT / MCP Apps context.'\n );\n }\n\n const raw = await sdk.callTool({\n toolName: ${JSON.stringify(toolName)},\n params: { query, variables },\n });\n\n // Normalise result across surfaces:\n // - OpenAI surface: { result: \"<JSON string of { data, errors }>\" }\n // - MCP Apps surface: { structuredContent: { data, errors }, content: [...] }\n let result;\n if (raw?.structuredContent !== undefined) {\n result = raw.structuredContent;\n } else if (typeof raw?.result === 'string') {\n const parsed = JSON.parse(raw.result);\n if (Array.isArray(parsed)) {\n // MCP content array - extract text from first text block\n const textBlock = parsed.find(\n (b) => b && b.type === 'text' && typeof b.text === 'string',\n );\n const text = textBlock ? textBlock.text : null;\n if (text) {\n try { result = JSON.parse(text); } catch { result = { errors: [{ message: text }] }; }\n } else {\n result = {};\n }\n } else {\n result = parsed;\n }\n } else {\n result = raw ?? {};\n }\n\n this._emit({ data: result?.data, errors: result?.errors });\n } catch (error) {\n this._emit({ data: undefined, errors: [{ message: error.message }] });\n }\n }\n\n _emit({ data, errors }) {\n this._dataCallback({\n data,\n error: errors?.length ? errors : undefined,\n refresh: () => this.refresh(),\n });\n }\n}\n\nexport async function executeMutation(config) {\n const { query, variables } = config;\n if (!query) return { data: undefined, errors: [{ message: 'No query provided' }] };\n try {\n // 1. UIBundle / local dev\n if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {\n const result = await globalThis.__sfdc_sdk__.graphql(query, variables ?? {});\n return { data: result?.data, errors: result?.errors };\n }\n // 2. MCP surface\n const sdk = await getChatSDK();\n if (typeof sdk.callTool !== 'function') {\n throw new Error('[lightning/graphql] No data surface available.');\n }\n const raw = await sdk.callTool({\n toolName: ${JSON.stringify(toolName)},\n params: { query, variables: variables ?? {} },\n });\n let result;\n if (raw?.structuredContent !== undefined) {\n result = raw.structuredContent;\n } else if (typeof raw?.result === 'string') {\n const parsed = JSON.parse(raw.result);\n if (Array.isArray(parsed)) {\n const textBlock = parsed.find(\n (b) => b && b.type === 'text' && typeof b.text === 'string',\n );\n const text = textBlock ? textBlock.text : null;\n if (text) {\n try { result = JSON.parse(text); } catch { result = { errors: [{ message: text }] }; }\n } else {\n result = {};\n }\n } else {\n result = parsed;\n }\n } else {\n result = raw ?? {};\n }\n return { data: result?.data, errors: result?.errors };\n } catch (error) {\n return { data: undefined, errors: [{ message: error.message }] };\n }\n}\n`;\n}\n\nexport function lightningGraphql(options: LightningGraphqlOptions = {}): Provider {\n\tconst toolName = options.toolName ?? \"graphqlQuery\";\n\treturn {\n\t\tprefix: \"lightning/graphql\",\n\t\tresolve(specifier) {\n\t\t\tif (specifier !== \"lightning/graphql\") return null;\n\t\t\treturn buildGraphqlSource(toolName);\n\t\t},\n\t};\n}\n"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"index.js","sources":["../../src/providers/label.ts","../../src/providers/i18n.ts","../../src/providers/gate.ts","../../src/providers/access-check.ts","../../src/providers/client.ts","../../src/providers/primitive-utils.ts","../../src/providers/lightning-graphql.ts"],"sourcesContent":["/*\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst LABEL_DEFAULTS: Record<string, string> = {\n\t\"LightningForm.edit\": \"Edit\",\n\t\"LightningForm.save\": \"Save\",\n\t\"LightningForm.cancel\": \"Cancel\",\n\t\"LightningForm.error\": \"Error\",\n\t\"RecordDetailUC.Expand\": \"Expand\",\n\t\"RecordDetailUC.Collapse\": \"Collapse\",\n\t\"Global_Entity.created_by\": \"Created By\",\n\t\"Global_Entity.last_modified_by\": \"Last Modified By\",\n\t\"DetailError.GenericSaveError\": \"An error occurred while saving.\",\n\t\"MobileWebError.NoPreEditAccess\": \"You don't have access to edit this record.\",\n\t\"DuplicateList.ToastMessageBlock\": \"Duplicate records were found.\",\n\t\"DuplicateList.NonBlockingHeaderText\": \"Duplicate records found\",\n\t\"DuplicateList.ToastMessageAlertEdit\": \"Duplicate records were found. You can continue editing.\",\n\t\"Errors.ErrorPopoverHeading\": \"Error\",\n};\n\nexport function label(overrides: Record<string, string> = {}): Provider {\n\tconst defaults = { ...LABEL_DEFAULTS, ...overrides };\n\treturn {\n\t\tprefix: \"@salesforce/label/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/label/\")) return null;\n\n\t\t\tconst key = specifier.slice(\"@salesforce/label/\".length);\n\t\t\tconst fallbackLabel = key\n\t\t\t\t.split(\".\")\n\t\t\t\t.at(-1)!\n\t\t\t\t.replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n\t\t\t\t.replace(/_/g, \" \")\n\t\t\t\t.trim();\n\t\t\tconst value = defaults[key] ?? fallbackLabel;\n\t\t\treturn `export default ${JSON.stringify(value)};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst BROWSER_DERIVED = new Set([\n\t\"lang\",\n\t\"dir\",\n\t\"locale\",\n\t\"currency\",\n\t\"timeZone\",\n\t\"firstDayOfWeek\",\n]);\n\nconst STATIC_DEFAULTS: Record<string, string> = {\n\t\"dateTime.shortDateFormat\": \"M/d/yyyy\",\n\t\"dateTime.mediumDateFormat\": \"MMM d, yyyy\",\n\t\"dateTime.longDateFormat\": \"MMMM d, yyyy\",\n\t\"dateTime.shortTimeFormat\": \"h:mm a\",\n\t\"dateTime.mediumTimeFormat\": \"h:mm:ss a\",\n\t\"dateTime.longTimeFormat\": \"h:mm:ss a z\",\n\t\"dateTime.shortDateTimeFormat\": \"M/d/yyyy, h:mm a\",\n\t\"number.numberFormat\": \"#,##0.##\",\n\t\"number.currencyFormat\": \"¤#,##0.00\",\n\t\"number.decimalSeparator\": \".\",\n\t\"number.groupingSeparator\": \",\",\n\t\"number.percentFormat\": \"#,##0%\",\n\t\"number.percentSign\": \"%\",\n\t\"number.plusSign\": \"+\",\n\t\"number.minusSign\": \"-\",\n\t\"number.exponentialSign\": \"E\",\n\t\"number.superscriptingExponentSign\": \"×\",\n\t\"number.perMilleSign\": \"‰\",\n\t\"number.infinity\": \"∞\",\n\t\"number.nan\": \"NaN\",\n\t\"number.currencySymbol\": \"$\",\n\tdefaultCalendar: \"gregory\",\n\tdefaultNumberingSystem: \"latn\",\n};\n\nconst MONTHS_WIDE = [\n\t\"January\",\n\t\"February\",\n\t\"March\",\n\t\"April\",\n\t\"May\",\n\t\"June\",\n\t\"July\",\n\t\"August\",\n\t\"September\",\n\t\"October\",\n\t\"November\",\n\t\"December\",\n];\nconst MONTHS_ABBR = [\n\t\"Jan\",\n\t\"Feb\",\n\t\"Mar\",\n\t\"Apr\",\n\t\"May\",\n\t\"Jun\",\n\t\"Jul\",\n\t\"Aug\",\n\t\"Sep\",\n\t\"Oct\",\n\t\"Nov\",\n\t\"Dec\",\n];\nconst DAYS_WIDE = [\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"];\nconst DAYS_ABBR = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\nconst OBJECT_DEFAULTS: Record<string, unknown> = {\n\t\"common.digits\": { latn: \"0123456789\" },\n\t\"common.calendarData\": {\n\t\tgregory: { calendarSystem: \"solar\", eras: {} },\n\t},\n\tcalendarData: {\n\t\tgregory: {\n\t\t\tmonths: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: MONTHS_WIDE,\n\t\t\t\t\tabbreviated: MONTHS_ABBR,\n\t\t\t\t\tnarrow: MONTHS_ABBR,\n\t\t\t\t},\n\t\t\t},\n\t\t\tdays: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: DAYS_WIDE,\n\t\t\t\t\tabbreviated: DAYS_ABBR,\n\t\t\t\t\tnarrow: DAYS_ABBR,\n\t\t\t\t},\n\t\t\t},\n\t\t\tdayPeriods: {\n\t\t\t\tformat: {\n\t\t\t\t\twide: [\"AM\", \"PM\"],\n\t\t\t\t\tabbreviated: [\"am\", \"pm\"],\n\t\t\t\t\tnarrow: [\"a\", \"p\"],\n\t\t\t\t},\n\t\t\t},\n\t\t\teras: {\n\t\t\t\teraAbbr: [\"AD\"],\n\t\t\t\teraNames: [\"Anno Domini\"],\n\t\t\t\teraNarrow: [\"A\"],\n\t\t\t},\n\t\t},\n\t},\n};\n\nconst RUNTIME_SOURCE = `\nconst RTL_LANGS = new Set([\n 'ar', 'arc', 'dv', 'fa', 'ha', 'he', 'khw', 'ks', 'ku', 'ps', 'ur', 'yi',\n]);\n\nfunction getLocale() {\n if (typeof navigator === 'undefined') return 'en-US';\n return navigator.language \|\| 'en-US';\n}\n\nfunction getLang() {\n return getLocale().split('-')[0];\n}\n\nfunction getDir() {\n return RTL_LANGS.has(getLang()) ? 'rtl' : 'ltr';\n}\n\nfunction getCurrency() {\n try {\n const parts = new Intl.NumberFormat(getLocale(), {\n style: 'currency',\n currency: 'USD',\n currencyDisplay: 'code',\n }).resolvedOptions();\n return parts.currency \|\| 'USD';\n } catch {\n return 'USD';\n }\n}\n\nfunction getTimeZone() {\n try {\n return Intl.DateTimeFormat().resolvedOptions().timeZone \|\| 'UTC';\n } catch {\n return 'UTC';\n }\n}\n\nfunction getFirstDayOfWeek() {\n try {\n const loc = new Intl.Locale(getLocale());\n if (loc.weekInfo) return String(loc.weekInfo.firstDay);\n if (typeof loc.getWeekInfo === 'function') return String(loc.getWeekInfo().firstDay);\n } catch { / unsupported in this browser / }\n return '7';\n}\n\nconst values = {\n lang: getLang(),\n dir: getDir(),\n locale: getLocale(),\n currency: getCurrency(),\n timeZone: getTimeZone(),\n firstDayOfWeek: getFirstDayOfWeek(),\n};\n\nexport default values['__KEY__'];\n`;\n\nexport interface I18nOptions {\n\tstaticOverrides?: Record<string, string>;\n\tobjectOverrides?: Record<string, unknown>;\n}\n\nexport function i18n(options: I18nOptions = {}): Provider {\n\tconst { staticOverrides = {}, objectOverrides = {} } = options;\n\tconst statics = { ...STATIC_DEFAULTS, ...staticOverrides };\n\tconst objects = { ...OBJECT_DEFAULTS, ...objectOverrides };\n\n\treturn {\n\t\tprefix: \"@salesforce/i18n/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/i18n/\")) return null;\n\n\t\t\tconst key = specifier.slice(\"@salesforce/i18n/\".length);\n\n\t\t\tif (BROWSER_DERIVED.has(key)) {\n\t\t\t\treturn RUNTIME_SOURCE.replace(\"__KEY__\", key);\n\t\t\t}\n\n\t\t\tif (key in objects) {\n\t\t\t\treturn `export default ${JSON.stringify(objects[key])};`;\n\t\t\t}\n\n\t\t\tconst value = statics[key] ?? key;\n\t\t\treturn `export default ${JSON.stringify(value)};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function gate(overrides: Record<string, boolean> = {}): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/gate/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/gate/\")) return null;\n\t\t\tconst name = specifier.slice(\"@salesforce/gate/\".length);\n\t\t\tconst isOpen = overrides[name] ?? true;\n\t\t\treturn `export default { isOpen: () => ${isOpen} };`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function accessCheck(overrides: Record<string, boolean> = {}): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/accessCheck/\",\n\t\tresolve(specifier) {\n\t\t\tif (!specifier.startsWith(\"@salesforce/accessCheck/\")) return null;\n\t\t\tconst name = specifier.slice(\"@salesforce/accessCheck/\".length);\n\t\t\tconst value = overrides[name] ?? false;\n\t\t\treturn `export default ${value};`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nconst FORM_FACTOR_SOURCE = `\nfunction getFormFactor() {\n if (typeof window === 'undefined') return 'Large';\n if (window.matchMedia('(max-width: 767px)').matches) return 'Small';\n if (window.matchMedia('(max-width: 1023px)').matches) return 'Medium';\n return 'Large';\n}\n\nexport default getFormFactor();\n`;\n\nexport function client(): Provider {\n\treturn {\n\t\tprefix: \"@salesforce/client/\",\n\t\tresolve(specifier) {\n\t\t\tif (specifier === \"@salesforce/client/formFactor\") {\n\t\t\t\treturn FORM_FACTOR_SOURCE;\n\t\t\t}\n\t\t\treturn null;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport function primitiveUtils(): Provider {\n\treturn {\n\t\tprefix: \"lightning/primitiveUtils\",\n\t\tmatch(id) {\n\t\t\treturn id === \"lightning/primitiveUtils\";\n\t\t},\n\t\tresolve(specifier) {\n\t\t\tif (specifier !== \"lightning/primitiveUtils\") return null;\n\n\t\t\treturn `export function normalizeBoolean(value) {\n return typeof value === 'string' \|\| !!value;\n}\n\nexport function reflectAttribute(element, attrName, value) {\n if (!element) return;\n if (typeof value === 'string') {\n element.setAttribute(attrName, value);\n } else if (value === true) {\n element.setAttribute(attrName, '');\n } else if (!value) {\n element.removeAttribute(attrName);\n } else {\n console.warn(\\`Invalid attribute value for \"\\${attrName}\": \\${value}\\`);\n }\n}\n`;\n\t\t},\n\t};\n}\n","/\n Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n /\nimport type { Provider } from \"../types\";\n\nexport interface LightningGraphqlOptions {\n\t/\n\t Name of the MCP tool to call for GraphQL query execution.\n\t * Defaults to `'graphqlQuery'`.\n\t \n\t The tool must accept `{ query: string; variables?: Record<string, unknown> }`\n\t * and return a GraphQL-shaped response: `{ data: unknown; errors?: unknown[] }`.\n\t \n\t The result is normalised across surfaces:\n\t * - OpenAI surface: `sdk.callTool()` resolves with `{ result: \"<JSON string>\" }`\n\t * - MCP Apps surface: `sdk.callTool()` resolves with `{ structuredContent, content }`\n\t /\n\ttoolName?: string;\n}\n\n/\n Off-platform implementation of `lightning/graphql`.\n \n Provides the `gql` tagged-template helper and a `graphql` wire adapter that\n * executes GraphQL queries by calling an MCP tool via `@salesforce/sdk-chat`.\n \n `getChatSDK()` auto-detects the host surface:\n * - `window.openai` present → OpenAI/ChatGPT bridge (`window.openai.callTool`)\n * - Inside an iframe → MCP Apps JSON-RPC session (with OpenAI fallback)\n * - Neither → UIBundle stub (no callTool; adapter emits an error)\n \n The tool name is configurable via `options.toolName` (default `'graphqlQuery'`).\n * Requires `@salesforce/sdk-chat` as a peer dependency.\n */\nfunction buildGraphqlSource(toolName: string): string {\n\treturn `\nimport { getChatSDK } from '@salesforce/sdk-chat';\n\nexport function gql(strings, ...values) {\n let result = '';\n strings.forEach((string, i) => {\n result += string;\n if (i < values.length) result += String(values[i]);\n });\n return result;\n}\n\nexport class graphql {\n _dataCallback;\n _config;\n\n constructor(dataCallback) {\n this._dataCallback = dataCallback;\n }\n\n connect() { this._fetch(); }\n disconnect() {}\n\n update(config) {\n this._config = config;\n this._fetch();\n }\n\n refresh() {\n return this._fetch();\n }\n\n async _fetch() {\n const query = this._config?.query;\n const variables = this._config?.variables ?? {};\n\n if (!query) {\n this._emit({ data: undefined, errors: undefined });\n return;\n }\n\n try {\n // 1. UIBundle / local dev: use globalThis.__sfdc_sdk__.graphql if available\n if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {\n const result = await globalThis.__sfdc_sdk__.graphql({ query, variables });\n this._emit({ data: result?.data, errors: result?.errors });\n return;\n }\n\n // 2. MCP surface: use getChatSDK().callTool\n const sdk = await getChatSDK();\n\n if (typeof sdk.callTool !== 'function') {\n throw new Error(\n '[lightning/graphql] No data surface available. ' +\n 'Either initialise globalThis.__sfdc_sdk__ with createDataSDK, ' +\n 'or run inside a ChatGPT / MCP Apps context.'\n );\n }\n\n const raw = await sdk.callTool({\n toolName: ${JSON.stringify(toolName)},\n params: { query, variables },\n });\n\n // Normalise result across surfaces:\n // - OpenAI surface: { result: \"<JSON string of { data, errors }>\" }\n // - MCP Apps surface: { structuredContent: { data, errors }, content: [...] }\n let result;\n if (raw?.structuredContent !== undefined) {\n result = raw.structuredContent;\n } else if (typeof raw?.result === 'string') {\n const parsed = JSON.parse(raw.result);\n if (Array.isArray(parsed)) {\n // MCP content array - extract text from first text block\n const textBlock = parsed.find(\n (b) => b && b.type === 'text' && typeof b.text === 'string',\n );\n const text = textBlock ? textBlock.text : null;\n if (text) {\n try { result = JSON.parse(text); } catch { result = { errors: [{ message: text }] }; }\n } else {\n result = {};\n }\n } else {\n result = parsed;\n }\n } else {\n result = raw ?? {};\n }\n\n this._emit({ data: result?.data, errors: result?.errors });\n } catch (error) {\n this._emit({ data: undefined, errors: [{ message: error.message }] });\n }\n }\n\n _emit({ data, errors }) {\n this._dataCallback({\n data,\n error: errors?.length ? errors : undefined,\n refresh: () => this.refresh(),\n });\n }\n}\n\nexport async function executeMutation(config) {\n const { query, variables } = config;\n if (!query) return { data: undefined, errors: [{ message: 'No query provided' }] };\n try {\n // 1. UIBundle / local dev\n if (typeof globalThis.__sfdc_sdk__?.graphql === 'function') {\n const result = await globalThis.__sfdc_sdk__.graphql({ query, variables: variables ?? {} });\n return { data: result?.data, errors: result?.errors };\n }\n // 2. MCP surface\n const sdk = await getChatSDK();\n if (typeof sdk.callTool !== 'function') {\n throw new Error('[lightning/graphql] No data surface available.');\n }\n const raw = await sdk.callTool({\n toolName: ${JSON.stringify(toolName)},\n params: { query, variables: variables ?? {} },\n });\n let result;\n if (raw?.structuredContent !== undefined) {\n result = raw.structuredContent;\n } else if (typeof raw?.result === 'string') {\n const parsed = JSON.parse(raw.result);\n if (Array.isArray(parsed)) {\n const textBlock = parsed.find(\n (b) => b && b.type === 'text' && typeof b.text === 'string',\n );\n const text = textBlock ? textBlock.text : null;\n if (text) {\n try { result = JSON.parse(text); } catch { result = { errors: [{ message: text }] }; }\n } else {\n result = {};\n }\n } else {\n result = parsed;\n }\n } else {\n result = raw ?? {};\n }\n return { data: result?.data, errors: result?.errors };\n } catch (error) {\n return { data: undefined, errors: [{ message: error.message }] };\n }\n}\n`;\n}\n\nexport function lightningGraphql(options: LightningGraphqlOptions = {}): Provider {\n\tconst toolName = options.toolName ?? \"graphqlQuery\";\n\treturn {\n\t\tprefix: \"lightning/graphql\",\n\t\tresolve(specifier) {\n\t\t\tif (specifier !== \"lightning/graphql\") return null;\n\t\t\treturn buildGraphqlSource(toolName);\n\t\t},\n\t};\n}\n"],"names":[],"mappings":"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"}

package/docs/consumer-guide.md ADDED Viewed

@@ -0,0 +1,429 @@
+# Compiling LWC Components Off-Platform with @salesforce/vite-plugin-lwc-ui-bundle
+This guide walks you through adding `@salesforce/vite-plugin-lwc-ui-bundle` to an
+existing LWC project so you can compile your components into a single self-contained
+`dist/index.html` that runs in any browser — no Salesforce org required.
+---
+## Prerequisites
+- **Node.js** >= 20.0.0
+- **LWC components** in a project directory (standard SFDX project or custom layout)
+- **Salesforce CLI** (`sf`) — only needed if connecting to a real org (Tier 2)
+---
+## Overview
+The plugin supports two tiers of usage:
+| Tier                            | What You Get                               | Org Required?      |
+| ------------------------------- | ------------------------------------------ | ------------------ |
+| **Tier 1: Off-Platform Build**  | Static bundle with mock data, labels, i18n | No                 |
+| **Tier 2: Live Org Connection** | Real GraphQL queries, live Salesforce data | Yes (via `sf` CLI) |
+Start with Tier 1. Add Tier 2 later if your components use `lightning/graphql` or
+need live data.
+---
+## Tier 1: Off-Platform Build
+### Project Structure
+You need to add **3 files** to your project and update `package.json`:
+```
+my-lwc-project/
+├── force-app/main/default/lwc/    ← your existing LWC components
+│   ├── myApp/
+│   │   ├── myApp.js
+│   │   ├── myApp.html
+│   │   └── myApp.js-meta.xml
+│   └── myComponent/
+│       ├── myComponent.js
+│       ├── myComponent.html
+│       └── myComponent.js-meta.xml
+├── bootstrap.js                    ← NEW: mounts your root component
+├── index.html                      ← NEW: entry point
+├── vite.config.js                  ← NEW: plugin configuration
+└── package.json                    ← UPDATED: add deps and scripts
+```
+### Step 1: Install Dependencies
+**Option A — Quick install command:**
+```bash
+npm install @salesforce/vite-plugin-lwc-ui-bundle @lwc/rollup-plugin vite vite-plugin-singlefile --save-dev
+npm install lwc @salesforce-ux/design-system lightning-base-components
+```
+**Option B — Add to `package.json` manually, then `npm install`:**
+```json
+{
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@salesforce-ux/design-system": "^2.29.1",
+    "lightning-base-components": "^1.28.17-alpha",
+    "lwc": "^9.0.0"
+  },
+  "devDependencies": {
+    "@lwc/rollup-plugin": "^9.0.0",
+    "@salesforce/vite-plugin-lwc-ui-bundle": "^1.0.0",
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+    "vite-plugin-singlefile": "^2.3.0"
+  }
+}
+```
+> **Important:** Add `"type": "module"` to your `package.json` if it is not already
+> present. This is required for Vite's ESM-based config.
+> **Note:** `@lwc/rollup-plugin` is a required peer dependency of the plugin.
+> `lightning-base-components` is only needed if your components use `lightning/*`
+> base components (e.g., `lightning-card`, `lightning-button`).
+### Step 2: Create `vite.config.js`
+```js
+import { defineConfig } from "vite";
+import lwcVitePlugin, { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
+import { viteSingleFile } from "vite-plugin-singlefile";
+export default defineConfig({
+  build: {
+    target: "esnext",
+    minify: false,
+  },
+  plugins: [
+    lwcVitePlugin({
+      modules: {
+        // Flat SFDX structure: specify { path, namespace }
+        dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }],
+        // Include if your components use lightning/* base components
+        npm: ["lightning-base-components"],
+      },
+      providers: [
+        builtins.label(),
+        builtins.i18n(),
+        builtins.client(),
+        builtins.gate(),
+        builtins.accessCheck(),
+      ],
+    }),
+    viteSingleFile(),
+  ],
+});
+```
+#### Component Directory Configuration
+The plugin supports two directory structures:
+**Flat SFDX structure** (standard Salesforce DX — most common):
+```
+force-app/main/default/lwc/
+  myApp/
+    myApp.js
+```
+Use `{ path, namespace }` to assign a namespace:
+```js
+dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }];
+```
+Components are importable as `c/myApp` and rendered as `<c-my-app>`.
+**Namespaced structure** (off-core projects):
+```
+src/lwc/
+  myNamespace/
+    myComponent/
+      myComponent.js
+```
+Omit `namespace` — the sub-directory name becomes the namespace:
+```js
+dirs: ["src/lwc"];
+```
+Components are importable as `myNamespace/myComponent`.
+#### Configuring Labels
+The `builtins.label()` provider handles `@salesforce/label/*` imports. How you
+configure it depends on your project:
+**SFDX project with `CustomLabels.labels-meta.xml`:**
+Copy label values from your XML into the label provider config:
+```js
+builtins.label({
+    "c.appTitle": "My LWC App",
+    "c.saveButton": "Save",
+    "c.cancelButton": "Cancel",
+}),
+```
+**Off-core project (no labels XML):**
+Pass label key-value pairs directly. If no override is provided for a key, the
+plugin returns a human-readable fallback derived from the key name (e.g.,
+`c.appTitle` renders as "App Title").
+```js
+// Minimal — uses fallback display for all labels
+builtins.label(),
+// With explicit overrides
+builtins.label({
+    "c.appTitle": "My App Title",
+    "c.greeting": "Welcome!",
+}),
+```
+#### Why `gate()` and `accessCheck()` Are Needed
+Even if your components don't use `@salesforce/gate/*` or `@salesforce/accessCheck/*`
+directly, **`lightning-base-components` does internally**. Without these providers,
+you'll get runtime errors like:
+```
+Uncaught TypeError: Cannot read properties of undefined (reading 'isOpen')
+```
+Always include `builtins.gate()` and `builtins.accessCheck()` when using
+`lightning-base-components`.
+### Step 3: Create `index.html`
+```html
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>My LWC App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script>
+      globalThis.lwcRuntimeFlags = { DISABLE_SYNTHETIC_SHADOW: true };
+    </script>
+    <script type="module" src="/bootstrap.js"></script>
+  </body>
+</html>
+```
+### Step 4: Create `bootstrap.js`
+```js
+import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
+import "@lwc/synthetic-shadow";
+import { createElement } from "lwc";
+// Import your root component using its LWC specifier: <namespace>/<componentName>
+import App from "c/myApp";
+// Mount it — tag name is the kebab-case version of the specifier
+const el = createElement("c-my-app", { is: App });
+document.getElementById("app").appendChild(el);
+```
+Replace `c/myApp` and `c-my-app` with your actual root component name.
+### Step 5: Build and Test
+```bash
+# Production build — outputs dist/index.html (single-file bundle)
+npm run build
+# Open directly in browser
+open dist/index.html
+# Or use dev server with live reload
+npm run dev
+# Open http://localhost:5173
+# Or preview the production build
+npm run preview
+# Open http://localhost:4173
+```
+---
+## Tier 2: Live Org Connection (lwcProxy)
+If your components use `lightning/graphql` or need live Salesforce data, add
+`lwcProxy()` to connect to a real org during development.
+### Prerequisites
+- Salesforce CLI installed and an org connected: `sf org display`
+- Additional packages: `@salesforce/sdk-data` and `@salesforce/ui-bundle`
+### Step 1: Install Additional Dependencies
+```bash
+npm install @salesforce/sdk-data @salesforce/ui-bundle
+```
+### Step 2: Update `vite.config.js`
+Add `lwcProxy()` before `lwcVitePlugin()` and add `builtins.lightningGraphql()`
+to providers:
+```js
+import { defineConfig } from "vite";
+import lwcVitePlugin, { builtins, lwcProxy } from "@salesforce/vite-plugin-lwc-ui-bundle";
+import { viteSingleFile } from "vite-plugin-singlefile";
+export default defineConfig({
+  build: {
+    target: "esnext",
+    minify: false,
+  },
+  plugins: [
+    lwcProxy({ debug: true }),
+    // lwcProxy({ orgAlias: "my-org", debug: true }),  // explicit org
+    lwcVitePlugin({
+      modules: {
+        dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }],
+        npm: ["lightning-base-components"],
+      },
+      providers: [
+        builtins.label(),
+        builtins.i18n(),
+        builtins.client(),
+        builtins.gate(),
+        builtins.accessCheck(),
+        builtins.lightningGraphql(),
+      ],
+    }),
+    viteSingleFile(),
+  ],
+});
+```
+### Step 3: Update `bootstrap.js`
+Initialize the Data SDK before mounting your app. This requires top-level `await`
+(hence `target: "esnext"` in the vite config):
+```js
+import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
+import "@lwc/synthetic-shadow";
+import { createElement } from "lwc";
+// Initialize SDK — lwcProxy() handles /services/* in the Vite dev server
+import { createDataSDK } from "@salesforce/sdk-data";
+try {
+  globalThis.__sfdc_sdk__ = await createDataSDK({ uiBundle: { basePath: "/" } });
+} catch (_err) {
+  globalThis.__sfdc_sdk__ = {};
+}
+// Import your root component
+import App from "c/myApp";
+const el = createElement("c-my-app", { is: App });
+document.getElementById("app").appendChild(el);
+```
+### Step 4: Run Dev Server
+```bash
+npm run dev
+# Terminal shows: [lwc-proxy] Connected to https://your-org.my.salesforce.com
+# Open http://localhost:5173
+```
+Components using `@wire(graphql, ...)` will now execute real GraphQL queries
+against your connected org. The proxy intercepts `/services/*` calls inside
+the Vite dev server — no separate proxy process needed.
+> **Note:** `lwcProxy()` works with `npm run dev` only. The production build
+> (`dist/index.html`) does not include the proxy — it's a static file. For
+> production use with live data, you need a separate API proxy or MCP server.
+---
+## Common Errors
+### `Cannot read properties of undefined (reading 'isOpen')`
+Missing `gate()` provider. `lightning-base-components` use gates internally.
+Add `builtins.gate()` to your providers array.
+### `Rollup failed to resolve import "lightning/button"`
+Your component uses a Lightning Base Component. Add to `vite.config.js`:
+```js
+modules: {
+    npm: ["lightning-base-components"],
+}
+```
+### `Top-level await is not available in the configured target environment`
+Your `bootstrap.js` uses top-level `await` (required for Data SDK). Add
+`target: "esnext"` to the build config:
+```js
+build: { target: "esnext" },
+```
+### `[scoped-module-providers] Unhandled import: @salesforce/label/...`
+Expected — the plugin returns the label key as display text by default.
+To provide specific label values:
+```js
+builtins.label({ "c.Save": "Save", "c.Cancel": "Cancel" }),
+```
+### `Rollup failed to resolve import "force/someModule"`
+Core-only module not available off-platform. Add a stub:
+```js
+// stubs/someModule.js
+export const someExport = () => {};
+```
+```js
+// vite.config.js
+lwcVitePlugin({ stubs: { "force/someModule": "./stubs/someModule.js" } });
+```
+### Component renders but looks unstyled
+Add SLDS import to `bootstrap.js`:
+```js
+import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
+```
+---
+## Reference
+- **npm:** https://www.npmjs.com/package/@salesforce/vite-plugin-lwc-ui-bundle
+- **Source:** https://github.com/salesforce-experience-platform-emu/webapps/tree/main/packages/vite-plugin-lwc-ui-bundle
+- **User Guide:** https://github.com/salesforce-experience-platform-emu/webapps/blob/main/packages/vite-plugin-lwc-ui-bundle/docs/user-guide.md
+- **Example project:** https://git.soma.salesforce.com/sisi-zhang/my-lwc-app-test

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/vite-plugin-lwc-ui-bundle",
-  "version": "1.131.2",
+  "version": "1.131.3",
   "description": "Vite plugin for compiling LWC components into static bundles for off-platform and MCP use",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "Salesforce",
@@ -37,7 +37,8 @@
   "files": [
     "dist",
     "README.md",
-    "docs"
+    "docs",
+    "skills"
   ],
   "scripts": {
     "build": "vite build",
@@ -59,7 +60,7 @@
     }
   },
   "devDependencies": {
-    "@salesforce/sdk-chat": "^1.131.2",
+    "@salesforce/sdk-chat": "^1.131.3",
     "typescript": "^5.9.3",
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.5.4",

package/skills/setup-lwc-vite-plugin/SKILL.md ADDED Viewed

@@ -0,0 +1,242 @@
+---
+name: setup-lwc-vite-plugin
+description: >
+  Set up @salesforce/vite-plugin-lwc-ui-bundle in an LWC project so components
+  compile and run off-platform in a browser. Use this skill whenever someone wants
+  to: run LWC components outside Salesforce, build a static LWC bundle, add Vite
+  to an SFDX or LWC project, compile LWC for a browser, create a standalone LWC
+  app, set up an LWC dev server, or use vite-plugin-lwc-ui-bundle. Also use it
+  when the user mentions "off-platform LWC", "LWC bundle", "LWC without Salesforce",
+  "LWC without an org", "Vite + LWC", or "compile LWC off-core".
+---
+# Setup @salesforce/vite-plugin-lwc-ui-bundle
+This skill adds `@salesforce/vite-plugin-lwc-ui-bundle` to an existing LWC project,
+producing a single `dist/index.html` that runs in any browser without a Salesforce org.
+## What the plugin does
+It wraps the full LWC compilation pipeline behind a single Vite plugin: scoped module
+providers (labels, i18n, gates, etc.), Lightning npm resolution, missing CSS handling,
+and the Vite/LWC bridge. The output is a self-contained HTML file with all JS and CSS
+inlined.
+## Reference material
+The `references/consumer-guide.md` file contains exact file templates, dependency
+versions, and config snippets. Read it when you need to generate `vite.config.js`,
+`index.html`, `bootstrap.js`, or `package.json` updates. This skill tells you
+_when and why_ to use each piece; the consumer guide gives you the exact _what_.
+## Interactive Setup Flow
+Walk the user through these steps in order. Ask questions — don't assume.
+### Step 1: Detect the project
+LWC projects come in two layouts, and the directory structure determines how
+`modules.dirs` must be configured. Detecting the layout first avoids misconfigured
+imports that silently fail at build time.
+Check in order:
+1. `sfdx-project.json` in the project root → **SFDX project**. Components live at
+   `force-app/main/default/lwc/` in a flat structure where every component shares
+   the `c` namespace. Configure as `dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }]`.
+2. Directories matching `src/lwc/` or `modules/` → **off-core project**. Sub-directories
+   are namespaces (e.g., `src/lwc/myNs/myComponent/`). Configure as `dirs: ["src/lwc"]`.
+3. If neither found, ask the user where their LWC components live.
+Read `package.json` to understand what's already installed — avoid adding duplicate
+dependencies later.
+### Step 2: Ask for the root component
+The plugin compiles a tree starting from one root component that gets mounted in the
+HTML page. The user needs to tell you which one, since there's no reliable way to
+auto-detect the "main" component.
+List the discovered components and ask:
+> "Which component should be the root of your app? This is the one that gets
+> mounted in the HTML page."
+Present the component names as a numbered list for easy selection.
+### Step 3: Inspect the component tree
+This step drives every downstream decision: which providers to include, whether
+`lightning-base-components` is needed, and whether to offer Tier 2 (live org). Getting
+this right prevents cryptic build errors.
+Starting from the root component, trace the dependency tree:
+1. Read the root component's `.html` file — find all `c-*` tags (or other
+   namespace tags) to identify child components
+2. Recursively read each child component's `.js` and `.html`
+3. Collect all imports across the tree:
+   - `@salesforce/label/*` → label keys (need `builtins.label()`)
+   - `lightning/graphql` or `@wire(graphql` → needs GraphQL support
+   - `lightning/*` base components → needs `lightning-base-components` npm package,
+     plus `gate()`, `accessCheck()`, and `primitiveUtils()` providers because
+     base components use these modules internally even if user code doesn't
+   - `@salesforce/gate/*`, `@salesforce/accessCheck/*` → handled by providers
+   - `@salesforce/i18n/*` → i18n provider
+   - `@salesforce/client/*` → client provider (provides `formFactor` based on viewport width)
+   - `lightning/primitiveUtils` → primitiveUtils provider
+Report what you found:
+> "I traced your component tree from `c/app`. Here's what I found:
+>
+> - 5 components total
+> - 3 label imports: `c.appTitle`, `c.greeting`, `c.save`
+> - Uses `lightning-card` (needs lightning-base-components)
+> - Uses `lightning/graphql` (needs lwcProxy for live data)
+> - No gate/accessCheck imports in your code, but lightning-base-components
+>   uses them internally — I'll include those providers automatically."
+### Step 4: Decide the tier
+The plugin supports two tiers. This determines which dependencies and bootstrap
+code to generate.
+| Tier                            | What you get                               | Org required?      |
+| ------------------------------- | ------------------------------------------ | ------------------ |
+| **Tier 1: Off-Platform Build**  | Static bundle with mock data, labels, i18n | No                 |
+| **Tier 2: Live Org Connection** | Real GraphQL queries via `lwcProxy()`      | Yes (via `sf` CLI) |
+If GraphQL usage was detected in Step 3, ask:
+> "Your components use `lightning/graphql`. Do you want to connect to a real
+> Salesforce org for live data during development?
+>
+> A) Yes — I have an org connected via `sf` CLI (adds lwcProxy + Data SDK)
+> B) No — use mock data for now (GraphQL wire adapter returns empty results)"
+If no GraphQL detected, default to Tier 1 — there's no benefit to Tier 2 without
+GraphQL or live data needs.
+### Step 5: Resolve label values
+Labels need explicit values because the plugin can't read them from an org at build
+time. Getting them right here means the user sees realistic text immediately instead
+of placeholder keys.
+1. **SFDX project**: Check for `force-app/main/default/labels/CustomLabels.labels-meta.xml`.
+   If found, parse it and extract `<fullName>` → `<value>` pairs for the label
+   keys discovered in Step 3.
+2. **Off-core project or no labels XML**: For each label key found, use a
+   placeholder value derived from the key (e.g., `c.appTitle` → `"App Title"`).
+Tell the user what labels you found and the values you'll use:
+> "I found 3 label imports. Here are the values I'll configure:
+>
+> - `c.appTitle` → "My LWC App" (from CustomLabels.labels-meta.xml)
+> - `c.greeting` → "Welcome!" (from CustomLabels.labels-meta.xml)
+> - `c.save` → "Save" (fallback — not found in labels XML)
+>
+> You can change these in `vite.config.js` later."
+If no labels were found at all, still include `builtins.label()` with no overrides.
+The plugin returns a human-readable fallback for unknown keys, and
+`lightning-base-components` may use labels internally.
+### Step 6: Generate files
+Read `references/consumer-guide.md` for the exact file templates. Generate these
+files, adapting the templates based on what you learned in Steps 1-5:
+#### Files to create or update
+1. **`package.json`** — merge in dependencies and scripts (don't overwrite existing).
+   See "Step 1: Install Dependencies" in the consumer guide for the full dep list.
+   - Add `"type": "module"` if not present
+   - Only add `lightning-base-components` and `@salesforce-ux/design-system` if
+     the component tree uses `lightning/*` base components
+   - For Tier 2, also add `@salesforce/sdk-data` and `@salesforce/ui-bundle`
+2. **`vite.config.js`** — see "Step 2" in the consumer guide for the template.
+   Adapt based on your findings:
+   - Set `dirs` for the detected project structure (SFDX vs namespaced)
+   - Populate `builtins.label({...})` with values from Step 5
+   - Include `builtins.primitiveUtils()` if using `lightning-base-components`
+   - Include `builtins.lightningGraphql()` only if GraphQL was detected
+   - Remove `npm: ["lightning-base-components"]` if no base components used
+   - For Tier 2, add `lwcProxy()` before `lwcVitePlugin()` in the plugins array
+3. **`index.html`** — see "Step 3" in the consumer guide.
+4. **`bootstrap.js`** (project root) — see "Step 4" (Tier 1) or "Step 3" (Tier 2)
+   in the consumer guide. Replace the component name with the actual root from
+   Step 2. Remove the SLDS CSS import if `lightning-base-components` is not used.
+#### Advanced options (use only when needed)
+The plugin accepts additional options for complex projects. Only add these if the
+component tree inspection reveals a need:
+- **`stubs`**: Map bare module specifiers to stub files for core-only modules
+  not available off-platform (e.g., `{ "force/someModule": "./stubs/someModule.js" }`).
+  Needed when components import platform modules like `aura`, `logger`, or
+  `force/*` that don't exist outside Salesforce.
+- **`lwcOptions`**: Pass-through options for `@lwc/rollup-plugin` to configure
+  LWC compiler behavior (e.g., `{ enableDynamicComponents: true }`). Only needed
+  for projects using advanced LWC features like dynamic component creation.
+- **`passthroughRules`**: Let specific imports bypass the provider system. Each
+  rule has a `specifierPrefix` and `importerPattern` — when both match, the import
+  resolves normally. Useful when an npm package (like `lightning-base-components`)
+  has its own label definitions that shouldn't be intercepted by your label provider.
+- **`ignorePatterns`**: Specifier prefixes that providers should never intercept.
+  Defaults include `@salesforce/sdk-*` and `@salesforce/core`. Extend this if
+  you have imports that look like provider-handled patterns but should resolve
+  through normal Node module resolution.
+### Step 7: Install and build
+Run:
+```bash
+npm install
+npm run build
+```
+If the build succeeds, report the output file size and open it:
+```bash
+open dist/index.html
+```
+If the build fails, diagnose and fix. See the "Common Errors" section in
+`references/consumer-guide.md` for the full troubleshooting guide. The most
+frequent issues:
+- **`Cannot read properties of undefined (reading 'isOpen')`**: Missing `gate()`
+  or `accessCheck()` provider — `lightning-base-components` use gates internally.
+- **`Rollup failed to resolve import "lightning/button"`**: Missing
+  `npm: ["lightning-base-components"]` in modules config.
+- **`Unhandled import: @salesforce/label/...`**: Expected warning — the plugin
+  returns the key as display text. Add overrides to `builtins.label()` to customize.
+- **`Top-level await is not available`**: Missing `target: "esnext"` in build config.
+- **`Rollup failed to resolve import "force/someModule"`**: Core-only module. Add
+  a stub via the `stubs` option.
+- **Component renders but looks unstyled**: Missing SLDS CSS import in bootstrap.js.
+### Step 8: Test dev server (Tier 2 only)
+If lwcProxy was configured:
+```bash
+npm run dev
+```
+Confirm the terminal shows `[lwc-proxy] Connected to https://...`. Open
+`http://localhost:5173` and verify GraphQL queries return real data.
+## Reference
+- npm: https://www.npmjs.com/package/@salesforce/vite-plugin-lwc-ui-bundle
+- README: https://github.com/salesforce-experience-platform-emu/webapps/tree/main/packages/vite-plugin-lwc-ui-bundle
+- Consumer Guide: https://github.com/salesforce-experience-platform-emu/webapps/blob/main/packages/vite-plugin-lwc-ui-bundle/docs/consumer-guide.md

package/docs/user-guide.md DELETED Viewed

@@ -1,377 +0,0 @@
-# User Guide: Compiling LWC Components into a Static Bundle
-This guide walks through using `@salesforce/vite-plugin-lwc-ui-bundle` to compile
-your existing LWC components into a single self-contained `dist/index.html` —
-no server required, opens directly in a browser.
----
-## Prerequisites
-- Node.js >= 20.0.0
-- Your LWC components already exist in a Salesforce DX project
----
-## Project Structure
-The example project `my-lwc-app` uses the standard Salesforce DX flat structure:
-```
-my-lwc-app/
-├── force-app/main/default/lwc/
-│   ├── helloApp/                   ← component directly, no namespace folder
-│   │   ├── helloApp.js
-│   │   ├── helloApp.html
-│   │   └── helloApp.js-meta.xml
-│   └── helloMessage/
-│       ├── helloMessage.js
-│       ├── helloMessage.html
-│       └── helloMessage.js-meta.xml
-├── src/
-│   └── bootstrap.js                ← mounts root component
-├── index.html                      ← entry point
-├── vite.config.js                  ← plugin config
-└── package.json
-```
-Use `namespace: 'c'` in `vite.config.js` to tell the plugin to treat this flat
-structure as namespace `c` — components are then importable as `'c/helloApp'`.
----
-## Step 1: Add Files
-### `package.json`
-```json
-{
-  "name": "my-lwc-app",
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "build": "vite build",
-    "dev": "vite",
-    "preview": "vite preview"
-  },
-  "devDependencies": {
-    "@lwc/rollup-plugin": "^9.0.0",
-    "@salesforce/vite-plugin-lwc-ui-bundle": "^1.0.0",
-    "vite": "^7.0.0",
-    "vite-plugin-singlefile": "^2.3.0"
-  },
-  "dependencies": {
-    "@salesforce-ux/design-system": "^2.29.1",
-    "lightning-base-components": "^1.28.17-alpha",
-    "lwc": "^9.0.0"
-  }
-}
-```
-### `vite.config.js`
-```js
-import { defineConfig } from "vite";
-import lwcVitePlugin from "@salesforce/vite-plugin-lwc-ui-bundle";
-import { viteSingleFile } from "vite-plugin-singlefile";
-export default defineConfig({
-  build: {
-    target: "esnext", // required for top-level await in bootstrap.js
-  },
-  plugins: [
-    lwcVitePlugin({
-      modules: {
-        // Flat DX structure: specify { path, namespace } per directory
-        // Use a plain string if your dir already has namespace sub-folders
-        dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }],
-        // Include if your components use lightning/* base components
-        npm: ["lightning-base-components"],
-      },
-    }),
-    viteSingleFile(), // inlines everything into a single index.html
-  ],
-});
-```
-### `index.html`
-```html
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <title>My LWC App</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script>
-      globalThis.lwcRuntimeFlags = { DISABLE_SYNTHETIC_SHADOW: true };
-    </script>
-    <script type="module" src="/src/bootstrap.js"></script>
-  </body>
-</html>
-```
-### `src/bootstrap.js`
-```js
-import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
-import "@lwc/synthetic-shadow";
-import { createElement } from "lwc";
-// Import your root component using its LWC specifier: <namespace>/<componentName>
-import App from "c/helloApp";
-// Mount it — tag name is the kebab-case version of the specifier
-const el = createElement("c-hello-app", { is: App });
-document.getElementById("app").appendChild(el);
-```
----
-## Step 2: Install Dependencies
-```bash
-npm install
-```
----
-## Step 3: Build
-```bash
-npm run build
-```
-Output: `dist/index.html` — a single file with all JS and CSS inlined.
----
-## Step 4: Test
-**Option A — Open directly in browser:**
-```bash
-open dist/index.html
-```
-**Option B — Dev server with live reload:**
-```bash
-npm run dev
-# Open http://localhost:5173
-```
-**Option C — Preview the production build:**
-```bash
-npm run preview
-# Open http://localhost:4173
-```
----
-## Component Namespace Convention
-The plugin supports two directory structures:
-### Flat DX structure (standard Salesforce DX)
-```
-force-app/main/default/lwc/
-  helloApp/
-    helloApp.js
-```
-Use `{ path, namespace }` per directory to specify the namespace:
-```js
-modules: {
-  dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }];
-}
-```
-| Directory           | LWC Specifier      | HTML Tag          |
-| ------------------- | ------------------ | ----------------- |
-| `lwc/helloApp/`     | `'c/helloApp'`     | `c-hello-app`     |
-| `lwc/helloMessage/` | `'c/helloMessage'` | `c-hello-message` |
-### Namespaced structure
-```
-modules/
-  records/
-    accountOutputName/
-      accountOutputName.js
-```
-Omit `namespace` — the sub-directory name is used as the namespace:
-```js
-modules: {
-  dirs: ["modules"];
-}
-```
-| Directory                            | LWC Specifier                 | HTML Tag                      |
-| ------------------------------------ | ----------------------------- | ----------------------------- |
-| `modules/records/accountOutputName/` | `'records/accountOutputName'` | `records-account-output-name` |
----
-## Common Errors
-### `Rollup failed to resolve import "lightning/button"`
-Your component uses a Lightning Base Component. Add to `vite.config.js`:
-```js
-modules: {
-  npm: ["lightning-base-components"];
-}
-```
-### `[scoped-module-providers] Unhandled import: @salesforce/label/...`
-Expected — the plugin returns the label key as display text by default.
-To provide real label values:
-```js
-import { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
-lwcVitePlugin({
-  providers: [builtins.label({ "c.Save": "Save", "c.Cancel": "Cancel" })],
-});
-```
-### Component renders but looks unstyled
-Add SLDS import to `src/bootstrap.js`:
-```js
-import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
-```
-### `[scoped-module-providers] Unhandled import: @salesforce/user/Id`
-Expected warning — `@salesforce/user/*` imports return `undefined` by default.
-To provide real values (e.g. current user ID), add the user provider:
-```js
-import { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
-lwcVitePlugin({
-  providers: [
-    builtins.user({ Id: "005xx000001X8AAAA" }), // optional: override user fields
-  ],
-});
-```
-### `Top-level await is not available in the configured target environment`
-Your `bootstrap.js` uses top-level `await` (required when initialising the Data
-SDK). Add `target: 'esnext'` to the build config:
-```js
-export default defineConfig({
-  build: { target: "esnext" },
-  plugins: [...],
-});
-```
-### `Rollup failed to resolve import "force/someModule"`
-Core-only module — add a stub:
-```js
-// stubs/someModule.js
-export const someExport = () => {};
-```
-```js
-// vite.config.js
-lwcVitePlugin({ stubs: { "force/someModule": "./stubs/someModule.js" } });
-```
----
-## Connecting to a Real Salesforce Org (lwcProxy)
-By default the plugin runs fully off-platform with mock data. To connect your
-components to a real Salesforce org in local dev — enabling `lightning/graphql`
-to execute real queries — add `lwcProxy()` alongside `lwcVitePlugin()`.
-### Prerequisites
-- Salesforce CLI installed and an org connected: `sf org display`
-- Additional packages: `@salesforce/sdk-data` and `@salesforce/ui-bundle`
-```bash
-npm install @salesforce/sdk-data @salesforce/ui-bundle
-```
-### 1. Add lwcProxy to vite.config.js
-```js
-import { defineConfig } from "vite";
-import lwcVitePlugin, { lwcProxy } from "@salesforce/vite-plugin-lwc-ui-bundle";
-import { viteSingleFile } from "vite-plugin-singlefile";
-export default defineConfig({
-  build: {
-    target: "esnext", // required for top-level await in bootstrap.js
-  },
-  plugins: [
-    lwcProxy(), // auto-reads sf CLI default org credentials
-    // lwcProxy({ orgAlias: "my-org", debug: true })  // explicit org + verbose logging
-    lwcVitePlugin({
-      modules: {
-        dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }],
-      },
-    }),
-    viteSingleFile(),
-  ],
-});
-```
-### 2. Initialise the Data SDK in bootstrap.js
-The SDK must be initialised before any component that uses `lightning/graphql`
-mounts. Use a top-level `await` import to guarantee ordering:
-```js
-import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
-import "@lwc/synthetic-shadow";
-import { createElement } from "lwc";
-// Initialise the Data SDK — lwcProxy() handles /services/* on the Vite dev server
-import { createDataSDK } from "@salesforce/sdk-data";
-try {
-  globalThis.__sfdc_sdk__ = await createDataSDK({
-    uiBundle: { basePath: "/" },
-  });
-} catch (_err) {
-  globalThis.__sfdc_sdk__ = {};
-}
-import App from "c/helloApp";
-const el = createElement("c-hello-app", { is: App });
-document.getElementById("app").appendChild(el);
-```
-### 3. Run the dev server
-```bash
-npm run dev
-# Terminal shows: [lwc-proxy] Connected to https://your-org.my.salesforce.com
-# Open http://localhost:5173
-```
-Components using `lightning/graphql` will now execute real GraphQL queries
-against your org. The proxy intercepts `/services/*` calls inside the Vite dev
-server — no separate proxy process needed.
-> **Note:** The `basePath: '/'` setting works for `npm run dev` only. For
-> production builds (`dist/index.html`), a standalone proxy server is required.