@wix/agent-skills 1.16.0 → 1.16.2

package/skills/wix-app/references/auto-patterns-dashboard/app-config-structure.md

@@ -1,264 +0,0 @@
-# AppConfig Rules
-
-## Type Definitions
-```typescript
-export interface AppConfig {
-  pages: PageConfig[];
-}
-
-type PageConfig = CollectionPageConfig | EntityPageConfig;
-
-interface PageBase {
-  id: string; // Unique across app
-  appMainPage?: boolean; // ONE page must be true
-}
-
-interface CollectionPageConfig extends PageBase {
-  type: 'collectionPage';
-  collectionPage: {
-    route: { path: string };
-    title: { text: string; hideTotal?: boolean };
-    subtitle?: { text: string };
-    actions?: PageActions;
-    components: [CollectionComponent | CustomComponent]; // EXACTLY ONE component with layout
-  };
-}
-
-interface EntityPageConfig extends PageBase {
-  type: 'entityPage';
-  entityPage: {
-    mode?: 'edit' | 'view'; // Default 'edit'
-    route: { path: string; params: { id: string } };
-    title?: { text: string; badges?: { id?: string } };
-    subtitle?: { text: string; id?: string };
-    actions?: EntityPageActions;
-    parentPageId?: string; // ID of parent collection page
-    collectionId: string;
-    entityTypeSource: 'cms' | 'custom';
-    custom?: { id: string }; // REQUIRED if entityTypeSource='custom'
-    layout?: {
-      main: CardLayout[];
-      sidebar?: CardLayout[];
-    };
-  };
-}
-
-// Action Types
-interface PageActions {
-  primaryActions?: ActionGroup;
-  secondaryActions?: ActionGroup;
-}
-
-interface EntityPageActions {
-  primaryActions?: ActionGroup; // View mode only
-  secondaryActions?: ActionGroup; // View mode only
-  moreActions?: CustomAction[]; // Both modes
-}
-
-type ActionGroup = { type: 'action'; action?: { item: ActionItem } } | { type: 'menu'; menu?: { label: string; items: ActionItem[] } };
-
-interface ActionItem {
-  id: string;
-  type: 'create' | 'update' | 'delete' | 'custom' | 'bulkDelete';
-  label?: string;
-  biName: string; // MANDATORY
-  skin?: string;
-  disabled?: boolean;
-  tooltip?: string;
-  collection?: CollectionSource; // For create action
-  create?: { mode: 'page'; page: { id: string } };
-  update?: { mode: 'page'; page: { id: string } };
-  delete?: { mode: 'modal'; modal: ModalConfig };
-  bulkDelete?: { mode: 'modal'; modal: ModalConfig };
-}
-
-// Component Types
-interface CollectionComponent {
-  type: 'collection';
-  entityPageId?: string;
-  collection: CollectionSettings;
-  filters?: FilterConfig;
-  actionCell?: ActionCellConfig;
-  bulkActionToolbar?: BulkActionToolbar;
-  toolbarTitle?: ToolbarTitle;
-  views?: ViewsConfig;
-  search?: { shown?: boolean };
-  emptyState?: EmptyStateConfig;
-  dragAndDrop?: { enabled: boolean; dragAndDropCancel?: { id?: string } };
-  layout: [TableLayout, GridLayout];
-}
-
-interface CustomComponent {
-  type: 'custom';
-  id: string;
-}
-
-// Sub-Types
-interface CollectionSource {
-  collectionId: string;
-  entityTypeSource: 'cms' | 'custom';
-  custom?: { id: string };
-}
-
-interface CollectionSettings extends CollectionSource {
-  reflectQueryInUrl?: boolean;
-  selectAllScope?: 'page' | 'all';
-  selectionUpdateMode?: 'preserve' | 'clear';
-  paginationMode?: 'cursor' | 'offset';
-}
-
-interface TableLayout {
-  type: 'Table';
-  table?: {
-    columns: ColumnConfig[];
-    customColumns?: { enabled: boolean };
-    dataExtension?: { enabled: boolean };
-    stickyColumns?: number;
-    showTitleBar?: boolean;
-  };
-}
-
-interface GridLayout {
-  type: 'Grid';
-  grid?: {
-    item: {
-      titleFieldId: string;
-      subtitleFieldId?: string;
-      imageFieldId?: string;
-      cardContentMode?: 'full' | 'title' | 'empty';
-      imagePlacement?: 'top' | 'side';
-    };
-  };
-}
-```
-
-## Validation Logic
-- **IF** `entityTypeSource` is `'custom'` **THEN** `custom: { id: "..." }` is **REQUIRED**.
-- **IF** `type: 'collectionPage'` **THEN** `collectionPage` object is **REQUIRED**, `entityPage` object is **FORBIDDEN**.
-- **IF** `type: 'entityPage'` **THEN** `entityPage` object is **REQUIRED**, `collectionPage` object is **FORBIDDEN**.
-- **IF** `type: 'action'` **THEN** `action` property is **REQUIRED**.
-- **IF** `type: 'menu'` **THEN** `menu` property is **REQUIRED**.
-- **IF** action type is `'create'` **THEN** `create` config is **REQUIRED**.
-- **IF** action type is `'update'` **THEN** `update` config is **REQUIRED**.
-- **IF** action type is `'delete'` **THEN** `delete` config is **REQUIRED**.
-
-## Implementation Rules
-- **MUST** include `biName` in EVERY action configuration (format: kebab-case, `{action-purpose}-action`).
-- **MUST** designate exactly ONE page as `appMainPage: true`.
-- **MUST** use TypeScript for configuration.
-- **NEVER** fill optional fields unless explicitly requested.
-- **NEVER** mix page types in a single configuration.
-- **NEVER** set `stickyColumns` to negative, zero, or > column count.
-- **NEVER** invent enum values; ASK user for values.
-
-## page.tsx Structure
-```tsx
-import React from 'react';
-import { WixDesignSystemProvider } from '@wix/design-system';
-import '@wix/design-system/styles.global.css';
-import { WixPatternsProvider } from '@wix/patterns/provider';
-import { PatternsWizardOverridesProvider, AutoPatternsApp, type AppConfig } from '@wix/auto-patterns';
-import { withDashboard } from '@wix/patterns';
-import config from './patterns.json';
-
-const Index: React.FC = () => {
-  return (
-    <WixDesignSystemProvider features={{ newColorsBranding: true }}>
-      <WixPatternsProvider>
-        <PatternsWizardOverridesProvider value={{}}>
-          <AutoPatternsApp configuration={config as AppConfig} />
-        </PatternsWizardOverridesProvider>
-      </WixPatternsProvider>
-    </WixDesignSystemProvider>
-  );
-};
-
-export default withDashboard(Index);
-```
-
-## Canonical Example
-```typescript
-export const config: AppConfig = {
-  pages: [
-    {
-      id: "product-list",
-      type: "collectionPage",
-      appMainPage: true,
-      collectionPage: {
-        route: { path: "/" },
-        title: { text: "Products" },
-        actions: {
-          primaryActions: {
-            type: "action",
-            action: {
-              item: {
-                id: "create-product",
-                type: "create",
-                label: "Add Product",
-                biName: "create-product-action",
-                collection: {
-                  collectionId: "products",
-                  entityTypeSource: "cms"
-                },
-                create: {
-                  mode: "page",
-                  page: { id: "product-details" }
-                }
-              }
-            }
-          }
-        },
-        components: [
-          {
-            type: "collection",
-            entityPageId: "product-details",
-            collection: {
-              collectionId: "products",
-              entityTypeSource: "cms"
-            },
-            layout: [
-              {
-                type: "Table",
-                table: {
-                  columns: [
-                    { id: "name", name: "Name", width: "200px" },
-                    { id: "price", name: "Price", width: "100px" }
-                  ]
-                }
-              },
-              {
-                type: "Grid",
-                grid: {
-                  item: { titleFieldId: "name" }
-                }
-              }
-            ]
-          }
-        ]
-      }
-    },
-    {
-      id: "product-details",
-      type: "entityPage",
-      entityPage: {
-        route: { path: "/product/:id", params: { id: "id" } },
-        collectionId: "products",
-        entityTypeSource: "cms",
-        layout: {
-          main: [
-            {
-              type: "card",
-              card: {
-                title: { text: "Basic Info" },
-                children: [
-                  { type: "field", field: { fieldId: "name" } }
-                ]
-              }
-            }
-          ]
-        }
-      }
-    }
-  ]
-};
-```

