@nextsparkjs/core 0.1.0-beta.74 → 0.1.0-beta.76

package/dist/lib/selectors/domains/superadmin.selectors.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Superadmin Selectors - 8 First-Level Components
+ *
+ * Architecture:
+ * ┌──────────────────────────────────────────────────────────────────────────────┐
+ * │  SIDEBAR (collapsible)  │           MAIN CONTENT AREA                        │
+ * │  ════════════════════   │  ══════════════════════════════════════════════    │
+ * │                         │                                                     │
+ * │  🛡️ Super Admin         │  PAGE HEADER:                                       │
+ * │  ─────────────────      │  [←] Page Title                    [🔄 Refresh]    │
+ * │                         │                                                     │
+ * │  📊 Dashboard           │  ─────────────────────────────────────────────────  │
+ * │  👥 Users               │                                                     │
+ * │  🏢 Teams               │  STATS ROW (optional):                              │
+ * │  🔐 Team Roles          │  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐       │
+ * │  📚 Documentation       │  │ Stat 1 │ │ Stat 2 │ │ Stat 3 │ │ Stat 4 │       │
+ * │  💳 Subscriptions       │  └────────┘ └────────┘ └────────┘ └────────┘       │
+ * │  📈 Analytics (soon)    │                                                     │
+ * │  ⚙️ Config (soon)       │  ─────────────────────────────────────────────────  │
+ * │                         │                                                     │
+ * │  ─────────────────      │  FILTERS ROW:                                       │
+ * │  [↩️ Back to Dashboard] │  🔍 Search...  [Filter ▼] [Filter ▼] [Clear]       │
+ * │                         │                                                     │
+ * └─────────────────────────│  ─────────────────────────────────────────────────  │
+ *                           │                                                     │
+ *                           │  TABS (optional):                                   │
+ *                           │  [Tab 1] [Tab 2]                                    │
+ *                           │                                                     │
+ *                           │  ─────────────────────────────────────────────────  │
+ *                           │                                                     │
+ *                           │  TABLE/CONTENT:                                     │
+ *                           │  ┌──────────────────────────────────────────────┐  │
+ *                           │  │ Header  │ Header  │ Header  │ Actions       │  │
+ *                           │  ├─────────┼─────────┼─────────┼───────────────┤  │
+ *                           │  │ Cell    │ Cell    │ Cell    │ [⋮] Menu      │  │
+ *                           │  │ Cell    │ Cell    │ Cell    │ [⋮] Menu      │  │
+ *                           │  └──────────────────────────────────────────────┘  │
+ *                           │                                                     │
+ *                           │  ─────────────────────────────────────────────────  │
+ *                           │                                                     │
+ *                           │  PAGINATION:                                        │
+ *                           │  Showing 1-10 of 50  │ Rows: [10▼] │ [◀][▶]       │
+ *                           │                                                     │
+ *                           │  ─────────────────────────────────────────────────  │
+ *                           │                                                     │
+ *                           │  FOOTER METADATA:                                   │
+ *                           │  Last updated: ... │ Source: ...                    │
+ *                           └─────────────────────────────────────────────────────┘
+ *
+ * Components:
+ * 1. sidebar              - Navigation sidebar (collapsible)
+ * 2. dashboard            - Dashboard overview page
+ * 3. users                - Users list page (with detail nested)
+ * 4. teams                - Teams list page (with detail nested)
+ * 5. subscriptions        - Subscriptions overview page
+ * 6. teamRoles            - RBAC Matrix and Plan Features page
+ * 7. docs                 - Admin documentation pages
+ */
+export declare const SUPERADMIN_SELECTORS: {
+    readonly container: "superadmin-container";
+    readonly sidebar: {
+        readonly container: "superadmin-sidebar";
+        readonly header: "superadmin-sidebar-header";
+        readonly collapseButton: "superadmin-sidebar-collapse";
+        readonly securityNotice: "superadmin-sidebar-security";
+        readonly nav: {
+            readonly dashboard: "superadmin-nav-dashboard";
+            readonly users: "superadmin-nav-users";
+            readonly teams: "superadmin-nav-teams";
+            readonly teamRoles: "superadmin-nav-team-roles";
+            readonly docs: "superadmin-nav-docs";
+            readonly subscriptions: "superadmin-nav-subscriptions";
+            readonly analytics: "superadmin-nav-analytics";
+            readonly config: "superadmin-nav-config";
+        };
+        readonly exitButton: "superadmin-sidebar-exit";
+    };
+    readonly dashboard: {
+        readonly container: "superadmin-dashboard";
+        readonly header: {
+            readonly title: "superadmin-dashboard-title";
+            readonly badge: "superadmin-dashboard-badge";
+        };
+        readonly quickActions: {
+            readonly container: "superadmin-quick-actions";
+            readonly users: "superadmin-quick-users";
+            readonly analytics: "superadmin-quick-analytics";
+            readonly config: "superadmin-quick-config";
+        };
+        readonly systemStatus: {
+            readonly container: "superadmin-system-status";
+            readonly online: "superadmin-status-online";
+            readonly version: "superadmin-status-version";
+            readonly security: "superadmin-status-security";
+        };
+    };
+    readonly users: {
+        readonly container: "superadmin-users";
+        readonly header: {
+            readonly backButton: "superadmin-users-back";
+            readonly title: "superadmin-users-title";
+            readonly refreshButton: "superadmin-users-refresh";
+        };
+        readonly stats: {
+            readonly totalUsers: "superadmin-users-stat-total";
+            readonly workTeams: "superadmin-users-stat-teams";
+            readonly superadmins: "superadmin-users-stat-superadmins";
+            readonly distribution: "superadmin-users-stat-distribution";
+        };
+        readonly filters: {
+            readonly search: "superadmin-users-search";
+            readonly roleFilter: "superadmin-users-filter-role";
+            readonly statusFilter: "superadmin-users-filter-status";
+            readonly clearButton: "superadmin-users-filter-clear";
+        };
+        readonly tabs: {
+            readonly container: "superadmin-users-tabs";
+            readonly regularUsers: "superadmin-users-tab-regular";
+            readonly superadmins: "superadmin-users-tab-super";
+        };
+        readonly table: {
+            readonly element: "superadmin-users-table";
+            readonly row: "superadmin-users-row-{id}";
+            readonly viewButton: "superadmin-users-view-{id}";
+            readonly editButton: "superadmin-users-edit-{id}";
+            readonly banButton: "superadmin-users-ban-{id}";
+            readonly deleteButton: "superadmin-users-delete-{id}";
+            readonly impersonateButton: "superadmin-users-impersonate-{id}";
+        };
+        readonly pagination: {
+            readonly container: "superadmin-users-pagination";
+            readonly pageSize: "superadmin-users-page-size";
+            readonly first: "superadmin-users-page-first";
+            readonly prev: "superadmin-users-page-prev";
+            readonly next: "superadmin-users-page-next";
+            readonly last: "superadmin-users-page-last";
+        };
+        readonly detail: {
+            readonly container: "superadmin-user-detail";
+            readonly info: {
+                readonly email: "superadmin-user-email";
+                readonly role: "superadmin-user-role";
+                readonly status: "superadmin-user-status";
+                readonly teams: "superadmin-user-teams";
+                readonly activity: "superadmin-user-activity";
+            };
+            readonly actions: "superadmin-user-actions";
+            readonly metas: {
+                readonly container: "superadmin-user-metas";
+                readonly title: "superadmin-user-metas-title";
+                readonly table: "superadmin-user-metas-table";
+                readonly empty: "superadmin-user-metas-empty";
+                readonly row: "superadmin-user-meta-row-{key}";
+                readonly key: "superadmin-user-meta-key-{key}";
+                readonly value: "superadmin-user-meta-value-{key}";
+                readonly type: "superadmin-user-meta-type-{key}";
+                readonly public: "superadmin-user-meta-public-{key}";
+                readonly searchable: "superadmin-user-meta-searchable-{key}";
+            };
+        };
+    };
+    readonly teams: {
+        readonly container: "superadmin-teams";
+        readonly header: {
+            readonly backButton: "superadmin-teams-back";
+            readonly title: "superadmin-teams-title";
+            readonly refreshButton: "superadmin-teams-refresh";
+        };
+        readonly stats: {
+            readonly totalTeams: "superadmin-teams-stat-total";
+        };
+        readonly filters: {
+            readonly search: "superadmin-teams-search";
+            readonly clearButton: "superadmin-teams-filter-clear";
+        };
+        readonly tabs: {
+            readonly container: "superadmin-teams-tabs";
+            readonly userTeams: "superadmin-teams-tab-user";
+            readonly systemAdmin: "superadmin-teams-tab-system";
+        };
+        readonly table: {
+            readonly element: "superadmin-teams-table";
+            readonly row: "superadmin-teams-row-{id}";
+            readonly menuButton: "superadmin-teams-menu-{id}";
+            readonly menuContent: "superadmin-teams-menu-content-{id}";
+            readonly viewButton: "superadmin-teams-view-{id}";
+            readonly editButton: "superadmin-teams-edit-{id}";
+            readonly deleteButton: "superadmin-teams-delete-{id}";
+        };
+        readonly pagination: {
+            readonly container: "superadmin-teams-pagination";
+            readonly pageSize: "superadmin-teams-page-size";
+            readonly first: "superadmin-teams-page-first";
+            readonly prev: "superadmin-teams-page-prev";
+            readonly next: "superadmin-teams-page-next";
+            readonly last: "superadmin-teams-page-last";
+        };
+        readonly detail: {
+            readonly container: "superadmin-team-detail";
+            readonly info: {
+                readonly name: "superadmin-team-name";
+                readonly owner: "superadmin-team-owner";
+                readonly members: "superadmin-team-members";
+            };
+            readonly membersTable: {
+                readonly container: "superadmin-team-members-table";
+                readonly row: "superadmin-team-member-row-{id}";
+            };
+            readonly subscription: {
+                readonly container: "superadmin-team-subscription";
+                readonly plan: "superadmin-team-plan";
+                readonly status: "superadmin-team-sub-status";
+                readonly period: "superadmin-team-sub-period";
+                readonly stripeLink: "superadmin-team-stripe-link";
+            };
+            readonly billingHistory: {
+                readonly container: "superadmin-team-billing";
+                readonly row: "superadmin-team-billing-row-{id}";
+            };
+            readonly usage: {
+                readonly container: "superadmin-team-usage";
+                readonly metric: "superadmin-team-usage-{slug}";
+            };
+        };
+    };
+    readonly subscriptions: {
+        readonly container: "superadmin-subscriptions";
+        readonly header: {
+            readonly backButton: "superadmin-subscriptions-back";
+            readonly title: "superadmin-subscriptions-title";
+            readonly refreshButton: "superadmin-subscriptions-refresh";
+        };
+        readonly stats: {
+            readonly mrr: "superadmin-subscriptions-mrr";
+            readonly arr: "superadmin-subscriptions-arr";
+            readonly activeCount: "superadmin-subscriptions-active";
+            readonly totalCount: "superadmin-subscriptions-total";
+            readonly needsAttention: "superadmin-subscriptions-attention";
+            readonly planDistribution: "superadmin-subscriptions-distribution";
+            readonly planCount: "superadmin-subscriptions-plan-{plan}";
+        };
+        readonly filters: {
+            readonly search: "superadmin-subscriptions-search";
+            readonly statusFilter: "superadmin-subscriptions-filter-status";
+            readonly planFilter: "superadmin-subscriptions-filter-plan";
+            readonly intervalFilter: "superadmin-subscriptions-filter-interval";
+            readonly clearButton: "superadmin-subscriptions-filter-clear";
+        };
+        readonly table: {
+            readonly element: "superadmin-subscriptions-table";
+            readonly row: "superadmin-subscriptions-row-{id}";
+            readonly viewTeamButton: "superadmin-subscriptions-view-team-{id}";
+            readonly stripeLink: "superadmin-subscriptions-stripe-{id}";
+        };
+        readonly pagination: {
+            readonly container: "superadmin-subscriptions-pagination";
+            readonly pageSize: "superadmin-subscriptions-page-size";
+            readonly first: "superadmin-subscriptions-page-first";
+            readonly prev: "superadmin-subscriptions-page-prev";
+            readonly next: "superadmin-subscriptions-page-next";
+            readonly last: "superadmin-subscriptions-page-last";
+        };
+    };
+    readonly teamRoles: {
+        readonly container: "superadmin-team-roles";
+        readonly header: {
+            readonly backButton: "superadmin-team-roles-back";
+            readonly title: "superadmin-team-roles-title";
+        };
+        readonly tabs: {
+            readonly container: "superadmin-team-roles-tabs";
+            readonly rbac: "superadmin-team-roles-tab-rbac";
+            readonly plans: "superadmin-team-roles-tab-plans";
+        };
+        readonly rbac: {
+            readonly stats: {
+                readonly roles: "superadmin-rbac-stat-roles";
+                readonly permissions: "superadmin-rbac-stat-permissions";
+                readonly protectedRole: "superadmin-rbac-stat-protected";
+                readonly defaultRole: "superadmin-rbac-stat-default";
+            };
+            readonly hierarchy: {
+                readonly container: "superadmin-rbac-hierarchy";
+                readonly roleCard: "superadmin-rbac-role-{role}";
+            };
+            readonly matrix: {
+                readonly container: "superadmin-rbac-matrix";
+                readonly permissionRow: "superadmin-rbac-permission-{permission}";
+            };
+        };
+        readonly plans: {
+            readonly stats: {
+                readonly totalPlans: "superadmin-plans-stat-total";
+                readonly features: "superadmin-plans-stat-features";
+                readonly limits: "superadmin-plans-stat-limits";
+                readonly activeTheme: "superadmin-plans-stat-theme";
+            };
+            readonly planCard: "superadmin-plans-card-{slug}";
+            readonly matrix: {
+                readonly container: "superadmin-plans-matrix";
+                readonly featureRow: "superadmin-plans-feature-{slug}";
+                readonly limitRow: "superadmin-plans-limit-{slug}";
+            };
+        };
+    };
+    readonly docs: {
+        readonly container: "superadmin-docs-container";
+        readonly pageDetail: "superadmin-docs-page";
+        readonly sectionCard: "superadmin-docs-section-{slug}";
+        readonly pageLink: "superadmin-docs-link-{slug}";
+    };
+};
+export type SuperadminSelectorsType = typeof SUPERADMIN_SELECTORS;
+//# sourceMappingURL=superadmin.selectors.d.ts.map

