@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.77

package/dist/lib/teams/schema.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Teams System Object - Zod Validation Schemas
+ *
+ * Teams are system objects with dedicated services, not generic entities.
+ * This file contains all Zod schemas for the teams system.
+ *
+ * @module core/lib/teams/schema
+ */
+import { z } from 'zod';
+export declare const teamRoleSchema: z.ZodEnum<{
+    member: "member";
+    owner: "owner";
+    admin: "admin";
+    viewer: "viewer";
+}>;
+export declare const invitationStatusSchema: z.ZodEnum<{
+    expired: "expired";
+    pending: "pending";
+    accepted: "accepted";
+    declined: "declined";
+}>;
+export declare const teamSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ownerId: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const teamMemberSchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    userId: z.ZodString;
+    role: z.ZodEnum<{
+        member: "member";
+        owner: "owner";
+        admin: "admin";
+        viewer: "viewer";
+    }>;
+    invitedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    joinedAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const teamInvitationSchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodEnum<{
+        member: "member";
+        owner: "owner";
+        admin: "admin";
+        viewer: "viewer";
+    }>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        pending: "pending";
+        accepted: "accepted";
+        declined: "declined";
+    }>;
+    token: z.ZodString;
+    invitedBy: z.ZodString;
+    expiresAt: z.ZodString;
+    acceptedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    declinedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const createTeamSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for owner-only team updates (name/description)
+ * Only team owners (ownerId === userId) can update these fields
+ * Used when: Owner updates team name or description
+ *
+ * @security This schema is only used after owner verification
+ * @note Fields are optional to allow partial updates (e.g., only description)
+ */
+export declare const ownerUpdateTeamSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for admin team updates (non-owner-only fields)
+ * Admins can update: slug, avatarUrl, settings
+ * Does NOT include name/description (those are owner-only)
+ * Used when: Admin (non-owner) updates team metadata
+ *
+ * @security This schema explicitly excludes owner-only fields (name, description)
+ */
+export declare const adminUpdateTeamSchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Schema for general team updates (combined owner + admin permissions)
+ * This is a merge of ownerUpdateTeamSchema and adminUpdateTeamSchema
+ * Used for: API consumers that need a unified schema
+ *
+ * @note For internal use, prefer ownerUpdateTeamSchema or adminUpdateTeamSchema
+ * based on the user's role and the fields being updated
+ */
+export declare const updateTeamSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    slug: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const inviteMemberSchema: z.ZodObject<{
+    email: z.ZodString;
+    role: z.ZodEnum<{
+        member: "member";
+        admin: "admin";
+        viewer: "viewer";
+    }>;
+}, z.core.$strip>;
+export declare const updateMemberRoleSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        member: "member";
+        admin: "admin";
+        viewer: "viewer";
+    }>;
+}, z.core.$strip>;
+export declare const paginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const teamListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        name: "name";
+        createdAt: "createdAt";
+        updatedAt: "updatedAt";
+    }>>;
+    order: z.ZodDefault<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        all: "all";
+    }>>;
+}, z.core.$strip>;
+export declare const memberListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    role: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        owner: "owner";
+        admin: "admin";
+        viewer: "viewer";
+    }>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const invitationListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        expired: "expired";
+        pending: "pending";
+        accepted: "accepted";
+        declined: "declined";
+    }>>;
+}, z.core.$strip>;
+export type TeamSchema = z.infer<typeof teamSchema>;
+export type TeamMemberSchema = z.infer<typeof teamMemberSchema>;
+export type TeamInvitationSchema = z.infer<typeof teamInvitationSchema>;
+export type CreateTeamSchema = z.infer<typeof createTeamSchema>;
+export type UpdateTeamSchema = z.infer<typeof updateTeamSchema>;
+export type OwnerUpdateTeamSchema = z.infer<typeof ownerUpdateTeamSchema>;
+export type AdminUpdateTeamSchema = z.infer<typeof adminUpdateTeamSchema>;
+export type InviteMemberSchema = z.infer<typeof inviteMemberSchema>;
+export type UpdateMemberRoleSchema = z.infer<typeof updateMemberRoleSchema>;
+export type TeamListQuerySchema = z.infer<typeof teamListQuerySchema>;
+export type MemberListQuerySchema = z.infer<typeof memberListQuerySchema>;
+export type InvitationListQuerySchema = z.infer<typeof invitationListQuerySchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/teams/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/teams/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,cAAc;;;;;EAAiD,CAAA;AAC5E,eAAO,MAAM,sBAAsB;;;;;EAAyD,CAAA;AAG5F,eAAO,MAAM,UAAU;;;;;;;;;;iBAerB,CAAA;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAS3B,CAAA;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAa/B,CAAA;AAGF,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;iBAOhC,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;iBAAqD,CAAA;AAElF,eAAO,MAAM,kBAAkB;;;;;;;iBAK7B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;iBAIjC,CAAA;AAGF,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAA;AAGF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBAK9B,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAGhC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;iBAEpC,CAAA;AAGF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AACnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC/D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACzE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AACrE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACzE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/lib/teams/teams.api.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Teams Client API
+ *
+ * Client-side API functions for team operations.
+ * These functions are pure (no React) and can be used in hooks or directly.
+ *
+ * @module core/lib/teams/teams.api
+ *
+ * @example
+ * // Direct usage
+ * const teams = await TeamsAPI.getUserTeams()
+ *
+ * // In React Query
+ * useQuery({ queryFn: TeamsAPI.getUserTeams })
+ */
+import type { Team, AdminTeamsResponse, AdminTeamsParams, CreateTeamRequest } from './types';
+/**
+ * Teams Client API
+ *
+ * Provides methods for fetching teams from the API.
+ * Server-side operations use TeamService directly.
+ */
+export declare class TeamsAPI {
+    /**
+     * Fetch current user's teams
+     *
+     * @returns Array of teams the user belongs to
+     * @throws Error if request fails
+     *
+     * @example
+     * const teams = await TeamsAPI.getUserTeams()
+     */
+    static getUserTeams(): Promise<Team[]>;
+    /**
+     * Create a new team
+     *
+     * @param data - Team creation data
+     * @returns Created team
+     * @throws Error if request fails
+     */
+    static createTeam(data: CreateTeamRequest): Promise<Team>;
+    /**
+     * Fetch all teams (admin only)
+     *
+     * Requires superadmin or developer role.
+     * Supports search, filtering by type, and pagination.
+     *
+     * @param params - Query parameters
+     * @returns Teams response with counts and pagination
+     * @throws Error if request fails or user is not authorized
+     *
+     * @example
+     * // Get all user teams
+     * const response = await TeamsAPI.getAdminTeams({ type: 'user' })
+     *
+     * // Search teams
+     * const response = await TeamsAPI.getAdminTeams({ search: 'acme' })
+     *
+     * // Paginate
+     * const response = await TeamsAPI.getAdminTeams({ page: 2, limit: 20 })
+     */
+    static getAdminTeams(params?: AdminTeamsParams): Promise<AdminTeamsResponse>;
+}
+//# sourceMappingURL=teams.api.d.ts.map