package/skills/wix-app/references/auto-patterns-dashboard/app-context.md

@@ -1,37 +0,0 @@
-# AppContext Rules
-
-## Type Definitions
-```typescript
-interface AppContext {
-  items: any[];
-  refreshCollection: () => void;
-}
-```
-
-## Validation Logic
-- **IF** using `useAppContext` **THEN** component MUST be inside `AutoPatternsApp` (as children).
-
-## Implementation Rules
-- **MUST** wrap child components (modals, panels) with `<AutoPatternsApp>`.
-- **MUST** use `useAppContext` to access shared collection data/refresh.
-- **MUST** use `refreshCollection` after data mutations in external components.
-- **NEVER** use `useAppContext` outside of the `AutoPatternsApp` tree.
-
-## Canonical Example
-```typescript
-// 1. Child Component
-const MyModal = () => {
-  const { items, refreshCollection } = useAppContext();
-  return (
-    <Modal>
-      <Text>Count: {items.length}</Text>
-      <Button onClick={refreshCollection}>Refresh</Button>
-    </Modal>
-  );
-};
-
-// 2. Integration
-<AutoPatternsApp configuration={config}>
-  <MyModal />
-</AutoPatternsApp>
-```

package/skills/wix-app/references/auto-patterns-dashboard/bulk-actions.md