package/dist/lib/selectors/domains/superadmin.selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superadmin.selectors.d.ts","sourceRoot":"","sources":["../../../../src/lib/selectors/domains/superadmin.selectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8RvB,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,OAAO,oBAAoB,CAAA"}

package/dist/lib/selectors/domains/taxonomies.selectors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Taxonomies Selectors
+ *
+ * Selectors for taxonomy management (categories, tags, etc.).
+ */
+export declare const TAXONOMIES_SELECTORS: {
+    readonly list: {
+        readonly container: "taxonomies-list-table";
+        readonly createButton: "taxonomies-create-button";
+        readonly row: "taxonomy-row-{id}";
+        readonly editButton: "taxonomies-edit-{id}";
+        readonly deleteButton: "taxonomies-delete-{id}";
+    };
+    readonly form: {
+        readonly dialog: "taxonomy-form-dialog";
+        readonly nameInput: "taxonomy-name-input";
+        readonly slugInput: "taxonomy-slug-input";
+        readonly descriptionInput: "taxonomy-description-input";
+        readonly iconInput: "taxonomy-icon-input";
+        readonly colorInput: "taxonomy-color-input";
+        readonly parentSelect: "taxonomy-parent-select";
+        readonly orderInput: "taxonomy-order-input";
+        readonly saveButton: "taxonomy-save-button";
+        readonly cancelButton: "taxonomy-cancel-button";
+    };
+    readonly confirmDelete: {
+        readonly dialog: "taxonomy-delete-dialog";
+        readonly confirmButton: "taxonomy-delete-confirm";
+        readonly cancelButton: "taxonomy-delete-cancel";
+    };
+};
+export type TaxonomiesSelectorsType = typeof TAXONOMIES_SELECTORS;
+//# sourceMappingURL=taxonomies.selectors.d.ts.map