package/dist/lib/teams/teams.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.api.d.ts","sourceRoot":"","sources":["../../../src/lib/teams/teams.api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAYhB;;;;;GAKG;AACH,qBAAa,QAAQ;IAKnB;;;;;;;;OAQG;WACU,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAa5C;;;;;;OAMG;WACU,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D;;;;;;;;;;;;;;;;;;;OAmBG;WACU,aAAa,CACxB,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;CAiC/B"}

package/dist/lib/teams/teams.keys.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Teams Query Keys Factory
+ *
+ * Centralized query key management for all team-related React Query hooks.
+ * Enables predictable caching and smart cache invalidation.
+ *
+ * @module core/lib/teams/teams.keys
+ *
+ * @example
+ * // Using keys in hooks
+ * useQuery({ queryKey: teamsKeys.user() })
+ * useQuery({ queryKey: teamsKeys.adminList({ search: 'acme' }) })
+ *
+ * // Invalidating related queries
+ * queryClient.invalidateQueries({ queryKey: teamsKeys.all })
+ */
+import type { AdminTeamsParams } from './types';
+export declare const teamsKeys: {
+    /**
+     * Base key for all team queries
+     * Use to invalidate ALL team-related caches
+     */
+    readonly all: readonly ["teams"];
+    /**
+     * User's teams (normal user scope)
+     * Endpoint: GET /api/v1/teams
+     */
+    readonly user: () => readonly ["teams", "user"];
+    /**
+     * Single team by ID
+     */
+    readonly detail: (teamId: string) => readonly ["teams", "detail", string];
+    /**
+     * Admin teams scope (superadmin/developer)
+     * Base key for all admin team queries
+     */
+    readonly admin: () => readonly ["teams", "admin"];
+    /**
+     * Admin teams list with parameters
+     * Endpoint: GET /api/superadmin/teams
+     * Used by superadmin management page
+     */
+    readonly adminList: (params: AdminTeamsParams) => readonly ["teams", "admin", "list", AdminTeamsParams];
+    /**
+     * Admin teams search (optimized for dropdowns)
+     * Uses simplified key for search-based caching
+     */
+    readonly adminSearch: (search: string) => readonly ["teams", "admin", "search", string];
+};
+/**
+ * Type helper for query key inference
+ */
+export type TeamsKeys = typeof teamsKeys;
+//# sourceMappingURL=teams.keys.d.ts.map

