@nextsparkjs/testing 0.1.0-beta.44 → 0.1.0-beta.46

package/dist/utils/index.js

@@ -2,15 +2,6 @@
 var isDevelopment = process.env.NODE_ENV === "development";
 var isTest = process.env.NODE_ENV === "test";
 var enableTestingAttributes = isDevelopment || isTest;
-function createTestId(component, element, action) {
-  if (!enableTestingAttributes) return void 0;
-  const parts = [component, element, action].filter(Boolean);
-  return parts.join("-");
-}
-function createCyId(domain, element) {
-  if (!enableTestingAttributes) return void 0;
-  return `${domain}-${element}`;
-}
 function createStateAttr(state) {
   return state;
 }
@@ -46,54 +37,6 @@ function createAriaLabel(template, values) {
     return String(values[key] ?? match);
   });
 }
-var testingPatterns = {
-  // Task/Todo components
-  task: {
-    card: (taskId) => createTestingProps({
-      testId: createTestId("task", "card"),
-      cyId: createCyId("task", "item"),
-      taskId
-    }),
-    checkbox: () => createTestingProps({
-      testId: createTestId("task", "checkbox"),
-      cyId: createCyId("task", "toggle")
-    }),
-    title: () => createTestingProps({
-      testId: createTestId("task", "title"),
-      cyId: createCyId("task", "title")
-    }),
-    deleteButton: () => createTestingProps({
-      testId: createTestId("task", "delete", "button"),
-      cyId: createCyId("task", "delete")
-    })
-  },
-  // Navigation components
-  nav: {
-    searchDropdown: () => createTestingProps({
-      testId: createTestId("nav", "search", "dropdown"),
-      cyId: createCyId("nav", "search")
-    }),
-    notifications: () => createTestingProps({
-      testId: createTestId("nav", "notifications", "button"),
-      cyId: createCyId("nav", "notifications")
-    }),
-    userMenu: () => createTestingProps({
-      testId: createTestId("nav", "user", "menu"),
-      cyId: createCyId("nav", "user-menu")
-    })
-  },
-  // Form components
-  form: {
-    input: (fieldName) => createTestingProps({
-      testId: createTestId("form", fieldName, "input"),
-      cyId: createCyId("form", fieldName)
-    }),
-    submitButton: () => createTestingProps({
-      testId: createTestId("form", "submit", "button"),
-      cyId: createCyId("form", "submit")
-    })
-  }
-};
 var keyboardHelpers = {
   /**
    * Handle Enter and Space key activation
@@ -135,49 +78,7 @@ var keyboardHelpers = {
     };
   }
 };
-function createEntityCyId(entitySlug, component, detail) {
-  if (!enableTestingAttributes) return void 0;
-  const parts = [entitySlug, component, detail].filter(Boolean);
-  return parts.join("-");
-}
-function createEntityTestingHelper(entitySlug) {
-  return {
-    // Generic (framework-agnostic)
-    get: (component, detail) => createEntityCyId(entitySlug, component, detail),
-    // Page
-    page: () => createEntityCyId(entitySlug, "page"),
-    formPage: () => createEntityCyId(entitySlug, "form-page"),
-    // Form
-    form: () => createEntityCyId(entitySlug, "form"),
-    formSubmit: () => createEntityCyId(entitySlug, "form-submit"),
-    formCancel: () => createEntityCyId(entitySlug, "form-cancel"),
-    // Fields
-    field: (name) => createEntityCyId(entitySlug, "field", name),
-    fieldOption: (name, value) => createEntityCyId(entitySlug, `field-${name}-option`, value),
-    fieldError: (name) => createEntityCyId(entitySlug, `field-${name}`, "error"),
-    // Sections
-    section: (name) => createEntityCyId(entitySlug, "section", name),
-    // Card
-    card: (id) => createEntityCyId(entitySlug, "card", id),
-    // List/Table
-    table: () => createEntityCyId(entitySlug, "table"),
-    row: (id) => createEntityCyId(entitySlug, "row", id),
-    createBtn: () => createEntityCyId(entitySlug, "create-btn"),
-    searchInput: () => createEntityCyId(entitySlug, "search-input"),
-    // Filters
-    filter: (field) => createEntityCyId(entitySlug, "filter", field),
-    filterTrigger: (field) => createEntityCyId(entitySlug, `filter-${field}`, "trigger"),
-    filterOption: (field, value) => createEntityCyId(entitySlug, `filter-${field}-option`, value),
-    // Actions
-    action: (action, id) => createEntityCyId(entitySlug, `action-${action}`, id),
-    actionsTrigger: (id) => createEntityCyId(entitySlug, "actions-trigger", id),
-    // Dialogs
-    confirmDelete: () => createEntityCyId(entitySlug, "confirm-delete"),
-    confirmDeleteBtn: () => createEntityCyId(entitySlug, "confirm-delete-btn"),
-    cancelDeleteBtn: () => createEntityCyId(entitySlug, "cancel-delete-btn")
-  };
-}
 
-export { createAriaLabel, createCyId, createEntityCyId, createEntityTestingHelper, createPriorityAttr, createStateAttr, createTestId, createTestingProps, keyboardHelpers, testingPatterns };
+export { createAriaLabel, createPriorityAttr, createStateAttr, createTestingProps, keyboardHelpers };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Testing Utilities\n * Helper functions for consistent testing attribute generation\n */\n\n// =============================================================================\n// TYPE DEFINITIONS (inlined to avoid external dependency)\n// =============================================================================\n\n/**\n * Test ID pattern type\n */\nexport type TestIdPattern = string\n\n/**\n * Cypress ID pattern type\n */\nexport type CypressIdPattern = string\n\n// =============================================================================\n// ENVIRONMENT DETECTION\n// =============================================================================\n\n/**\n * Environment-based testing mode\n */\nconst isDevelopment = process.env.NODE_ENV === 'development'\nconst isTest = process.env.NODE_ENV === 'test'\nconst enableTestingAttributes = isDevelopment || isTest\n\n// =============================================================================\n// BASIC TEST ID GENERATORS\n// =============================================================================\n\n/**\n * Create consistent test IDs following the pattern: [component]-[element]-[action?]\n *\n * @param component - Main component name (e.g., 'task', 'nav', 'user')\n * @param element - Element type (e.g., 'card', 'button', 'input')\n * @param action - Optional action (e.g., 'delete', 'edit', 'toggle')\n * @returns Test ID string or undefined in production\n */\nexport function createTestId(\n  component: string,\n  element: string,\n  action?: string\n): string | undefined {\n  if (!enableTestingAttributes) return undefined\n\n  const parts = [component, element, action].filter(Boolean)\n  return parts.join('-') as TestIdPattern\n}\n\n/**\n * Create Cypress-specific IDs following the pattern: [domain]-[element]\n *\n * @param domain - Application domain (e.g., 'todo', 'nav', 'user')\n * @param element - Element identifier (e.g., 'item', 'button', 'menu')\n * @returns Cypress ID string or undefined in production\n */\nexport function createCyId(domain: string, element: string): string | undefined {\n  if (!enableTestingAttributes) return undefined\n\n  return `${domain}-${element}` as CypressIdPattern\n}\n\n// =============================================================================\n// ATTRIBUTE GENERATORS\n// =============================================================================\n\n/**\n * Create state-based data attributes for conditional testing\n *\n * @param state - Current state value\n * @returns State attribute value\n */\nexport function createStateAttr(\n  state: 'active' | 'completed' | 'pending' | 'loading' | 'error'\n): string {\n  return state\n}\n\n/**\n * Create priority-based data attributes\n *\n * @param priority - Priority level\n * @returns Priority attribute value\n */\nexport function createPriorityAttr(priority: 'low' | 'medium' | 'high'): string {\n  return priority\n}\n\n/**\n * Generate testing props object for components\n *\n * @param config - Testing configuration\n * @returns Testing props object\n */\nexport function createTestingProps(config: {\n  testId?: string\n  cyId?: string\n  state?: 'active' | 'completed' | 'pending' | 'loading' | 'error'\n  priority?: 'low' | 'medium' | 'high'\n  taskId?: string\n  userId?: string\n}) {\n  const props: Record<string, string | undefined> = {}\n\n  if (config.testId) {\n    props['data-testid'] = enableTestingAttributes ? config.testId : undefined\n  }\n\n  if (config.cyId) {\n    props['data-cy'] = enableTestingAttributes ? config.cyId : undefined\n  }\n\n  if (config.state) {\n    props['data-state'] = config.state\n  }\n\n  if (config.priority) {\n    props['data-priority'] = config.priority\n  }\n\n  if (config.taskId) {\n    props['data-task-id'] = config.taskId\n  }\n\n  if (config.userId) {\n    props['data-user-id'] = config.userId\n  }\n\n  // Filter out undefined values\n  return Object.fromEntries(\n    Object.entries(props).filter((entry) => entry[1] !== undefined)\n  )\n}\n\n/**\n * Accessibility helper for dynamic aria-label generation\n *\n * @param template - Label template with placeholders\n * @param values - Values to replace placeholders\n * @returns Formatted aria-label\n */\nexport function createAriaLabel(\n  template: string,\n  values: Record<string, string | number | boolean>\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, key) => {\n    return String(values[key] ?? match)\n  })\n}\n\n// =============================================================================\n// TESTING PATTERNS\n// =============================================================================\n\n/**\n * Common testing patterns for different component types\n */\nexport const testingPatterns = {\n  // Task/Todo components\n  task: {\n    card: (taskId: string) =>\n      createTestingProps({\n        testId: createTestId('task', 'card'),\n        cyId: createCyId('task', 'item'),\n        taskId,\n      }),\n    checkbox: () =>\n      createTestingProps({\n        testId: createTestId('task', 'checkbox'),\n        cyId: createCyId('task', 'toggle'),\n      }),\n    title: () =>\n      createTestingProps({\n        testId: createTestId('task', 'title'),\n        cyId: createCyId('task', 'title'),\n      }),\n    deleteButton: () =>\n      createTestingProps({\n        testId: createTestId('task', 'delete', 'button'),\n        cyId: createCyId('task', 'delete'),\n      }),\n  },\n\n  // Navigation components\n  nav: {\n    searchDropdown: () =>\n      createTestingProps({\n        testId: createTestId('nav', 'search', 'dropdown'),\n        cyId: createCyId('nav', 'search'),\n      }),\n    notifications: () =>\n      createTestingProps({\n        testId: createTestId('nav', 'notifications', 'button'),\n        cyId: createCyId('nav', 'notifications'),\n      }),\n    userMenu: () =>\n      createTestingProps({\n        testId: createTestId('nav', 'user', 'menu'),\n        cyId: createCyId('nav', 'user-menu'),\n      }),\n  },\n\n  // Form components\n  form: {\n    input: (fieldName: string) =>\n      createTestingProps({\n        testId: createTestId('form', fieldName, 'input'),\n        cyId: createCyId('form', fieldName),\n      }),\n    submitButton: () =>\n      createTestingProps({\n        testId: createTestId('form', 'submit', 'button'),\n        cyId: createCyId('form', 'submit'),\n      }),\n  },\n}\n\n// =============================================================================\n// KEYBOARD HELPERS\n// =============================================================================\n\n/**\n * Keyboard navigation helpers\n */\nexport const keyboardHelpers = {\n  /**\n   * Handle Enter and Space key activation\n   */\n  createActivationHandler: (onActivate: () => void) => {\n    return (e: React.KeyboardEvent) => {\n      if (e.key === 'Enter' || e.key === ' ') {\n        e.preventDefault()\n        onActivate()\n      }\n    }\n  },\n\n  /**\n   * Handle Escape key for closing\n   */\n  createEscapeHandler: (onClose: () => void) => {\n    return (e: React.KeyboardEvent) => {\n      if (e.key === 'Escape') {\n        e.preventDefault()\n        onClose()\n      }\n    }\n  },\n\n  /**\n   * Handle arrow navigation in lists\n   */\n  createArrowNavigationHandler: (\n    currentIndex: number,\n    maxIndex: number,\n    onIndexChange: (index: number) => void\n  ) => {\n    return (e: React.KeyboardEvent) => {\n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault()\n          onIndexChange(currentIndex < maxIndex ? currentIndex + 1 : 0)\n          break\n        case 'ArrowUp':\n          e.preventDefault()\n          onIndexChange(currentIndex > 0 ? currentIndex - 1 : maxIndex)\n          break\n      }\n    }\n  },\n}\n\n// ============================================================================\n// ENTITY TESTING HELPERS\n// ============================================================================\n\n/**\n * Create entity-specific Cypress ID following the convention: {slug}-{component}-{detail?}\n *\n * @param entitySlug - Entity slug from config (e.g., 'squads', 'people', 'projects')\n * @param component - Component type (e.g., 'form', 'field', 'section', 'table')\n * @param detail - Optional detail (e.g., field name, section name, action)\n * @returns Cypress ID string or undefined in production\n *\n * @example\n * createEntityCyId('squads', 'form')           // 'squads-form'\n * createEntityCyId('squads', 'field', 'name')  // 'squads-field-name'\n * createEntityCyId('squads', 'form', 'submit') // 'squads-form-submit'\n */\nexport function createEntityCyId(\n  entitySlug: string,\n  component: string,\n  detail?: string\n): string | undefined {\n  if (!enableTestingAttributes) return undefined\n\n  const parts = [entitySlug, component, detail].filter(Boolean)\n  return parts.join('-')\n}\n\n/**\n * Entity testing helper interface\n */\nexport interface EntityTestingHelper {\n  /** Generic selector: {slug}-{component}-{detail?} - Use for custom/non-standard selectors */\n  get: (component: string, detail?: string) => string | undefined\n\n  // Page selectors\n  /** {slug}-page */\n  page: () => string | undefined\n  /** {slug}-form-page */\n  formPage: () => string | undefined\n\n  // Form selectors\n  /** {slug}-form */\n  form: () => string | undefined\n  /** {slug}-form-submit */\n  formSubmit: () => string | undefined\n  /** {slug}-form-cancel */\n  formCancel: () => string | undefined\n\n  // Field selectors\n  /** {slug}-field-{name} */\n  field: (name: string) => string | undefined\n  /** {slug}-field-{name}-option-{value} */\n  fieldOption: (name: string, value: string) => string | undefined\n  /** {slug}-field-{name}-error */\n  fieldError: (name: string) => string | undefined\n\n  // Section selectors\n  /** {slug}-section-{name} */\n  section: (name: string) => string | undefined\n\n  // Card selectors\n  /** {slug}-card-{id} */\n  card: (id: string) => string | undefined\n\n  // List/Table selectors\n  /** {slug}-table */\n  table: () => string | undefined\n  /** {slug}-row-{id} */\n  row: (id: string) => string | undefined\n  /** {slug}-create-btn */\n  createBtn: () => string | undefined\n  /** {slug}-search-input */\n  searchInput: () => string | undefined\n\n  // Filter selectors\n  /** {slug}-filter-{field} */\n  filter: (field: string) => string | undefined\n  /** {slug}-filter-{field}-trigger */\n  filterTrigger: (field: string) => string | undefined\n  /** {slug}-filter-{field}-option-{value} */\n  filterOption: (field: string, value: string) => string | undefined\n\n  // Action selectors\n  /** {slug}-action-{action}-{id} */\n  action: (action: string, id: string) => string | undefined\n  /** {slug}-actions-trigger-{id} */\n  actionsTrigger: (id: string) => string | undefined\n\n  // Dialog selectors\n  /** {slug}-confirm-delete */\n  confirmDelete: () => string | undefined\n  /** {slug}-confirm-delete-btn */\n  confirmDeleteBtn: () => string | undefined\n  /** {slug}-cancel-delete-btn */\n  cancelDeleteBtn: () => string | undefined\n}\n\n/**\n * Create a testing helper factory for a specific entity.\n * Uses the entity slug from config to generate consistent data-cy selectors.\n *\n * Convention: {slug}-{component}-{detail}\n *\n * @param entitySlug - Entity slug from EntityConfig (e.g., 'squads', 'people')\n * @returns EntityTestingHelper with pre-bound selector generators\n *\n * @example\n * // In your component file:\n * import { createEntityTestingHelper } from '@nextsparkjs/testing/utils'\n * import { squadsEntityConfig } from './squads.config'\n *\n * const testId = createEntityTestingHelper(squadsEntityConfig.slug)\n *\n * // Usage in JSX:\n * <div data-cy={testId.formPage()}>           // squads-form-page\n *   <form data-cy={testId.form()}>            // squads-form\n *     <div data-cy={testId.section('basic')}> // squads-section-basic\n *       <input data-cy={testId.field('name')} /> // squads-field-name\n *     </div>\n *     <button data-cy={testId.formSubmit()}>  // squads-form-submit\n *       Submit\n *     </button>\n *   </form>\n * </div>\n *\n * // Card example:\n * <Card data-cy={testId.card(squad.id)}>     // squads-card-{id}\n *\n * // Custom selector example (for non-standard selectors):\n * <div data-cy={testId.get('color-preset', color)}>  // squads-color-preset-{color}\n */\nexport function createEntityTestingHelper(entitySlug: string): EntityTestingHelper {\n  return {\n    // Generic (framework-agnostic)\n    get: (component: string, detail?: string) =>\n      createEntityCyId(entitySlug, component, detail),\n\n    // Page\n    page: () => createEntityCyId(entitySlug, 'page'),\n    formPage: () => createEntityCyId(entitySlug, 'form-page'),\n\n    // Form\n    form: () => createEntityCyId(entitySlug, 'form'),\n    formSubmit: () => createEntityCyId(entitySlug, 'form-submit'),\n    formCancel: () => createEntityCyId(entitySlug, 'form-cancel'),\n\n    // Fields\n    field: (name: string) => createEntityCyId(entitySlug, 'field', name),\n    fieldOption: (name: string, value: string) =>\n      createEntityCyId(entitySlug, `field-${name}-option`, value),\n    fieldError: (name: string) => createEntityCyId(entitySlug, `field-${name}`, 'error'),\n\n    // Sections\n    section: (name: string) => createEntityCyId(entitySlug, 'section', name),\n\n    // Card\n    card: (id: string) => createEntityCyId(entitySlug, 'card', id),\n\n    // List/Table\n    table: () => createEntityCyId(entitySlug, 'table'),\n    row: (id: string) => createEntityCyId(entitySlug, 'row', id),\n    createBtn: () => createEntityCyId(entitySlug, 'create-btn'),\n    searchInput: () => createEntityCyId(entitySlug, 'search-input'),\n\n    // Filters\n    filter: (field: string) => createEntityCyId(entitySlug, 'filter', field),\n    filterTrigger: (field: string) =>\n      createEntityCyId(entitySlug, `filter-${field}`, 'trigger'),\n    filterOption: (field: string, value: string) =>\n      createEntityCyId(entitySlug, `filter-${field}-option`, value),\n\n    // Actions\n    action: (action: string, id: string) =>\n      createEntityCyId(entitySlug, `action-${action}`, id),\n    actionsTrigger: (id: string) => createEntityCyId(entitySlug, 'actions-trigger', id),\n\n    // Dialogs\n    confirmDelete: () => createEntityCyId(entitySlug, 'confirm-delete'),\n    confirmDeleteBtn: () => createEntityCyId(entitySlug, 'confirm-delete-btn'),\n    cancelDeleteBtn: () => createEntityCyId(entitySlug, 'cancel-delete-btn'),\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Testing Utilities\n * Helper functions for consistent testing attribute generation\n *\n * NOTE: For data-cy selectors, use sel() from '@nextsparkjs/core/selectors'\n * This file contains runtime utilities for accessibility and keyboard handling.\n */\n\n// =============================================================================\n// ENVIRONMENT DETECTION\n// =============================================================================\n\n/**\n * Environment-based testing mode\n */\nconst isDevelopment = process.env.NODE_ENV === 'development'\nconst isTest = process.env.NODE_ENV === 'test'\nconst enableTestingAttributes = isDevelopment || isTest\n\n// =============================================================================\n// ATTRIBUTE GENERATORS\n// =============================================================================\n\n/**\n * Create state-based data attributes for conditional testing\n *\n * @param state - Current state value\n * @returns State attribute value\n */\nexport function createStateAttr(\n  state: 'active' | 'completed' | 'pending' | 'loading' | 'error'\n): string {\n  return state\n}\n\n/**\n * Create priority-based data attributes\n *\n * @param priority - Priority level\n * @returns Priority attribute value\n */\nexport function createPriorityAttr(priority: 'low' | 'medium' | 'high'): string {\n  return priority\n}\n\n/**\n * Generate testing props object for components\n *\n * @param config - Testing configuration\n * @returns Testing props object\n */\nexport function createTestingProps(config: {\n  testId?: string\n  cyId?: string\n  state?: 'active' | 'completed' | 'pending' | 'loading' | 'error'\n  priority?: 'low' | 'medium' | 'high'\n  taskId?: string\n  userId?: string\n}) {\n  const props: Record<string, string | undefined> = {}\n\n  if (config.testId) {\n    props['data-testid'] = enableTestingAttributes ? config.testId : undefined\n  }\n\n  if (config.cyId) {\n    props['data-cy'] = enableTestingAttributes ? config.cyId : undefined\n  }\n\n  if (config.state) {\n    props['data-state'] = config.state\n  }\n\n  if (config.priority) {\n    props['data-priority'] = config.priority\n  }\n\n  if (config.taskId) {\n    props['data-task-id'] = config.taskId\n  }\n\n  if (config.userId) {\n    props['data-user-id'] = config.userId\n  }\n\n  // Filter out undefined values\n  return Object.fromEntries(\n    Object.entries(props).filter((entry) => entry[1] !== undefined)\n  )\n}\n\n/**\n * Accessibility helper for dynamic aria-label generation\n *\n * @param template - Label template with placeholders\n * @param values - Values to replace placeholders\n * @returns Formatted aria-label\n */\nexport function createAriaLabel(\n  template: string,\n  values: Record<string, string | number | boolean>\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, key) => {\n    return String(values[key] ?? match)\n  })\n}\n\n// =============================================================================\n// KEYBOARD HELPERS\n// =============================================================================\n\n/**\n * Keyboard navigation helpers\n */\nexport const keyboardHelpers = {\n  /**\n   * Handle Enter and Space key activation\n   */\n  createActivationHandler: (onActivate: () => void) => {\n    return (e: React.KeyboardEvent) => {\n      if (e.key === 'Enter' || e.key === ' ') {\n        e.preventDefault()\n        onActivate()\n      }\n    }\n  },\n\n  /**\n   * Handle Escape key for closing\n   */\n  createEscapeHandler: (onClose: () => void) => {\n    return (e: React.KeyboardEvent) => {\n      if (e.key === 'Escape') {\n        e.preventDefault()\n        onClose()\n      }\n    }\n  },\n\n  /**\n   * Handle arrow navigation in lists\n   */\n  createArrowNavigationHandler: (\n    currentIndex: number,\n    maxIndex: number,\n    onIndexChange: (index: number) => void\n  ) => {\n    return (e: React.KeyboardEvent) => {\n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault()\n          onIndexChange(currentIndex < maxIndex ? currentIndex + 1 : 0)\n          break\n        case 'ArrowUp':\n          e.preventDefault()\n          onIndexChange(currentIndex > 0 ? currentIndex - 1 : maxIndex)\n          break\n      }\n    }\n  },\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/testing",
-  "version": "0.1.0-beta.44",
+  "version": "0.1.0-beta.46",
   "description": "Testing utilities for NextSpark applications - Selectors, POMs, and Cypress helpers",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -29,11 +29,6 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./selectors": {
-      "types": "./dist/selectors/index.d.ts",
-      "import": "./dist/selectors/index.js",
-      "default": "./dist/selectors/index.js"
-    },
     "./utils": {
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js",

package/dist/selector-factory-BivSWXbw.d.ts

@@ -1,123 +0,0 @@
-/**
- * Selector Factory
- *
- * Factory function and utilities for creating selector helpers.
- * This file contains only the logic - no selector definitions.
- *
- * Usage:
- * ```typescript
- * import { createSelectorHelpers } from './selector-factory'
- * import { CORE_SELECTORS } from './core-selectors'
- *
- * // Create helpers bound to your selectors
- * const { sel, cySelector, selDev, SELECTORS } = createSelectorHelpers(CORE_SELECTORS)
- * ```
- *
- * Themes can extend core selectors:
- * ```typescript
- * const THEME_SELECTORS = {
- *   ...CORE_SELECTORS,
- *   customFeature: { ... }
- * }
- * export const { sel, cySelector } = createSelectorHelpers(THEME_SELECTORS)
- * ```
- */
-/**
- * Placeholder replacements type
- */
-type Replacements = Record<string, string | number>;
-/**
- * Generic selector object type
- */
-type SelectorObject = Record<string, unknown>;
-/**
- * Return type for createSelectorHelpers
- */
-interface SelectorHelpers<T extends SelectorObject> {
-    /** The selectors object */
-    SELECTORS: T;
-    /** Get selector value by path */
-    sel: (path: string, replacements?: Replacements) => string;
-    /** Alias for sel */
-    s: (path: string, replacements?: Replacements) => string;
-    /** Get selector only in dev/test environments */
-    selDev: (path: string, replacements?: Replacements) => string | undefined;
-    /** Get Cypress selector string [data-cy="..."] */
-    cySelector: (path: string, replacements?: Replacements) => string;
-    /** Create entity-specific selector helpers */
-    entitySelectors: (slug: string) => EntitySelectorHelpers;
-}
-/**
- * Entity selector helpers return type
- */
-interface EntitySelectorHelpers {
-    page: () => string;
-    title: () => string;
-    table: () => string;
-    tableContainer: () => string;
-    search: () => string;
-    addButton: () => string;
-    row: (id: string) => string;
-    rowMenu: (id: string) => string;
-    rowAction: (action: string, id: string) => string;
-    cell: (field: string, id: string) => string;
-    form: () => string;
-    field: (name: string) => string;
-    submitButton: () => string;
-    header: (mode: string) => string;
-    backButton: () => string;
-    editButton: () => string;
-    deleteButton: () => string;
-    detail: () => string;
-    filter: (field: string) => string;
-    filterTrigger: (field: string) => string;
-    filterOption: (field: string, value: string) => string;
-}
-/**
- * Navigate to a value in a nested object using dot notation
- *
- * @param obj - Object to navigate
- * @param path - Dot-separated path (e.g., "dashboard.navigation.main")
- * @returns The value at the path, or undefined if not found
- */
-declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
-/**
- * Replace placeholders in a selector string
- *
- * @param selector - Selector pattern with {placeholder} syntax
- * @param replacements - Object with replacement values
- * @returns Selector with placeholders replaced
- *
- * @example
- * replacePlaceholders('{slug}-row-{id}', { slug: 'customers', id: '123' })
- * // Returns: 'customers-row-123'
- */
-declare function replacePlaceholders(selector: string, replacements?: Replacements): string;
-/**
- * Create selector helper functions bound to a specific selectors object.
- *
- * This factory allows themes to extend core selectors while using
- * the same helper functions.
- *
- * @param selectors - The selectors object to bind helpers to
- * @returns Object with sel, cySelector, selDev, and entitySelectors functions
- *
- * @example Core usage:
- * ```typescript
- * import { CORE_SELECTORS } from './core-selectors'
- * const { sel, cySelector } = createSelectorHelpers(CORE_SELECTORS)
- * ```
- *
- * @example Theme extension:
- * ```typescript
- * const THEME_SELECTORS = {
- *   ...CORE_SELECTORS,
- *   myCustomFeature: { button: 'custom-btn' }
- * }
- * const { sel, cySelector } = createSelectorHelpers(THEME_SELECTORS)
- * sel('myCustomFeature.button') // 'custom-btn'
- * ```
- */
-declare function createSelectorHelpers<T extends SelectorObject>(selectors: T): SelectorHelpers<T>;
-
-export { type EntitySelectorHelpers as E, type Replacements as R, type SelectorObject as S, type SelectorHelpers as a, createSelectorHelpers as c, getNestedValue as g, replacePlaceholders as r };