package/dist/lib/selectors/domains/taxonomies.selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomies.selectors.d.ts","sourceRoot":"","sources":["../../../../src/lib/selectors/domains/taxonomies.selectors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,OAAO,oBAAoB,CAAA"}

package/dist/lib/selectors/domains/teams.selectors.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Teams Selectors
+ *
+ * Selectors for team management:
+ * - Team switcher
+ * - Team creation
+ * - Team members
+ * - Invitations
+ */
+export declare const TEAMS_SELECTORS: {
+    readonly switcher: {
+        readonly compact: "team-switcher-compact";
+        readonly full: "team-switcher";
+        readonly dropdown: "team-switcher-dropdown";
+        readonly option: "team-option-{slug}";
+        readonly manageLink: "manage-teams-link";
+        readonly createButton: "create-team-button";
+    };
+    readonly switchModal: {
+        readonly container: "team-switch-modal";
+    };
+    readonly create: {
+        readonly dialog: "create-team-dialog";
+        readonly button: "create-team-button";
+        readonly nameInput: "team-name-input";
+        readonly slugInput: "team-slug-input";
+        readonly descriptionInput: "team-description-input";
+        readonly cancel: "cancel-create-team";
+        readonly submit: "submit-create-team";
+    };
+    readonly members: {
+        readonly section: "team-members-section";
+        readonly row: "member-row-{id}";
+        readonly actions: "member-actions-{id}";
+        readonly makeRole: "make-{role}-action";
+        readonly remove: "remove-member-action";
+    };
+    readonly invite: {
+        readonly button: "invite-member-button";
+        readonly buttonDisabled: "invite-member-button-disabled";
+        readonly dialog: "invite-member-dialog";
+        readonly emailInput: "member-email-input";
+        readonly roleSelect: "member-role-select";
+        readonly roleOption: "role-option-{role}";
+        readonly cancel: "cancel-invite-member";
+        readonly submit: "submit-invite-member";
+    };
+    readonly invitations: {
+        readonly row: "invitation-row-{id}";
+        readonly cancel: "cancel-invitation-{id}";
+    };
+    /**
+     * Inline editing for team name and description
+     *
+     * Note on selector structure: The name and description fields have separate
+     * selector definitions rather than using a dynamic pattern. This is an intentional
+     * design decision because:
+     * 1. There are only 2 fields (name and description), making duplication minimal
+     * 2. Each field has different input types (Input vs Textarea) with distinct selectors
+     * 3. Explicit definitions provide better clarity and type safety
+     * 4. The small duplication cost is outweighed by improved readability
+     *
+     * Decision documented in PR #1 code review (Issue #9).
+     */
+    readonly edit: {
+        readonly name: {
+            readonly value: "team-edit-name-value";
+            readonly editIcon: "team-edit-name-edit-icon";
+            readonly input: "team-edit-name-input";
+            readonly saveIcon: "team-edit-name-save-icon";
+            readonly cancelIcon: "team-edit-name-cancel-icon";
+            readonly error: "team-edit-name-error";
+            readonly success: "team-edit-name-success";
+        };
+        readonly description: {
+            readonly value: "team-edit-description-value";
+            readonly editIcon: "team-edit-description-edit-icon";
+            readonly textarea: "team-edit-description-textarea";
+            readonly saveIcon: "team-edit-description-save-icon";
+            readonly cancelIcon: "team-edit-description-cancel-icon";
+            readonly error: "team-edit-description-error";
+            readonly success: "team-edit-description-success";
+        };
+        readonly success: "team-edit-success";
+        readonly error: "team-edit-error";
+    };
+    readonly acceptInvite: {
+        readonly loading: "accept-invite-loading";
+        readonly container: "accept-invite-container";
+        readonly info: "accept-invite-info";
+        readonly teamName: "accept-invite-team-name";
+        readonly requiresAuth: "accept-invite-requires-auth";
+        readonly inviter: "accept-invite-inviter";
+        readonly role: "accept-invite-role";
+        readonly signin: "accept-invite-signin";
+        readonly signup: "accept-invite-signup";
+        readonly valid: "accept-invite-valid";
+        readonly accept: "accept-invite-accept";
+        readonly accepting: "accept-invite-accepting";
+        readonly success: "accept-invite-success";
+        readonly alreadyMember: "accept-invite-already-member";
+        readonly emailMismatch: "accept-invite-email-mismatch";
+        readonly notFound: "accept-invite-not-found";
+        readonly expired: "accept-invite-expired";
+        readonly error: "accept-invite-error";
+    };
+};
+export type TeamsSelectorsType = typeof TEAMS_SELECTORS;
+//# sourceMappingURL=teams.selectors.d.ts.map