@@ -1,86 +0,0 @@
-# Bulk Actions Rules
-
-## Type Definitions
-```typescript
-interface BulkActionToolbar {
-  primaryActions?: BulkActionGroup[];
-  secondaryActions?: (BulkActionItem | DividerItem)[];
-}
-
-type BulkActionGroup = | { type: 'action'; action: { item: BulkActionItem } } | { type: 'menu'; menu: { label: string; items: (BulkActionItem | DividerItem)[] } };
-
-interface DividerItem {
-  type: 'divider';
-}
-
-interface BulkActionItem {
-  id: string; // Must match custom resolver name
-  type: 'bulkDelete' | 'custom';
-  label?: string;
-  biName: string; // MANDATORY
-  bulkDelete?: {
-    mode: 'modal';
-    modal: {
-      title?: { text?: string; id?: string };
-      description?: { text: string };
-      actions?: { submit?: { text: string }; cancel?: { text: string } };
-      feedback?: { successToast?: { text: string }; errorToast?: { text: string } };
-    };
-  };
-}
-
-type CustomBulkActionsActionResolver = (params: {
-  actionParams: { selectedValues: any[]; total: number };
-  sdk: AutoPatternsSDK;
-}) => ResolvedAction;
-```
-
-## Validation Logic
-- **IF** `type: 'bulkDelete'` **THEN** `bulkDelete.mode: 'modal'` is **REQUIRED**.
-- **IF** `type: 'custom'` **THEN** resolver implementation is **REQUIRED**.
-- **IF** `primaryActions` AND `secondaryActions` both undefined **THEN** toolbar invalid.
-
-## Implementation Rules
-- **MUST** include `biName` for all bulk actions (`bulk-{action}-action`).
-- **MUST** place toolbar configuration inside `table` or `grid` object.
-- **MUST** use `CustomBulkActionsActionResolver` type for custom logic.
-- **MUST** register custom resolvers in `AutoPatternsOverridesProvider`.
-- **MUST** use `errorHandler` for Wix API calls in resolvers.
-- **NEVER** use default navigation in bulk actions; implement explicitly.
-
-## Canonical Example
-```typescript
-// Config
-bulkActionToolbar: {
-  primaryActions: [{
-    type: 'action',
-    action: {
-      item: {
-        id: 'bulkDelete',
-        type: 'bulkDelete',
-        label: 'Delete',
-        biName: 'bulk-delete-action',
-        bulkDelete: { mode: 'modal', modal: {} }
-      }
-    }
-  }],
-  secondaryActions: [
-    {
-      id: 'bulkExport',
-      type: 'custom',
-      label: 'Export',
-      biName: 'bulk-export-action'
-    }
-  ]
-}
-
-// Resolver
-export const bulkExport: CustomBulkActionsActionResolver = ({ actionParams }) => ({
-  label: 'Export',
-  icon: <Download />,
-  biName: 'bulk-export-action',
-  onClick: () => {
-    // Logic using actionParams.selectedValues
-  }
-});
-```

package/skills/wix-app/references/auto-patterns-dashboard/collection-page-actions.md