package/dist/lib/teams/teams.keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.keys.d.ts","sourceRoot":"","sources":["../../../src/lib/teams/teams.keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;8BACc,MAAM;IAEvB;;;OAGG;;IAGH;;;;OAIG;iCACiB,gBAAgB;IAGpC;;;OAGG;mCACmB,MAAM;CAEpB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAA"}

package/dist/lib/teams/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Teams System Object - TypeScript Types
+ *
+ * Teams are system objects with dedicated services, not generic entities.
+ * This file contains all TypeScript types for the teams system.
+ *
+ * @module core/lib/teams/types
+ */
+/**
+ * Core team roles that are always available
+ * These are the base roles defined in the core config
+ */
+export type CoreTeamRole = 'owner' | 'admin' | 'member' | 'viewer';
+/**
+ * Team member role - extensible type
+ *
+ * Themes can add custom roles via app.config.ts additionalTeamRoles.
+ * The `& {}` trick allows string literals while maintaining autocomplete
+ * for the core roles.
+ *
+ * @example
+ * ```typescript
+ * // Core roles work as expected
+ * const role: TeamRole = 'owner' // OK
+ *
+ * // Custom roles defined in theme config also work
+ * const customRole: TeamRole = 'editor' // OK if 'editor' is in availableTeamRoles
+ * ```
+ */
+export type TeamRole = CoreTeamRole | (string & {});
+/**
+ * Validate if a string is a valid team role
+ *
+ * Checks against the merged config's availableTeamRoles.
+ * Use this for runtime validation of role values.
+ *
+ * @param role - The role string to validate
+ * @returns True if the role exists in availableTeamRoles
+ *
+ * @example
+ * ```typescript
+ * if (isValidTeamRole(someRole)) {
+ *   // someRole is guaranteed to be in config
+ * }
+ * ```
+ */
+export declare function isValidTeamRole(role: string): role is TeamRole;
+/**
+ * Get all available team roles from merged config
+ */
+export declare function getAvailableTeamRoles(): readonly string[];
+export type InvitationStatus = 'pending' | 'accepted' | 'declined' | 'expired';
+export interface Team {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    ownerId: string;
+    avatarUrl: string | null;
+    settings: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TeamMember {
+    id: string;
+    teamId: string;
+    userId: string;
+    role: TeamRole;
+    invitedBy: string | null;
+    joinedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TeamInvitation {
+    id: string;
+    teamId: string;
+    email: string;
+    role: TeamRole;
+    status: InvitationStatus;
+    token: string;
+    invitedBy: string;
+    expiresAt: string;
+    acceptedAt: string | null;
+    declinedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TeamWithMembers extends Team {
+    members: TeamMember[];
+    memberCount: number;
+}
+export interface TeamWithSubscription extends Team {
+    subscription?: {
+        id: string;
+        planId: string;
+        status: string;
+        trialEndsAt?: string;
+    };
+}
+export interface UserTeamMembership {
+    team: Team;
+    role: TeamRole;
+    joinedAt: string;
+}
+export interface CreateTeamRequest {
+    name: string;
+    slug: string;
+    description?: string;
+}
+export interface UpdateTeamRequest {
+    name?: string;
+    slug?: string;
+    description?: string;
+    avatarUrl?: string;
+    settings?: Record<string, any>;
+}
+export interface InviteMemberRequest {
+    email: string;
+    role: Exclude<TeamRole, 'owner'>;
+}
+export interface UpdateMemberRoleRequest {
+    role: Exclude<TeamRole, 'owner'>;
+}
+export interface TeamListResponse {
+    teams: TeamWithMembers[];
+    pagination?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface TeamDetailResponse {
+    team: TeamWithMembers;
+}
+export interface MemberListResponse {
+    members: (TeamMember & {
+        user?: any;
+    })[];
+}
+export interface InvitationListResponse {
+    invitations: (TeamInvitation & {
+        team?: Team;
+    })[];
+}
+/**
+ * Team with owner information (admin view)
+ * Used in superadmin endpoints and admin hooks
+ */
+export interface TeamWithOwner {
+    id: string;
+    name: string;
+    owner: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    memberCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Admin teams list response
+ * Response format from /api/superadmin/teams
+ */
+export interface AdminTeamsResponse {
+    teams: TeamWithOwner[];
+    counts: {
+        total: number;
+        user: number;
+        system: number;
+    };
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    };
+    metadata?: {
+        requestedBy: string;
+        requestedAt: string;
+        source: string;
+    };
+}
+/**
+ * Parameters for admin teams query
+ */
+export interface AdminTeamsParams {
+    search?: string;
+    type?: 'user' | 'system';
+    page?: number;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/teams/types.d.ts.map

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

package/dist/lib/template-resolver.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Template Override Resolver
+ *
+ * Universal system for resolving and using theme template overrides across all app/ routes
+ *
+ * SECURITY ARCHITECTURE:
+ *
+ * This system implements a layered security model where some layouts
+ * are protected from theme overrides to maintain security boundaries:
+ *
+ * 1. CORE SECURITY LAYER (Non-overrideable):
+ *    - Files that DON'T use template overrides cannot be overridden
+ *    - Example: /app/dashboard/layout.tsx (contains auth logic)
+ *    - These files provide essential security boundaries
+ *    - Configured via PROTECTED_PATHS array
+ *
+ * 2. UI CUSTOMIZATION LAYER (Overrideable):
+ *    - Files that USE template overrides can be themed
+ *    - Example: /app/dashboard/(main)/layout.tsx (custom UI/sidebar)
+ *    - Example: /app/(auth)/signup/page.tsx (custom signup experience)
+ *    - These run within security boundaries of parent layouts
+ *
+ * UNIVERSAL USAGE PATTERNS:
+ *
+ * 1. HOC Pattern (Recommended for new files):
+ *    export default withTemplateOverrideFor('app/my-route/page.tsx')(MyComponent)
+ *
+ * 2. Direct Function Pattern (Compatible with existing files):
+ *    export default getTemplateOrDefault('app/my-route/page.tsx', MyComponent)
+ *
+ * 3. Protected Path Configuration:
+ *    Add to PROTECTED_PATHS to prevent theme overrides for security
+ *
+ * This ensures themes can override ANY route (pages, layouts, etc.) while
+ * maintaining granular security control where critical.
+ */
+import React from 'react';
+/**
+ * Get template component with fallback - Granular Protection Support
+ * Use this in your app router files to conditionally use theme templates
+ *
+ * Respects granular protection levels:
+ * - PROTECTED_ALL: Returns default component (no override)
+ * - PROTECTED_RENDER: Returns default component (component protected)
+ * - PROTECTED_METADATA: Allows component override
+ * - NONE: Allows component override
+ */
+export declare function getTemplateOrDefault<T = any>(appPath: string, defaultComponent: T): T;
+/**
+ * Get template metadata with fallback - Granular Protection Support
+ * Use this in your app router files to conditionally use theme metadata
+ *
+ * Respects granular protection levels:
+ * - PROTECTED_ALL: Returns default metadata (no override)
+ * - PROTECTED_RENDER: Allows metadata override (KEY FEATURE!)
+ * - PROTECTED_METADATA: Returns default metadata (metadata protected)
+ * - NONE: Allows metadata override
+ */
+export declare function getMetadataOrDefault(appPath: string, defaultMetadata: any): any;
+/**
+ * Hook to check if current route has template override
+ */
+export declare function useTemplateOverride(pathname: string): {
+    hasPageOverride: boolean;
+    hasLayoutOverride: boolean;
+    pageTemplate: any;
+    layoutTemplate: any;
+    getPageComponent: () => any;
+    getLayoutComponent: () => any;
+};
+/**
+ * Utility to resolve template with metadata
+ */
+export declare function getTemplateWithInfo(appPath: string): {
+    hasOverride: boolean;
+    component?: any;
+    template?: TemplateOverride;
+    originalPath: string;
+};
+/**
+ * Debug utility to show template override status
+ */
+export declare function debugTemplateOverrides(): void;
+/**
+ * Universal HOC for Template Override Resolution - Granular Protection Support
+ *
+ * Automatically detects component path and resolves theme overrides.
+ *
+ * Usage:
+ *   export default withTemplateOverride(MyComponent, 'app/signup/page.tsx')
+ *
+ * Security:
+ *   Respects granular protection levels - only blocks component override when necessary
+ */
+export declare function withTemplateOverride<T extends React.ComponentType<any>>(Component: T, appPath: string): T;
+/**
+ * Curried version for cleaner usage
+ *
+ * Usage:
+ *   export default withTemplateOverrideFor('app/(auth)/signup/page.tsx')(SignupPage)
+ */
+export declare function withTemplateOverrideFor(appPath: string): <T extends React.ComponentType<any>>(Component: T) => T;
+//# sourceMappingURL=template-resolver.d.ts.map

package/dist/lib/template-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/template-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAC1C,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,CAAC,GAClB,CAAC,CAuBH;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,GAAG,GACnB,GAAG,CAwBL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM;;;;;;;EAenD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM;;;;;EAElD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,SAmBrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EACrE,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,MAAM,GACd,CAAC,CA8BH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,IACrC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,KAAG,CAAC,CAGrE"}

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

@@ -0,0 +1,16 @@
+/**
+ * Core Testing Utilities - RUNTIME
+ *
+ * These utilities are used by core components at runtime for:
+ * - data-cy attributes (via sel())
+ * - Accessibility attributes
+ * - Testing props
+ *
+ * For Cypress tests in npm mode, use @nextsparkjs/testing
+ *
+ * NOTE: Selector definitions live in @nextsparkjs/core/selectors
+ * This module re-exports them for backward compatibility.
+ */
+export * from '../selectors';
+export { createStateAttr, createPriorityAttr, createTestingProps, createAriaLabel, keyboardHelpers, } from './utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/test/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,cAAc,cAAc,CAAA;AAM5B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAA"}