package/dist/lib/selectors/domains/teams.selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.selectors.d.ts","sourceRoot":"","sources":["../../../../src/lib/selectors/domains/teams.selectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0C1B;;;;;;;;;;;;OAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CK,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,OAAO,eAAe,CAAA"}

package/dist/lib/selectors/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core Selectors - SOURCE OF TRUTH
+ *
+ * This is the central location for all selector definitions.
+ * The testing package re-exports from here.
+ */
+export { createSelectorHelpers, getNestedValue, replacePlaceholders, type Replacements, type SelectorObject, type SelectorHelpers, type EntitySelectorHelpers, } from './selector-factory';
+export { CORE_SELECTORS, type CoreSelectorsType } from './core-selectors';
+export * from './domains';
+export { SELECTORS, sel, s, selDev, cySelector, entitySelectors, type SelectorsType, type SelectorPath, } from './selectors';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/selectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/selectors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzE,cAAc,WAAW,CAAA;AAGzB,OAAO,EACL,SAAS,EACT,GAAG,EACH,CAAC,EACD,MAAM,EACN,UAAU,EACV,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA"}

package/dist/lib/selectors/selector-factory.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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
+ */
+export type Replacements = Record<string, string | number>;
+/**
+ * Generic selector object type
+ */
+export type SelectorObject = Record<string, unknown>;
+/**
+ * Return type for createSelectorHelpers
+ */
+export 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
+ */
+export 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
+ */
+export 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'
+ */
+export 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'
+ * ```
+ */
+export declare function createSelectorHelpers<T extends SelectorObject>(selectors: T): SelectorHelpers<T>;
+//# sourceMappingURL=selector-factory.d.ts.map

package/dist/lib/selectors/selector-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-factory.d.ts","sourceRoot":"","sources":["../../../src/lib/selectors/selector-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAE1D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,cAAc;IACvD,2BAA2B;IAC3B,SAAS,EAAE,CAAC,CAAA;IACZ,iCAAiC;IACjC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,MAAM,CAAA;IAC1D,oBAAoB;IACpB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,MAAM,CAAA;IACxD,iDAAiD;IACjD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAA;IACzE,kDAAkD;IAClD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,MAAM,CAAA;IACjE,8CAA8C;IAC9C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,CAAA;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,MAAM,CAAA;IAC5B,MAAM,EAAE,MAAM,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,MAAM,CAAA;IACvB,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3B,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3C,IAAI,EAAE,MAAM,MAAM,CAAA;IAClB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/B,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,MAAM,EAAE,MAAM,MAAM,CAAA;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACvD;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,GAC1B,MAAM,CAOR;AAcD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAC5D,SAAS,EAAE,CAAC,GACX,eAAe,CAAC,CAAC,CAAC,CA6FpB"}