@salesforce/templates 66.7.13 → 66.9.0

package/lib/templates/uiBundles/reactbasic/package.json

@@ -18,8 +18,8 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/sdk-data": "^1.134.3",
-    "@salesforce/ui-bundle": "^1.134.3",
+    "@salesforce/platform-sdk": "^9.20.0",
+    "@salesforce/ui-bundle": "^9.20.0",
     "@tailwindcss/vite": "^4.1.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -44,7 +44,7 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/vite-plugin-ui-bundle": "^1.134.3",
+    "@salesforce/vite-plugin-ui-bundle": "^9.20.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/lib/templates/uiBundles/reactbasic/src/api/graphqlClient.ts

@@ -1,28 +1,28 @@
 /**
- * Thin GraphQL client: createDataSDK + data.graphql with centralized error handling.
- * Use with gql-tagged queries and generated operation types for type-safe calls.
+ * Thin GraphQL client: createDataSDK + sdk.graphql.query with centralized
+ * error handling. Use with gql-tagged queries and generated operation types
+ * for type-safe calls.
  */
-import { createDataSDK } from '@salesforce/sdk-data';
+import { createDataSDK } from '@salesforce/platform-sdk';
 
 export async function executeGraphQL<TData, TVariables>(
   query: string,
   variables?: TVariables
 ): Promise<TData> {
   const data = await createDataSDK();
-  // SDK types graphql() first param as string; at runtime it may accept gql DocumentNode too
-  const response = await data.graphql?.<TData, TVariables>({
-    query,
-    variables,
+  const result = await data.graphql!.query<TData, TVariables>({
+    query: query,
+    variables: variables,
   });
 
-  if (!response) {
-    throw new Error('GraphQL response is undefined');
+  if (result.errors?.length) {
+    const msg = result.errors.map(e => e.message).join('; ');
+    throw new Error(`GraphQL Error: ${msg}`);
   }
 
-  if (response?.errors?.length) {
-    const msg = response.errors.map(e => e.message).join('; ');
-    throw new Error(`GraphQL Error: ${msg}`);
+  if (result.data == null) {
+    throw new Error('GraphQL response data is null');
   }
 
-  return response.data;
+  return result.data;
 }

package/lib/templates/uiBundles/reactbasic/src/components/alerts/status-alert.tsx

@@ -1,5 +1,5 @@
 import { cva, type VariantProps } from 'class-variance-authority';
-import { AlertCircleIcon, CheckCircle2Icon } from 'lucide-react';
+import { AlertCircleIcon, CheckCircle2Icon, InfoIcon } from 'lucide-react';
 import { Alert, AlertDescription } from '../../components/ui/alert';
 import { useId } from 'react';
 
@@ -8,6 +8,7 @@ const statusAlertVariants = cva('', {
     variant: {
       error: '',
       success: '',
+      info: 'text-blue-600 *:[svg]:text-current *:data-[slot=alert-description]:text-blue-600/90',
     },
   },
   defaultVariants: {
@@ -18,11 +19,11 @@ const statusAlertVariants = cva('', {
 interface StatusAlertProps extends VariantProps<typeof statusAlertVariants> {
   children?: React.ReactNode;
   /** Alert variant type. @default "error" */
-  variant?: 'error' | 'success';
+  variant?: 'error' | 'success' | 'info';
 }
 
 /**
- * Status alert component for displaying error or success messages.
+ * Status alert component for displaying error, success, or info messages.
  * Returns null if no children are provided.
  */
 export function StatusAlert({ children, variant = 'error' }: StatusAlertProps) {
@@ -31,6 +32,12 @@ export function StatusAlert({ children, variant = 'error' }: StatusAlertProps) {
 
   const isError = variant === 'error';
 
+  const icon = {
+    error: <AlertCircleIcon aria-hidden="true" />,
+    success: <CheckCircle2Icon aria-hidden="true" />,
+    info: <InfoIcon aria-hidden="true" />,
+  }[variant];
+
   return (
     <Alert
       variant={isError ? 'destructive' : 'default'}
@@ -38,11 +45,7 @@ export function StatusAlert({ children, variant = 'error' }: StatusAlertProps) {
       aria-describedby={descriptionId}
       role={isError ? 'alert' : 'status'}
     >
-      {isError ? (
-        <AlertCircleIcon aria-hidden="true" />
-      ) : (
-        <CheckCircle2Icon aria-hidden="true" />
-      )}
+      {icon}
       <AlertDescription id={descriptionId}>{children}</AlertDescription>
     </Alert>
   );

package/lib/templates/uiBundles/reactbasic/src/components/ui/input.tsx

@@ -8,7 +8,7 @@ function Input({ className, type, ...props }: React.ComponentProps<'input'>) {
       type={type}
       data-slot="input"
       className={cn(
-        'dark:bg-input/30 border-input focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:aria-invalid:border-destructive/50 disabled:bg-input/50 dark:disabled:bg-input/80 h-8 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-colors file:h-6 file:text-sm file:font-medium focus-visible:ring-3 aria-invalid:ring-3 md:text-sm file:text-foreground placeholder:text-muted-foreground w-full min-w-0 outline-none file:inline-flex file:border-0 file:bg-transparent disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50',
+        'dark:bg-input/30 border-input focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:aria-invalid:border-destructive/50 disabled:bg-input/50 dark:disabled:bg-input/80 h-8 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-colors file:h-6 file:text-sm file:font-medium focus-visible:ring-3 aria-invalid:ring-3 md:text-sm file:text-foreground placeholder:text-muted-foreground/70 placeholder:italic w-full min-w-0 outline-none file:inline-flex file:border-0 file:bg-transparent disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50',
         className
       )}
       {...props}

package/lib/templates/uiBundles/reactbasic/src/hooks/useAsyncData.ts

@@ -0,0 +1,67 @@
+import { useEffect, useRef, useState } from 'react';
+
+interface UseAsyncDataResult<T> {
+  data: T | null;
+  loading: boolean;
+  error: string | null;
+}
+
+/**
+ * Runs an async fetcher on mount and whenever `deps` change.
+ * Returns the loading/error/data state. Does not cache — every call
+ * to the fetcher hits the source directly.
+ *
+ * A cleanup flag prevents state updates if the component unmounts
+ * or deps change before the fetch completes (avoids React warnings
+ * and stale updates from out-of-order responses).
+ */
+export function useAsyncData<T>(
+  fetcher: () => Promise<T>,
+  deps: React.DependencyList
+): UseAsyncDataResult<T> {
+  const [data, setData] = useState<T | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [generation, setGeneration] = useState(0);
+
+  const fetcherRef = useRef(fetcher);
+  useEffect(() => {
+    fetcherRef.current = fetcher;
+  });
+
+  // Detect dep changes during render to reset loading state and bump generation
+  const [prevDeps, setPrevDeps] = useState(deps);
+  if (
+    deps.length !== prevDeps.length ||
+    deps.some((d, i) => d !== prevDeps[i])
+  ) {
+    setPrevDeps(deps);
+    setGeneration(g => g + 1);
+    if (!loading) setLoading(true);
+    if (error !== null) setError(null);
+  }
+
+  useEffect(() => {
+    let cancelled = false;
+
+    fetcherRef
+      .current()
+      .then(result => {
+        if (!cancelled) setData(result);
+      })
+      .catch(err => {
+        console.error(err);
+        if (!cancelled)
+          setError(err instanceof Error ? err.message : 'An error occurred');
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [generation]);
+
+  return { data, loading, error };
+}

package/lib/templates/uiBundles/reactbasic/tsconfig.json

@@ -28,11 +28,8 @@
       "@utils/*": ["./src/utils/*"],
       "@styles/*": ["./src/styles/*"],
       "@assets/*": ["./src/assets/*"],
-      "@salesforce/sdk-core": [
-        "../../../../../../../../../../packages/sdk/sdk-core/src/index.ts"
-      ],
-      "@salesforce/sdk-data": [
-        "../../../../../../../../../../packages/sdk/sdk-data/src/index.ts"
+      "@salesforce/platform-sdk": [
+        "../../../../../../../../../../packages/sdk/platform-sdk/src/index.ts"
       ]
     }
   },
@@ -41,7 +38,8 @@
     "e2e",
     "vite-env.d.ts",
     "vitest-env.d.ts",
-    "vitest.setup.ts"
+    "vitest.setup.ts",
+    "../../../../../../../../../../packages/sdk/platform-sdk/types"
   ],
   "references": [{ "path": "./tsconfig.node.json" }]
 }

package/lib/templates/uiBundles/reactbasic/vite-env.d.ts

@@ -2,6 +2,3 @@
 
 /** Salesforce API version injected at build time by the Vite define plugin. */
 declare const __SF_API_VERSION__: string;
-
-/** Package version of @salesforce/sdk-data injected at build time by its own Vite build. */
-declare const __SDK_DATA_VERSION__: string;

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/index.ts","../src/generators/analyticsTemplateGenerator.ts","../src/generators/apexClassGenerator.ts","../src/generators/apexTriggerGenerator.ts","../src/generators/baseGenerator.ts","../src/generators/digitalExperienceSiteGenerator.ts","../src/generators/flexipageGenerator.ts","../src/generators/lightningAppGenerator.ts","../src/generators/lightningComponentGenerator.ts","../src/generators/lightningEventGenerator.ts","../src/generators/lightningInterfaceGenerator.ts","../src/generators/lightningTestGenerator.ts","../src/generators/projectGenerator.ts","../src/generators/staticResourceGenerator.ts","../src/generators/uiBundleGenerator.ts","../src/generators/visualforceComponentGenerator.ts","../src/generators/visualforcePageGenerator.ts","../src/i18n/i18n.ts","../src/i18n/index.ts","../src/i18n/localization.ts","../src/service/gitRepoUtils.ts","../src/service/templateService.ts","../src/utils/constants.ts","../src/utils/createUtil.ts","../src/utils/index.ts","../src/utils/template-placeholders.ts","../src/utils/types.ts","../src/utils/uiBundleTemplateUtils.ts"],"version":"5.9.3"}
+{"root":["../src/index.ts","../src/generators/analyticsTemplateGenerator.ts","../src/generators/apexClassGenerator.ts","../src/generators/apexTriggerGenerator.ts","../src/generators/baseGenerator.ts","../src/generators/digitalExperienceSiteGenerator.ts","../src/generators/flexipageGenerator.ts","../src/generators/lightningAppGenerator.ts","../src/generators/lightningComponentGenerator.ts","../src/generators/lightningEmbeddingGenerator.ts","../src/generators/lightningEventGenerator.ts","../src/generators/lightningInterfaceGenerator.ts","../src/generators/lightningTestGenerator.ts","../src/generators/projectGenerator.ts","../src/generators/staticResourceGenerator.ts","../src/generators/uiBundleGenerator.ts","../src/generators/visualforceComponentGenerator.ts","../src/generators/visualforcePageGenerator.ts","../src/i18n/i18n.ts","../src/i18n/index.ts","../src/i18n/localization.ts","../src/service/gitRepoUtils.ts","../src/service/templateService.ts","../src/utils/constants.ts","../src/utils/createUtil.ts","../src/utils/index.ts","../src/utils/lightningEmbedding.ts","../src/utils/template-placeholders.ts","../src/utils/types.ts","../src/utils/uiBundleTemplateUtils.ts"],"version":"5.9.3"}

package/lib/utils/lightningEmbedding.d.ts

@@ -0,0 +1,12 @@
+/**
+ * W3C-defined iframe sandbox tokens accepted by the lightning-embedding wrapper template.
+ * Exposed so CLI plugins can derive their flag `options` list from a single source of truth.
+ */
+export declare const LIGHTNING_EMBEDDING_SANDBOX_TOKENS: readonly ["allow-forms", "allow-modals", "allow-orientation-lock", "allow-pointer-lock", "allow-popups", "allow-popups-to-escape-sandbox", "allow-presentation", "allow-same-origin", "allow-scripts", "allow-storage-access-by-user-activation", "allow-top-navigation", "allow-top-navigation-by-user-activation"];
+export type LightningEmbeddingSandboxToken = (typeof LIGHTNING_EMBEDDING_SANDBOX_TOKENS)[number];
+/**
+ * Returns true if `src` is an absolute URL acceptable as the iframe source on the
+ * lightning-embedding wrapper. https is accepted everywhere; plain http is permitted
+ * only for localhost / 127.0.0.1 to support local development servers.
+ */
+export declare function isAllowedLightningEmbeddingSrcUrl(src: string): boolean;

package/lib/utils/lightningEmbedding.js

@@ -0,0 +1,50 @@
+"use strict";
+/*
+ * Copyright (c) 2026, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIGHTNING_EMBEDDING_SANDBOX_TOKENS = void 0;
+exports.isAllowedLightningEmbeddingSrcUrl = isAllowedLightningEmbeddingSrcUrl;
+/**
+ * W3C-defined iframe sandbox tokens accepted by the lightning-embedding wrapper template.
+ * Exposed so CLI plugins can derive their flag `options` list from a single source of truth.
+ */
+exports.LIGHTNING_EMBEDDING_SANDBOX_TOKENS = [
+    'allow-forms',
+    'allow-modals',
+    'allow-orientation-lock',
+    'allow-pointer-lock',
+    'allow-popups',
+    'allow-popups-to-escape-sandbox',
+    'allow-presentation',
+    'allow-same-origin',
+    'allow-scripts',
+    'allow-storage-access-by-user-activation',
+    'allow-top-navigation',
+    'allow-top-navigation-by-user-activation',
+];
+/**
+ * Returns true if `src` is an absolute URL acceptable as the iframe source on the
+ * lightning-embedding wrapper. https is accepted everywhere; plain http is permitted
+ * only for localhost / 127.0.0.1 to support local development servers.
+ */
+function isAllowedLightningEmbeddingSrcUrl(src) {
+    let parsed;
+    try {
+        parsed = new URL(src);
+    }
+    catch (_a) {
+        return false;
+    }
+    if (parsed.protocol === 'https:') {
+        return true;
+    }
+    if (parsed.protocol === 'http:') {
+        return parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1';
+    }
+    return false;
+}
+//# sourceMappingURL=lightningEmbedding.js.map

package/lib/utils/lightningEmbedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightningEmbedding.js","sourceRoot":"","sources":["../../src/utils/lightningEmbedding.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA6BH,8EAcC;AAzCD;;;GAGG;AACU,QAAA,kCAAkC,GAAG;IAChD,aAAa;IACb,cAAc;IACd,wBAAwB;IACxB,oBAAoB;IACpB,cAAc;IACd,gCAAgC;IAChC,oBAAoB;IACpB,mBAAmB;IACnB,eAAe;IACf,yCAAyC;IACzC,sBAAsB;IACtB,yCAAyC;CACjC,CAAC;AAKX;;;;GAIG;AACH,SAAgB,iCAAiC,CAAC,GAAW;IAC3D,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/utils/types.d.ts

@@ -4,6 +4,7 @@ import ApexTriggerGenerator from '../generators/apexTriggerGenerator';
 import FlexipageGenerator from '../generators/flexipageGenerator';
 import LightningAppGenerator from '../generators/lightningAppGenerator';
 import LightningComponentGenerator from '../generators/lightningComponentGenerator';
+import LightningEmbeddingGenerator from '../generators/lightningEmbeddingGenerator';
 import LightningEventGenerator from '../generators/lightningEventGenerator';
 import LightningInterfaceGenerator from '../generators/lightningInterfaceGenerator';
 import LightningTestGenerator from '../generators/lightningTestGenerator';
@@ -26,7 +27,7 @@ export type GeneratorContext = {
     /** Absolute path to built-in templates root. Overrides __dirname-based resolution. */
     readonly templatesRootPath?: string;
 };
-export type Generators = typeof AnalyticsTemplateGenerator | typeof ApexClassGenerator | typeof ApexTriggerGenerator | typeof FlexipageGenerator | typeof LightningAppGenerator | typeof LightningComponentGenerator | typeof LightningEventGenerator | typeof LightningTestGenerator | typeof LightningInterfaceGenerator | typeof DigitalExperienceSiteGenerator | typeof ProjectGenerator | typeof StaticResourceGenerator | typeof VisualforceComponentGenerator | typeof VisualforcePageGenerator | typeof UIBundleGenerator;
+export type Generators = typeof AnalyticsTemplateGenerator | typeof ApexClassGenerator | typeof ApexTriggerGenerator | typeof FlexipageGenerator | typeof LightningAppGenerator | typeof LightningComponentGenerator | typeof LightningEventGenerator | typeof LightningTestGenerator | typeof LightningInterfaceGenerator | typeof DigitalExperienceSiteGenerator | typeof LightningEmbeddingGenerator | typeof ProjectGenerator | typeof StaticResourceGenerator | typeof VisualforceComponentGenerator | typeof VisualforcePageGenerator | typeof UIBundleGenerator;
 /**
  * Available Template types
  * Each template type must have a corresponding generator class:
@@ -45,11 +46,12 @@ export declare enum TemplateType {
     LightningInterface = 7,
     LightningTest = 8,
     DigitalExperienceSite = 9,
-    Project = 10,
-    VisualforceComponent = 11,
-    VisualforcePage = 12,
-    StaticResource = 13,
-    UIBundle = 14
+    LightningEmbedding = 10,
+    Project = 11,
+    VisualforceComponent = 12,
+    VisualforcePage = 13,
+    StaticResource = 14,
+    UIBundle = 15
 }
 export declare const generators: Map<TemplateType, GeneratorClass<any>>;
 export type CreateOutput = {
@@ -105,6 +107,13 @@ export interface LightningTestOptions extends TemplateOptions {
     testname: string;
     internal: boolean;
 }
+export interface LightningEmbeddingOptions extends TemplateOptions {
+    componentname: string;
+    src: string;
+    sandbox: string;
+    shellTitle: string;
+    internal: boolean;
+}
 export interface ProjectOptions extends TemplateOptions {
     projectname: string;
     defaultpackagedir: string;

package/lib/utils/types.js

@@ -13,6 +13,7 @@ const apexTriggerGenerator_1 = require("../generators/apexTriggerGenerator");
 const flexipageGenerator_1 = require("../generators/flexipageGenerator");
 const lightningAppGenerator_1 = require("../generators/lightningAppGenerator");
 const lightningComponentGenerator_1 = require("../generators/lightningComponentGenerator");
+const lightningEmbeddingGenerator_1 = require("../generators/lightningEmbeddingGenerator");
 const lightningEventGenerator_1 = require("../generators/lightningEventGenerator");
 const lightningInterfaceGenerator_1 = require("../generators/lightningInterfaceGenerator");
 const lightningTestGenerator_1 = require("../generators/lightningTestGenerator");
@@ -41,11 +42,12 @@ var TemplateType;
     TemplateType[TemplateType["LightningInterface"] = 7] = "LightningInterface";
     TemplateType[TemplateType["LightningTest"] = 8] = "LightningTest";
     TemplateType[TemplateType["DigitalExperienceSite"] = 9] = "DigitalExperienceSite";
-    TemplateType[TemplateType["Project"] = 10] = "Project";
-    TemplateType[TemplateType["VisualforceComponent"] = 11] = "VisualforceComponent";
-    TemplateType[TemplateType["VisualforcePage"] = 12] = "VisualforcePage";
-    TemplateType[TemplateType["StaticResource"] = 13] = "StaticResource";
-    TemplateType[TemplateType["UIBundle"] = 14] = "UIBundle";
+    TemplateType[TemplateType["LightningEmbedding"] = 10] = "LightningEmbedding";
+    TemplateType[TemplateType["Project"] = 11] = "Project";
+    TemplateType[TemplateType["VisualforceComponent"] = 12] = "VisualforceComponent";
+    TemplateType[TemplateType["VisualforcePage"] = 13] = "VisualforcePage";
+    TemplateType[TemplateType["StaticResource"] = 14] = "StaticResource";
+    TemplateType[TemplateType["UIBundle"] = 15] = "UIBundle";
 })(TemplateType || (exports.TemplateType = TemplateType = {}));
 exports.generators = new Map([
     [TemplateType.AnalyticsTemplate, analyticsTemplateGenerator_1.default],
@@ -58,6 +60,7 @@ exports.generators = new Map([
     [TemplateType.LightningInterface, lightningInterfaceGenerator_1.default],
     [TemplateType.LightningTest, lightningTestGenerator_1.default],
     [TemplateType.DigitalExperienceSite, digitalExperienceSiteGenerator_1.default],
+    [TemplateType.LightningEmbedding, lightningEmbeddingGenerator_1.default],
     [TemplateType.Project, projectGenerator_1.default],
     [TemplateType.StaticResource, staticResourceGenerator_1.default],
     [TemplateType.VisualforceComponent, visualforceComponentGenerator_1.default],

package/lib/utils/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yFAAkF;AAClF,yEAAkE;AAClE,6EAAsE;AACtE,yEAAkE;AAClE,+EAAwE;AACxE,2FAAoF;AACpF,mFAA4E;AAC5E,2FAAoF;AACpF,iFAA0E;AAC1E,iGAA0F;AAC1F,qEAA8D;AAC9D,mFAA4E;AAC5E,+FAAwF;AACxF,qFAA8E;AAC9E,uEAAgE;AAsChE;;;;;;GAMG;AACH,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,yEAAiB,CAAA;IACjB,yDAAS,CAAA;IACT,6DAAW,CAAA;IACX,yDAAS,CAAA;IACT,+DAAY,CAAA;IACZ,2EAAkB,CAAA;IAClB,mEAAc,CAAA;IACd,2EAAkB,CAAA;IAClB,iEAAa,CAAA;IACb,iFAAqB,CAAA;IACrB,sDAAO,CAAA;IACP,gFAAoB,CAAA;IACpB,sEAAe,CAAA;IACf,oEAAc,CAAA;IACd,wDAAQ,CAAA;AACV,CAAC,EAhBW,YAAY,4BAAZ,YAAY,QAgBvB;AAEY,QAAA,UAAU,GAAG,IAAI,GAAG,CAAoC;IACnE,CAAC,YAAY,CAAC,iBAAiB,EAAE,oCAA0B,CAAC;IAC5D,CAAC,YAAY,CAAC,SAAS,EAAE,4BAAkB,CAAC;IAC5C,CAAC,YAAY,CAAC,WAAW,EAAE,8BAAoB,CAAC;IAChD,CAAC,YAAY,CAAC,SAAS,EAAE,4BAAkB,CAAC;IAC5C,CAAC,YAAY,CAAC,YAAY,EAAE,+BAAqB,CAAC;IAClD,CAAC,YAAY,CAAC,kBAAkB,EAAE,qCAA2B,CAAC;IAC9D,CAAC,YAAY,CAAC,cAAc,EAAE,iCAAuB,CAAC;IACtD,CAAC,YAAY,CAAC,kBAAkB,EAAE,qCAA2B,CAAC;IAC9D,CAAC,YAAY,CAAC,aAAa,EAAE,gCAAsB,CAAC;IACpD,CAAC,YAAY,CAAC,qBAAqB,EAAE,wCAA8B,CAAC;IACpE,CAAC,YAAY,CAAC,OAAO,EAAE,0BAAgB,CAAC;IACxC,CAAC,YAAY,CAAC,cAAc,EAAE,iCAAuB,CAAC;IACtD,CAAC,YAAY,CAAC,oBAAoB,EAAE,uCAA6B,CAAC;IAClE,CAAC,YAAY,CAAC,eAAe,EAAE,kCAAwB,CAAC;IACxD,CAAC,YAAY,CAAC,QAAQ,EAAE,2BAAiB,CAAC;CAC3C,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yFAAkF;AAClF,yEAAkE;AAClE,6EAAsE;AACtE,yEAAkE;AAClE,+EAAwE;AACxE,2FAAoF;AACpF,2FAAoF;AACpF,mFAA4E;AAC5E,2FAAoF;AACpF,iFAA0E;AAC1E,iGAA0F;AAC1F,qEAA8D;AAC9D,mFAA4E;AAC5E,+FAAwF;AACxF,qFAA8E;AAC9E,uEAAgE;AAuChE;;;;;;GAMG;AACH,IAAY,YAiBX;AAjBD,WAAY,YAAY;IACtB,yEAAiB,CAAA;IACjB,yDAAS,CAAA;IACT,6DAAW,CAAA;IACX,yDAAS,CAAA;IACT,+DAAY,CAAA;IACZ,2EAAkB,CAAA;IAClB,mEAAc,CAAA;IACd,2EAAkB,CAAA;IAClB,iEAAa,CAAA;IACb,iFAAqB,CAAA;IACrB,4EAAkB,CAAA;IAClB,sDAAO,CAAA;IACP,gFAAoB,CAAA;IACpB,sEAAe,CAAA;IACf,oEAAc,CAAA;IACd,wDAAQ,CAAA;AACV,CAAC,EAjBW,YAAY,4BAAZ,YAAY,QAiBvB;AAEY,QAAA,UAAU,GAAG,IAAI,GAAG,CAAoC;IACnE,CAAC,YAAY,CAAC,iBAAiB,EAAE,oCAA0B,CAAC;IAC5D,CAAC,YAAY,CAAC,SAAS,EAAE,4BAAkB,CAAC;IAC5C,CAAC,YAAY,CAAC,WAAW,EAAE,8BAAoB,CAAC;IAChD,CAAC,YAAY,CAAC,SAAS,EAAE,4BAAkB,CAAC;IAC5C,CAAC,YAAY,CAAC,YAAY,EAAE,+BAAqB,CAAC;IAClD,CAAC,YAAY,CAAC,kBAAkB,EAAE,qCAA2B,CAAC;IAC9D,CAAC,YAAY,CAAC,cAAc,EAAE,iCAAuB,CAAC;IACtD,CAAC,YAAY,CAAC,kBAAkB,EAAE,qCAA2B,CAAC;IAC9D,CAAC,YAAY,CAAC,aAAa,EAAE,gCAAsB,CAAC;IACpD,CAAC,YAAY,CAAC,qBAAqB,EAAE,wCAA8B,CAAC;IACpE,CAAC,YAAY,CAAC,kBAAkB,EAAE,qCAA2B,CAAC;IAC9D,CAAC,YAAY,CAAC,OAAO,EAAE,0BAAgB,CAAC;IACxC,CAAC,YAAY,CAAC,cAAc,EAAE,iCAAuB,CAAC;IACtD,CAAC,YAAY,CAAC,oBAAoB,EAAE,uCAA6B,CAAC;IAClE,CAAC,YAAY,CAAC,eAAe,EAAE,kCAAwB,CAAC;IACxD,CAAC,YAAY,CAAC,QAAQ,EAAE,2BAAiB,CAAC;CAC3C,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/templates",
-  "version": "66.7.13",
+  "version": "66.9.0",
   "description": "Salesforce JS library for templates",
   "bugs": "https://github.com/forcedotcom/salesforcedx-templates/issues",
   "main": "lib/index.js",
@@ -25,10 +25,10 @@
     "@salesforce/dev-config": "^4.3.3",
     "@salesforce/dev-scripts": "^11.0.2",
     "@salesforce/prettier-config": "^0.0.4",
-    "@salesforce/ui-bundle-template-app-react-template-b2e": "^1.135.0",
-    "@salesforce/ui-bundle-template-app-react-template-b2x": "^1.135.0",
-    "@salesforce/ui-bundle-template-base-react-app": "^1.134.3",
-    "@salesforce/ui-bundle-template-base-web-app": "^1.134.3",
+    "@salesforce/ui-bundle-template-app-react-template-b2e": "^9.16.0",
+    "@salesforce/ui-bundle-template-app-react-template-b2x": "^9.16.0",
+    "@salesforce/ui-bundle-template-base-react-app": "^9.16.0",
+    "@salesforce/ui-bundle-template-base-web-app": "^9.16.0",
     "@types/chai-as-promised": "^7.1.8",
     "@types/ejs": "^3.1.5",
     "@types/mime-types": "^3.0.1",
@@ -50,7 +50,7 @@
     "eslint-plugin-jsdoc": "^46.10.1",
     "eslint-plugin-prettier": "^3.1.3",
     "husky": "^8.0.3",
-    "mocha": "^11.7.5",
+    "mocha": "^11.7.6",
     "nyc": "^15.1.0",
     "prettier": "^2.0.5",
     "pretty-quick": "^3.3.1",

package/lib/templates/project/reactexternalapp/_p_/_m_/_w_/_a_/src/_f_/_os_/hooks/useCachedAsyncData.ts

@@ -1,188 +0,0 @@
-import { useEffect, useRef, useState } from "react";
-
-interface UseAsyncDataResult<T> {
-	data: T | null;
-	loading: boolean;
-	error: string | null;
-}
-
-interface CacheOptions {
-	/** Unique cache key. Used for lookups and invalidation via `clearCacheEntry`. */
-	key: string;
-	/** Time-to-live in ms. Default: 30_000 (30s) */
-	ttl?: number;
-	/** Max entries in the cache. Default: 50. Evicts oldest entry when exceeded. */
-	maxSize?: number;
-}
-
-interface CacheEntry {
-	data: unknown;
-	timestamp: number;
-}
-
-/**
- * Module-level cache shared across all useCachedAsyncData consumers.
- * Cleared automatically on page reload since it only lives in memory.
- * Keys are caller-provided so different hook call-sites get independent entries.
- */
-const cache = new Map<string, CacheEntry>();
-
-/**
- * Returns a cached entry if it exists and hasn't exceeded its TTL.
- * Expired entries are deleted lazily here rather than on a timer,
- * so there's no background cleanup overhead.
- */
-function getValidEntry(key: string, ttl: number): CacheEntry | undefined {
-	const entry = cache.get(key);
-	if (!entry) return undefined;
-	if (Date.now() - entry.timestamp > ttl) {
-		cache.delete(key);
-		return undefined;
-	}
-	return entry;
-}
-
-/**
- * Stores a result in the cache. If the cache is at capacity and the key
- * is new, the oldest entry (first in Map insertion order — FIFO) is evicted.
- */
-function setEntry(key: string, data: unknown, maxSize: number): void {
-	if (!cache.has(key) && cache.size >= maxSize) {
-		const firstKey = cache.keys().next().value;
-		if (firstKey !== undefined) cache.delete(firstKey);
-	}
-	cache.set(key, { data, timestamp: Date.now() });
-}
-
-/**
- * Removes a single cache entry by key. The key must match the
- * `options.key` passed to `useCachedAsyncData`.
- *
- * @example
- * // Hook:
- * useCachedAsyncData(() => fetchAccountDetail(id), [id], { key: `account:${id}` });
- *
- * // Invalidate after a mutation:
- * await updateAccount(id, fields);
- * clearCacheEntry(`account:${id}`);
- */
-export function clearCacheEntry(key: string): void {
-	cache.delete(key);
-}
-
-/**
- * Removes all cache entries. Useful for global invalidation scenarios
- * like user logout or after a bulk operation.
- *
- * @example
- * async function handleLogout() {
- *   await logout();
- *   clearCache();
- *   navigate("/login");
- * }
- */
-export function clearCache(): void {
-	cache.clear();
-}
-
-/**
- * Async data hook with in-memory caching. Works like `useAsyncData` but
- * avoids redundant network calls when the same data is requested again
- * (e.g. navigating away from a page and back).
- *
- * Cache behaviour:
- * - **Key**: Provided via `options.key`. Must be unique per logical data source.
- *   Use the same key with `clearCacheEntry` to invalidate.
- * - **Hit**: Data is returned synchronously on the initial render —
- *   `loading` starts as `false`, so there's no flash of a loading state.
- * - **Miss**: The fetcher runs, and the result is stored for future hits.
- * - **TTL**: Entries expire after `options.ttl` ms (default 30 s).
- *   Expiry is checked lazily on read, not on a timer.
- * - **Max size**: Oldest entries are evicted FIFO when the cache exceeds
- *   `options.maxSize` (default 50).
- *
- * @example
- * // Cache picklist options for 5 minutes (data rarely changes)
- * const { data: types } = useCachedAsyncData(fetchDistinctTypes, [], {
- *   key: "distinctTypes",
- *   ttl: 300_000,
- * });
- *
- * // Cache search results with default 30 s TTL (back-nav returns instantly)
- * const { data } = useCachedAsyncData(
- *   () => searchAccounts({ where, orderBy, first, after }),
- *   [where, orderBy, first, after],
- *   { key: `accounts:${JSON.stringify({ where, orderBy, first, after })}` },
- * );
- *
- * // Invalidate a specific entry after a mutation
- * await updateAccount(id, fields);
- * clearCacheEntry(`account:${id}`);
- *
- * // Or clear everything (e.g. on logout)
- * clearCache();
- */
-export function useCachedAsyncData<T>(
-	fetcher: () => Promise<T>,
-	deps: React.DependencyList,
-	options: CacheOptions,
-): UseAsyncDataResult<T> {
-	const ttl = options.ttl ?? 30_000;
-	const maxSize = options.maxSize ?? 50;
-	const cacheKey = options.key;
-
-	// Synchronous cache check during state initialization so a cache hit
-	// never triggers a loading → loaded transition (avoids UI flicker).
-	const cached = getValidEntry(cacheKey, ttl);
-
-	const [data, setData] = useState<T | null>((cached?.data as T) ?? null);
-	const [loading, setLoading] = useState(!cached);
-	const [error, setError] = useState<string | null>(null);
-
-	const fetcherRef = useRef(fetcher);
-	useEffect(() => {
-		fetcherRef.current = fetcher;
-	});
-
-	useEffect(() => {
-		// Re-check the cache inside the effect because deps may have changed
-		// since the initial render (e.g. StrictMode double-invoke).
-		const entry = getValidEntry(cacheKey, ttl);
-		if (entry) {
-			setData(entry.data as T);
-			setLoading(false);
-			setError(null);
-			return;
-		}
-
-		// No cache hit — fetch from the network.
-		let cancelled = false;
-		setLoading(true);
-		setError(null);
-
-		fetcherRef
-			.current()
-			.then((result) => {
-				if (!cancelled) {
-					setEntry(cacheKey, result, maxSize);
-					setData(result);
-				}
-			})
-			.catch((err) => {
-				console.error(err);
-				if (!cancelled) setError(err instanceof Error ? err.message : "An error occurred");
-			})
-			.finally(() => {
-				if (!cancelled) setLoading(false);
-			});
-
-		// Cleanup: if deps change or the component unmounts before the fetch
-		// completes, the cancelled flag prevents stale state updates.
-		return () => {
-			cancelled = true;
-		};
-		// eslint-disable-next-line react-hooks/exhaustive-deps --- deps are explicitly managed by the caller
-	}, [...deps, cacheKey, ttl, maxSize]);
-
-	return { data, loading, error };
-}