@salesforce/webapps-features-experimental 1.68.0

package/dist/feature-metadata.js

@@ -0,0 +1,140 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+// Get the directory name for ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let metadataCache = null;
+/**
+ * Load the features metadata from features.json
+ */
+function loadMetadata() {
+    if (metadataCache) {
+        return metadataCache;
+    }
+    try {
+        const metadataPath = join(__dirname, "features.json");
+        const content = readFileSync(metadataPath, "utf-8");
+        metadataCache = JSON.parse(content);
+        return metadataCache;
+    }
+    catch (error) {
+        throw new Error(`Failed to load features.json: ${error}`);
+    }
+}
+/**
+ * Get all available features
+ */
+export function getAllFeatures() {
+    const metadata = loadMetadata();
+    return metadata.features;
+}
+/**
+ * Resolve a feature name to its canonical (registry) key, matching case-insensitively.
+ * Returns the canonical key or null if no match is found.
+ */
+export function resolveFeatureName(featureName) {
+    const metadata = loadMetadata();
+    // Exact match first
+    if (metadata.features[featureName]) {
+        return featureName;
+    }
+    // Case-insensitive match
+    const lower = featureName.toLowerCase();
+    for (const key of Object.keys(metadata.features)) {
+        if (key.toLowerCase() === lower) {
+            return key;
+        }
+    }
+    return null;
+}
+/**
+ * Get metadata for a specific feature (case-insensitive).
+ */
+export function getFeatureMetadata(featureName) {
+    const resolved = resolveFeatureName(featureName);
+    if (!resolved)
+        return null;
+    const metadata = loadMetadata();
+    return metadata.features[resolved] || null;
+}
+/**
+ * Suggest similar feature names for a given input.
+ * Uses prefix matching and Levenshtein distance.
+ * Returns up to `max` suggestions sorted by relevance.
+ */
+export function suggestSimilarFeatures(input, max = 3) {
+    const allFeatures = getAllFeatures();
+    const names = Object.keys(allFeatures);
+    const lower = input.toLowerCase();
+    const scored = names.map((name) => {
+        const nameLower = name.toLowerCase();
+        // Prefix match: input is a prefix of the feature name or vice versa
+        if (nameLower.startsWith(lower) || lower.startsWith(nameLower)) {
+            return { name, distance: 0 };
+        }
+        // Substring match: input appears within the feature name
+        if (nameLower.includes(lower)) {
+            return { name, distance: 1 };
+        }
+        return { name, distance: levenshtein(lower, nameLower) };
+    });
+    scored.sort((a, b) => a.distance - b.distance);
+    // Only suggest features within a reasonable edit distance
+    const maxDistance = Math.max(3, Math.floor(input.length / 2));
+    return scored
+        .filter((s) => s.distance <= maxDistance)
+        .slice(0, max)
+        .map((s) => s.name);
+}
+/**
+ * Simple Levenshtein distance between two strings.
+ */
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] =
+                a[i - 1] === b[j - 1]
+                    ? dp[i - 1][j - 1]
+                    : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+// Re-export search functionality from dedicated module
+export { searchFeatures } from "./feature-search.js";
+/**
+ * Get feature name from package name
+ */
+export function getFeatureNameFromPackage(packageName) {
+    const allFeatures = getAllFeatures();
+    for (const [featureName, feature] of Object.entries(allFeatures)) {
+        if (feature.package === packageName) {
+            return featureName;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a feature has complete schema information
+ */
+export function isFeatureReady(featureName) {
+    const feature = getFeatureMetadata(featureName);
+    if (!feature)
+        return false;
+    // Feature is ready if it doesn't have 'schema-pending' status
+    return feature.status !== "schema-pending";
+}
+//# sourceMappingURL=feature-metadata.js.map

package/dist/feature-metadata.js.map

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

package/dist/feature-search.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FeatureMetadata } from "./types.js";
+/**
+ * Search features by keyword with scoring and ranking
+ */
+export declare function searchFeatures(query: string): FeatureMetadata[];
+//# sourceMappingURL=feature-search.d.ts.map

package/dist/feature-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-search.d.ts","sourceRoot":"","sources":["../src/feature-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA4GlD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CA2B/D"}

package/dist/feature-search.js

@@ -0,0 +1,121 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getAllFeatures } from "./feature-metadata.js";
+/**
+ * Score a feature against search terms
+ * @internal
+ */
+function scoreFeature(feature, terms, originalQuery) {
+    let score = 0;
+    const matchedFields = [];
+    const matchedTerms = new Set();
+    // Prepare searchable text fields (lowercase for case-insensitive matching)
+    const nameLower = feature.name.toLowerCase();
+    const shortDescLower = feature.shortDescription.toLowerCase();
+    const longDescLower = feature.longDescription.toLowerCase();
+    const keywordsLower = feature.keywords.map((k) => k.toLowerCase());
+    const featuresLower = (feature.features || []).map((f) => f.toLowerCase());
+    const componentsLower = (feature.components || []).map((c) => c.toLowerCase());
+    // Check for exact feature name match (highest priority)
+    if (nameLower === originalQuery) {
+        score += 1000;
+        matchedFields.push("name (exact)");
+        terms.forEach((t) => matchedTerms.add(t));
+    }
+    // Check each search term
+    for (const term of terms) {
+        // Name match (partial)
+        if (nameLower.includes(term)) {
+            score += 500;
+            matchedFields.push(`name: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Exact keyword match
+        if (keywordsLower.some((kw) => kw === term)) {
+            score += 400;
+            matchedFields.push(`keyword: "${term}"`);
+            matchedTerms.add(term);
+        }
+        else if (keywordsLower.some((kw) => kw.includes(term))) {
+            // Partial keyword match (less weight)
+            score += 300;
+            matchedFields.push(`keyword partial: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Short description match
+        if (shortDescLower.includes(term)) {
+            score += 300;
+            matchedFields.push(`short description: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Components match
+        const matchingComponent = componentsLower.find((c) => c.includes(term));
+        if (matchingComponent) {
+            score += 250;
+            matchedFields.push(`component: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Features/capabilities match
+        const matchingFeature = featuresLower.find((f) => f.includes(term));
+        if (matchingFeature) {
+            score += 200;
+            matchedFields.push(`feature: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Long description match
+        if (longDescLower.includes(term)) {
+            score += 100;
+            matchedFields.push(`long description: "${term}"`);
+            matchedTerms.add(term);
+        }
+    }
+    // Bonus: Term coverage (rewards matching more search terms)
+    score += matchedTerms.size * 100;
+    // Bonus: Phrase match (all terms appear consecutively as a phrase)
+    const allText = [
+        nameLower,
+        shortDescLower,
+        longDescLower,
+        ...keywordsLower,
+        ...featuresLower,
+        ...componentsLower,
+    ].join(" ");
+    if (allText.includes(originalQuery)) {
+        score += 200;
+        matchedFields.push("phrase match");
+    }
+    // Bonus: Ready status (only apply if feature actually matched some terms)
+    if (matchedTerms.size > 0 && feature.status !== "schema-pending") {
+        score += 50;
+    }
+    return { score, matchedFields };
+}
+/**
+ * Search features by keyword with scoring and ranking
+ */
+export function searchFeatures(query) {
+    const allFeatures = getAllFeatures();
+    // Parse query into search terms (split on whitespace)
+    const terms = query.toLowerCase().trim().split(/\s+/);
+    const originalQuery = query.toLowerCase().trim();
+    // Score each feature
+    const scoredResults = [];
+    for (const feature of Object.values(allFeatures)) {
+        const result = scoreFeature(feature, terms, originalQuery);
+        // Only include features that have at least one match (score > 0)
+        if (result.score > 0) {
+            scoredResults.push({
+                feature,
+                score: result.score,
+            });
+        }
+    }
+    // Sort by score descending (highest score first)
+    scoredResults.sort((a, b) => b.score - a.score);
+    // Return just the features (maintains backwards compatibility)
+    return scoredResults.map((r) => r.feature);
+}
+//# sourceMappingURL=feature-search.js.map

package/dist/feature-search.js.map

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

package/dist/features.json

@@ -0,0 +1,336 @@
+{
+  "features": {
+    "authentication": {
+      "name": "Authentication",
+      "package": "@salesforce/webapp-template-feature-react-authentication-experimental",
+      "shortDescription": "Complete user authentication system with login, registration, and password management",
+      "longDescription": "Complete user authentication system with login, registration, and password reset flows. Includes protected route guards, session management, and authentication context providers. Handles user state across the application with secure token storage and automatic session refresh. Features include: AuthContext for managing auth state, PrivateRoute component for protecting authenticated-only pages, authentication pages (Login, Register, Profile, Forgot Password, Reset Password, Change Password), and backend Apex classes for authentication handling.",
+      "keywords": [
+        "login",
+        "register",
+        "password reset",
+        "protected routes",
+        "auth",
+        "session",
+        "user management"
+      ],
+      "featureDependencies": ["shadcn"],
+      "packageDependencies": {
+        "@salesforce/sdk-data": "^1.56.1",
+        "@salesforce/webapp-experimental": "^1.56.1",
+        "@tanstack/react-form": "^1.28.3",
+        "zod": "^4.3.6"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/classes",
+          "to": "<sfdxRoot>/classes",
+          "description": "Apex authentication handler classes"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-authentication/src/auth",
+          "to": "<webappDir>/src/auth",
+          "description": "Authentication components, context, and pages"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-authentication/src/routes.tsx",
+          "to": "<webappDir>/src/__example__auth-routes.tsx",
+          "description": "Example showing how to add authentication routes",
+          "integrationTarget": "src/routes.tsx"
+        }
+      ],
+      "features": [
+        "Checks authentication status via Salesforce Chatter API (/chatter/users/me)",
+        "Protects routes with automatic redirect to login",
+        "Supports return URL (retUrl) query parameter for post-login navigation",
+        "Session timeout with configurable duration",
+        "Password strength validation",
+        "Forgot password and reset password flows",
+        "User profile display",
+        "Change password functionality"
+      ],
+      "components": [
+        "AuthContext - React context for managing authentication state",
+        "PrivateRoute - Route protection for authenticated-only pages",
+        "AuthenticationRoute - Route layout that redirects authenticated users",
+        "Login - Login page component",
+        "Register - Registration page component",
+        "Profile - User profile page",
+        "ForgotPassword - Password recovery flow",
+        "ResetPassword - Password reset page",
+        "ChangePassword - Password change page"
+      ]
+    },
+    "shadcn": {
+      "name": "Shared UI (shadcn)",
+      "package": "@salesforce/webapp-template-feature-react-shadcn-experimental",
+      "shortDescription": "Comprehensive UI component library based on shadcn/ui design system",
+      "longDescription": "Comprehensive UI component library based on shadcn/ui design system. Includes commonly-used components like Button, Card, Input, Select, Table, Tabs, Dialog, and many more. Components are accessible, customizable, and follow modern React patterns. Provides a consistent design language across your application with built-in dark mode support and theming capabilities. All components use Tailwind CSS for styling and are built with accessibility in mind following ARIA guidelines.",
+      "keywords": [
+        "shadcn",
+        "UI components",
+        "Button",
+        "Card",
+        "Input",
+        "Select",
+        "Table",
+        "Tabs",
+        "design system"
+      ],
+      "packageDependencies": {
+        "class-variance-authority": "^0.7.1",
+        "clsx": "^2.1.1",
+        "lucide-react": "^0.562.0",
+        "radix-ui": "^1.4.3",
+        "shadcn": "^3.8.5",
+        "tailwind-merge": "^3.5.0",
+        "tw-animate-css": "^1.4.0"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/webapplications/feature-react-shadcn/src/components/ui",
+          "to": "<webappDir>/src/components/ui",
+          "description": "shadcn-ui component library"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-shadcn/src/lib",
+          "to": "<webappDir>/src/lib",
+          "description": "Utility functions (cn, etc.)"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-shadcn/src/styles/global.css",
+          "to": "<webappDir>/src/styles/__example__shadcn-global.css",
+          "description": "Example showing design tokens and theming styles to add",
+          "integrationTarget": "src/styles/global.css"
+        }
+      ],
+      "features": [
+        "Accessible Components - All components follow ARIA guidelines",
+        "TypeScript - Fully typed with comprehensive type definitions",
+        "Tailwind CSS - Styled with utility classes",
+        "Customizable - Easy to customize with className props",
+        "Dark Mode - Built-in support for dark mode theming",
+        "Responsive - Components adapt to different screen sizes"
+      ],
+      "components": [
+        "Alert - Alert, AlertTitle, AlertDescription",
+        "Button - Button component with variants",
+        "Card - Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent",
+        "Field - Field, FieldLabel, FieldDescription, FieldError, FieldGroup",
+        "Input - Text input component",
+        "Label - Form label component (Radix UI based)",
+        "Pagination - Complete pagination component set",
+        "Select - Select dropdown with Radix UI",
+        "Skeleton - Loading skeleton for placeholder content",
+        "Spinner - Loading spinner component",
+        "Table - Complete table component set",
+        "Tabs - Tabbed interface components"
+      ]
+    },
+    "global-search": {
+      "name": "Global Search",
+      "package": "@salesforce/webapp-template-feature-react-global-search-experimental",
+      "shortDescription": "Powerful global search for querying Salesforce objects with filters and pagination",
+      "longDescription": "Global search feature for querying Salesforce objects using GraphQL-powered record list queries with cursor-based pagination. Includes a search input component with keyword search and browse-all modes, a filterable and sortable results page, and a record detail page with layout-driven field display. Supports formatted field rendering (address, email, phone, URL), configurable page sizes, object metadata introspection, and filter criteria with picklist values. Components are accessible with ARIA attributes and screen reader support.",
+      "keywords": [
+        "search",
+        "Salesforce objects",
+        "filters",
+        "pagination",
+        "GraphQL",
+        "keyword search",
+        "record detail",
+        "object info"
+      ],
+      "featureDependencies": ["shadcn"],
+      "packageDependencies": {
+        "@salesforce/webapp-experimental": "^1.56.1",
+        "@tanstack/react-form": "^1.28.3",
+        "zod": "^4.3.6"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/api",
+          "to": "<webappDir>/src/api",
+          "description": "API services for object info, record detail, and GraphQL record list queries"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/alerts",
+          "to": "<webappDir>/src/components/alerts",
+          "description": "Status alert components"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/detail",
+          "to": "<webappDir>/src/components/detail",
+          "description": "Record detail view components with formatted field display (address, email, phone, URL)"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/filters",
+          "to": "<webappDir>/src/components/filters",
+          "description": "Filter input components for narrowing search results"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/forms",
+          "to": "<webappDir>/src/components/forms",
+          "description": "Form components for filter submission"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/layout",
+          "to": "<webappDir>/src/components/layout",
+          "description": "Card-based layout components"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/search",
+          "to": "<webappDir>/src/components/search",
+          "description": "Search results display with header, result fields, and pagination"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/shared",
+          "to": "<webappDir>/src/components/shared",
+          "description": "Shared components including GlobalSearchInput"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/FiltersPanel.tsx",
+          "to": "<webappDir>/src/components/FiltersPanel.tsx",
+          "description": "Filters panel container component"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/LoadingFallback.tsx",
+          "to": "<webappDir>/src/components/LoadingFallback.tsx",
+          "description": "Loading fallback for Suspense boundaries"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/components/SearchResultCard.tsx",
+          "to": "<webappDir>/src/components/SearchResultCard.tsx",
+          "description": "Individual search result card component"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/constants.ts",
+          "to": "<webappDir>/src/constants.ts",
+          "description": "Feature constants (object API names, page size defaults)"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/features/global-search",
+          "to": "<webappDir>/src/features/global-search",
+          "description": "Public API barrel exports for the global search feature"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/hooks",
+          "to": "<webappDir>/src/hooks",
+          "description": "React hooks for search data, object info, record list (GraphQL), and record detail layout"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/pages/GlobalSearch.tsx",
+          "to": "<webappDir>/src/pages/GlobalSearch.tsx",
+          "description": "Global search results page with filters, sorting, and cursor-based pagination"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/pages/DetailPage.tsx",
+          "to": "<webappDir>/src/pages/DetailPage.tsx",
+          "description": "Record detail page with layout-driven form display"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/types",
+          "to": "<webappDir>/src/types",
+          "description": "TypeScript type definitions for filters, object info, record detail, and search results"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/utils",
+          "to": "<webappDir>/src/utils",
+          "description": "Utility functions for API calls, caching, filtering, pagination, field extraction, and data transforms"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/pages/Home.tsx",
+          "to": "<webappDir>/src/pages/<desired-page-with-search-input>.tsx",
+          "description": "Example home page showing GlobalSearchInput integration",
+          "integrationTarget": "src/pages/Home.tsx"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-react-global-search/src/routes.tsx",
+          "to": "<webappDir>/src/__example__search-routes.tsx",
+          "description": "Example showing how to add global search and detail routes",
+          "integrationTarget": "src/routes.tsx"
+        }
+      ],
+      "features": [
+        "GraphQL-powered record list queries with cursor-based pagination",
+        "Object metadata introspection via Salesforce APIs",
+        "Record detail page with layout-driven form display",
+        "Filterable search results with picklist-based filter criteria",
+        "Sortable results with configurable page sizes",
+        "Browse all records mode (browse__all)",
+        "Formatted field value display (address, email, phone, URL, text)",
+        "GlobalSearchInput component for keyword search and browse-all navigation",
+        "Accessible components with ARIA attributes and screen reader support"
+      ],
+      "components": [
+        "GlobalSearchInput - Search input bar with search and browse-all buttons",
+        "GlobalSearch - Main search results page with filters and pagination",
+        "DetailPage - Record detail page with layout-driven fields",
+        "FiltersPanel - Filter controls for narrowing search results by field values",
+        "SearchResultsPanel - Results display with pagination and sorting controls",
+        "SearchResultCard - Individual search result card with field values",
+        "ResultCardFields - Field display within result cards",
+        "SearchHeader - Header showing search query and result context",
+        "SearchPagination - Cursor-based pagination controls",
+        "UiApiDetailForm - Detail form driven by Salesforce layout metadata",
+        "DetailHeader - Detail page header with back navigation",
+        "DetailFields - Field rendering within detail layout sections",
+        "DetailLayoutSections - Section-based layout rendering",
+        "FieldValueDisplay - Formatted field value renderer with type-specific formatting",
+        "LoadingFallback - Suspense loading fallback component",
+        "FilterField - Individual filter field component",
+        "FilterInput - Text input for filter values",
+        "FilterSelect - Dropdown select for picklist filter values"
+      ]
+    },
+    "nav-menu": {
+      "name": "Navigation Menu",
+      "package": "@salesforce/webapp-template-feature-react-nav-menu-experimental",
+      "shortDescription": "Responsive application layout with collapsible navigation menu",
+      "longDescription": "Responsive application layout with collapsible navigation menu. Provides a consistent app shell structure with sidebar navigation that adapts to mobile, tablet, and desktop viewports. Includes navigation state management, active route highlighting, and customizable menu items with icons.",
+      "keywords": ["navigation", "app layout", "sidebar", "responsive", "menu", "routing"],
+      "status": "schema-pending"
+    },
+    "charts": {
+      "name": "Analytics Charts",
+      "package": "@salesforce/webapp-template-feature-react-chart-experimental",
+      "shortDescription": "Data visualization components powered by Recharts with built-in theming",
+      "longDescription": "Data visualization components powered by Recharts with built-in theming support. Provides AnalyticsChart and ChartContainer components for rendering line charts, bar charts, and other visualizations. Includes responsive chart sizing, customizable axes, legends, tooltips, and theme-aware colors that match your application design system.",
+      "keywords": [
+        "charts",
+        "analytics",
+        "Recharts",
+        "data visualization",
+        "line chart",
+        "bar chart",
+        "theming"
+      ],
+      "status": "schema-pending"
+    },
+    "graphql": {
+      "name": "GraphQL",
+      "package": "@salesforce/webapp-template-feature-graphql-experimental",
+      "shortDescription": "Complete GraphQL integration for Salesforce data access with type safety",
+      "longDescription": "Complete GraphQL integration for Salesforce data access. Includes executeGraphQL utility functions for running queries and mutations, code generation tooling for type-safe GraphQL operations, and example components like AccountsTable demonstrating best practices. Ideal for fetching detailed object data and relationships. Note: for list search operations, REST keyword search may be more appropriate.",
+      "keywords": [
+        "GraphQL",
+        "executeGraphQL",
+        "codegen",
+        "type safety",
+        "Salesforce data",
+        "queries",
+        "mutations"
+      ],
+      "status": "schema-pending"
+    },
+    "agentforce": {
+      "name": "Agentforce Conversation",
+      "package": "@salesforce/webapp-template-feature-react-agentforce-conversation-client-experimental",
+      "shortDescription": "Embedded AI-powered conversation interface using Salesforce Agentforce",
+      "longDescription": "Embedded AI-powered conversation interface using Salesforce Agentforce. Provides a chat-like copilot or agent UI component that integrates via Lightning Out. Enables users to interact with AI assistants directly within your web application. Requires a valid Salesforce session and proper Agentforce configuration in your Salesforce org.",
+      "keywords": ["Agentforce", "conversation", "copilot", "agent", "AI", "chat", "Lightning Out"],
+      "status": "schema-pending"
+    }
+  }
+}

package/dist/file-copier.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { CopyOperation, InstallationContext } from "./types.js";
+/**
+ * Execute all copy operations
+ */
+export declare function executeCopyOperations(operations: CopyOperation[], packageName: string, context: InstallationContext): Promise<void>;
+/**
+ * Check if source path exists (for validation)
+ */
+export declare function validateSourcePath(sourcePath: string): boolean;
+//# sourceMappingURL=file-copier.d.ts.map

package/dist/file-copier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-copier.d.ts","sourceRoot":"","sources":["../src/file-copier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,UAAU,EAAE,aAAa,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAuED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D"}