@@ -1,119 +0,0 @@
-# Collection Page Action Rules
-
-## Type Definitions
-```typescript
-interface CollectionPageActions {
-  primaryActions?: ActionGroup;
-  secondaryActions?: ActionGroup;
-}
-
-type ActionGroup = | { type: 'action'; action: { item: ActionItem } } | { type: 'menu'; menu: { label: string; items: (ActionItem | DividerItem)[] } };
-
-interface DividerItem {
-  type: 'divider';
-}
-
-interface ActionItem {
-  id: string; // Must match custom resolver name if custom
-  type: 'create' | 'custom';
-  label?: string;
-  biName: string; // MANDATORY
-  collection?: {
-    collectionId: string;
-    entityTypeSource: 'cms' | 'custom';
-  };
-  create?: {
-    mode: 'page';
-    page: { id: string };
-  };
-}
-
-// Row Click Action (Table level)
-interface OnRowClickConfig {
-  id: string;
-  type: 'custom';
-}
-
-// Row Click Resolver Signature - NOTE: item is nested under actionParams
-type CustomActionCollectionPageActionOnRowClickResolver = (params: {
-  actionParams: { item: any };  // The clicked row's data - nested under actionParams
-  sdk: AutoPatternsSDK;
-}) => ResolvedAction;
-```
-
-## Validation Logic
-- **IF** `type: 'create'` **THEN** `create` config with `page.id` is **REQUIRED**.
-- **IF** `type: 'custom'` **THEN** `id` must match a registered resolver name.
-- **IF** `onRowClick` is configured **THEN** matching `custom` resolver is **MANDATORY**.
-- **IF** `onRowClick` is configured **THEN** default navigation is **DISABLED**.
-- **IF** `onRowClick` resolver accesses row data **THEN** use `actionParams.item` (NOT direct `item` param).
-
-## Implementation Rules
-- **MUST** include a `create` action in `primaryActions` for every collection page.
-- **MUST** include `biName` for every action (kebab-case).
-- **MUST** implement custom resolvers using `CustomActionCollectionPageActionResolver`.
-- **MUST** implement row click resolvers using `CustomActionCollectionPageActionOnRowClickResolver` returning `ResolvedAction`.
-- **MUST** place onRowClick resolvers in `components/actions/` folder (same as other custom actions).
-- **MUST** register onRowClick resolvers via `useActions` hook pattern (see **custom_actions_override**).
-- **NEVER** mix `create` logic with `custom` action types.
-- **NEVER** assume `schema` or `optimisticActions` exist without checking.
-
-## Canonical Example
-```typescript
-{
-  primaryActions: {
-    type: 'action',
-    action: {
-      item: {
-        id: 'create-pet',
-        type: 'create',
-        label: 'Add Pet',
-        biName: 'create-pet-action',
-        collection: { collectionId: 'pets', entityTypeSource: 'cms' },
-        create: {
-          mode: 'page',
-          page: { id: 'pet-details' }
-        }
-      }
-    }
-  },
-  secondaryActions: {
-    type: 'menu',
-    menu: {
-      label: 'More',
-      items: [
-        {
-          id: 'exportCollection',
-          type: 'custom',
-          label: 'Export',
-          biName: 'export-action',
-          collection: { collectionId: 'pets', entityTypeSource: 'cms' }
-        }
-      ]
-    }
-  }
-}
-```
-
-## Canonical Example (onRowClick)
-```typescript
-// Config
-{
-  "onRowClick": {
-    "id": "myRowClickAction",
-    "type": "custom"
-  }
-}
-
-// Resolver (if custom) - see custom_actions_override for full registration pattern
-export const myRowClickAction: CustomActionCollectionPageActionOnRowClickResolver = ({
-  actionParams: { item },  // item is nested under actionParams
-}) => ({
-  label: 'Custom Action',
-  icon: <MyIcon />,
-  biName: 'my-row-click-action',
-  onClick: () => {
-    // Custom onClick logic using item
-  }
-});
-```

package/skills/wix-app/references/auto-patterns-dashboard/collection-page.md

@@ -1,103 +0,0 @@
-# Collection Page Rules
-
-## Type Definitions
-```typescript
-interface CollectionComponent {
-  type: 'collection';
-  entityPageId: string; // REQUIRED for navigation
-  collection: {
-    collectionId: string;
-    entityTypeSource: 'cms' | 'custom';
-    custom?: { id: string };
-  };
-  layout: LayoutItem[];
-}
-
-type LayoutItem = TableLayout | GridLayout;
-
-interface TableLayout {
-  type: 'Table';
-  table: {
-    columns: ColumnConfig[];
-    customColumns?: { enabled: boolean };
-    stickyColumns?: number;
-    showTitleBar?: boolean;
-  };
-}
-
-interface ColumnConfig {
-  id: string; // Field ID
-  name: string; // Display title
-  width: string;
-  tooltipContent?: string; // Info icon text
-  sortable?: boolean;
-  hideable?: boolean;
-}
-
-interface GridLayout {
-  type: 'Grid';
-  grid: {
-    item: {
-      titleFieldId: string; // REQUIRED Field ID
-      subtitleFieldId?: string; // Field ID
-      imageFieldId?: string; // Field ID
-      cardContentMode?: 'full' | 'title' | 'empty';
-    };
-  };
-}
-```
-
-## Validation Logic
-- **IF** `components` array length != 1 **THEN** Invalid Config (Must be exactly 1).
-- **IF** `layout` contains both 'Table' and 'Grid' **THEN** View Switcher is automatically enabled.
-- **IF** `columns` count > 5 **THEN** `customColumns.enabled` = `true`.
-- **IF** `columns` count <= 5 **THEN** `customColumns.enabled` = `false` (unless explicitly requested).
-- **IF** `type` is 'Grid' **THEN** `titleFieldId` is **REQUIRED**.
-
-## Implementation Rules
-- **MUST** reference `entityPageId` to link rows/cards to the entity page.
-- **MUST** select max 3 columns initially for the table.
-- **MUST** use `tooltipContent` to explain complex column data.
-- **SHOULD** include a primary action with `type: 'update'` in Grid view to allow easy editing.
-- **NEVER** use `onRowClick` unless custom behavior (not entity page navigation) is explicitly required.
-
-## Canonical Example
-```typescript
-{
-  type: 'collectionPage',
-  // ... page props
-  components: [
-    {
-      type: 'collection',
-      entityPageId: 'pet-details', // Links to entity page
-      collection: {
-        collectionId: 'pets',
-        entityTypeSource: 'cms'
-      },
-      layout: [
-        {
-          type: 'Table',
-          table: {
-            columns: [
-              { id: 'name', name: 'Name', width: '200px', tooltipContent: 'Pet Name' },
-              { id: 'breed', name: 'Breed', width: '150px' },
-              { id: 'age', name: 'Age', width: '100px' }
-            ],
-            customColumns: { enabled: false }
-          }
-        },
-        {
-          type: 'Grid',
-          grid: {
-            item: {
-              titleFieldId: 'name',
-              subtitleFieldId: 'breed',
-              imageFieldId: 'photo'
-            }
-          }
-        }
-      ]
-    }
-  ]
-}
-```

package/skills/wix-app/references/auto-patterns-dashboard/custom-actions-override.md

@@ -1,76 +0,0 @@
-# Custom Actions Override Rules
-
-**REQUIRED**: After creating action files, you MUST update `page.tsx` to register them.
-
-## Type Definitions
-```typescript
-interface ResolvedAction {
-  label: string;
-  icon?: React.ReactElement;
-  onClick: () => void | Promise<void>;
-  disabled?: boolean;
-  hidden?: boolean;
-}
-
-// Action Resolver Signature
-type CustomActionResolver = (params: {
-  item: any;
-  selectedItems?: any[];
-}) => ResolvedAction;
-```
-
-## Configuration Schema
-```json
-{
-  "actions": [
-    {
-      "type": "custom",
-      "id": "myAction" // Matches override key
-    }
-  ]
-}
-```
-
-## Validation Logic
-- **IF** `type` is `"custom"` **THEN** `id` MUST match key in `actions` override.
-- **IF** action is async **THEN** `onClick` SHOULD return a Promise.
-- **IF** action requires selection **THEN** check `selectedItems`.
-
-## Implementation Rules
-- **MUST** be placed in `components/actions/` folder.
-- **MUST** use `.tsx` extension if the file contains JSX (icons, React elements). Use `.ts` only for pure logic files.
-- **MUST** export `useActions` hook from `components/actions/index.tsx`.
-- **MUST** return `ResolvedAction` object.
-- **MUST** handle errors (use `try/catch` or `errorHandler` for Wix APIs).
-- **APPLIES TO** all custom action types: actionCell, collectionPageActions, onRowClick, bulkActions.
-- **NEVER** place action resolvers directly in page.tsx or overrides.tsx - always use components/actions/ folder.
-
-## Canonical Example
-```tsx
-// components/actions/myAction.tsx (use .tsx when file contains JSX like icons)
-export const myAction = ({ item }) => ({
-  label: 'Approve',
-  icon: <Check />,
-  onClick: async () => {
-    await approveItem(item.id);
-  }
-});
-
-// components/actions/index.tsx
-import { myAction } from './myAction';
-export const useActions = () => ({ myAction });
-```
-
-## page.tsx Registration (REQUIRED)
-
-**CRITICAL: PRESERVE EXISTING OVERRIDES** - Do NOT remove existing overrides. ADD this new one alongside them.
-
-```tsx
-// 1. Add import (keep all existing imports)
-import { useActions } from './components/actions';
-
-// 2. Add hook call (keep all existing hook calls)
-const actions = useActions();
-
-// 3. Add actions to PatternsWizardOverridesProvider value (keep ALL existing overrides)
-```