@nextsparkjs/core 0.1.0-beta.8 → 0.1.0-beta.82

package/globals.css

@@ -292,6 +292,60 @@ body {
   @apply my-8 border-border;
 }
 
+/* =============================================
+   SKELETON - INP OPTIMIZED ANIMATIONS
+   High-performance skeleton loading states
+   ============================================= */
+
+/**
+ * GPU-accelerated skeleton pulse animation
+ * Uses opacity with will-change hint for smooth GPU-composited animation
+ * Respects prefers-reduced-motion for accessibility
+ */
+@keyframes skeleton-pulse {
+  0%, 100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.5;
+  }
+}
+
+/* Skeleton animation class - GPU accelerated */
+.animate-skeleton-pulse {
+  animation: skeleton-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+  will-change: opacity;
+}
+
+/* Respect reduced motion preference */
+@media (prefers-reduced-motion: reduce) {
+  .animate-skeleton-pulse {
+    animation: none;
+  }
+}
+
+/**
+ * CSS Containment for skeleton elements
+ * Isolates layout/paint calculations to improve INP
+ */
+.skeleton-contained {
+  contain: content;
+}
+
+/**
+ * Skeleton container with content-visibility optimization
+ * Skips rendering of off-screen skeleton items
+ */
+.skeleton-container {
+  contain: layout style;
+}
+
+/* Apply content-visibility to direct children for virtualization effect */
+.skeleton-container > * {
+  content-visibility: auto;
+  contain-intrinsic-size: auto 100px;
+}
+
 /* =============================================
    THEME SYSTEM - BUILD-TIME LOADING
    Custom theme CSS is automatically injected based on activeTheme config

package/migrations/001_better_auth_and_functions.sql

@@ -2,6 +2,24 @@
 -- Description: Extensiones y funciones de identidad para Better Auth
 -- Date: 2025-01-19
 
+-- =============================================================================
+-- ROLES FOR RLS (Row Level Security)
+-- These roles are pre-created in Supabase but not in vanilla PostgreSQL (Neon, etc.)
+-- =============================================================================
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'authenticated') THEN
+    CREATE ROLE authenticated;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'anon') THEN
+    CREATE ROLE anon;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'service_role') THEN
+    CREATE ROLE service_role;
+  END IF;
+END
+$$;
+
 -- Extensiones
 CREATE EXTENSION IF NOT EXISTS pgcrypto;
 

package/migrations/010_teams_functions_triggers.sql

@@ -108,19 +108,49 @@ BEGIN
 END;
 $$ LANGUAGE plpgsql STABLE SECURITY DEFINER;
 
--- Check if current user is superadmin
--- Returns true if the authenticated user has 'superadmin' role
--- Used for RLS policies to grant superadmins full access
-CREATE OR REPLACE FUNCTION public.is_superadmin()
+-- Check if current user can bypass RLS (Row Level Security)
+-- Returns true if user is superadmin OR developer in System Admin Team
+-- Used for RLS policies to grant elevated users full cross-team access
+-- Matches app-level bypass logic in dual-auth.ts
+CREATE OR REPLACE FUNCTION public.can_bypass_rls()
 RETURNS BOOLEAN AS $$
 DECLARE
+  current_user_id TEXT;
   user_role TEXT;
+  is_system_admin_member BOOLEAN;
 BEGIN
+  current_user_id := public.get_auth_user_id();
+
+  -- Get user role
   SELECT role INTO user_role
   FROM public."users"
-  WHERE id = public.get_auth_user_id();
+  WHERE id = current_user_id;
+
+  -- Superadmin always bypasses
+  IF user_role = 'superadmin' THEN
+    RETURN TRUE;
+  END IF;
+
+  -- Developer can bypass if member of System Admin Team (team-nextspark-001)
+  IF user_role = 'developer' THEN
+    SELECT EXISTS(
+      SELECT 1 FROM public."team_members"
+      WHERE "userId" = current_user_id
+        AND "teamId" = 'team-nextspark-001'
+    ) INTO is_system_admin_member;
+
+    RETURN is_system_admin_member;
+  END IF;
 
-  RETURN user_role = 'superadmin';
+  RETURN FALSE;
+END;
+$$ LANGUAGE plpgsql STABLE SECURITY DEFINER;
+
+-- Alias for backward compatibility (deprecated, use can_bypass_rls)
+CREATE OR REPLACE FUNCTION public.is_superadmin()
+RETURNS BOOLEAN AS $$
+BEGIN
+  RETURN public.can_bypass_rls();
 END;
 $$ LANGUAGE plpgsql STABLE SECURITY DEFINER;
 

package/migrations/018_patterns_table.sql

@@ -0,0 +1,104 @@
+-- Migration: 018_patterns_table.sql
+-- Description: Patterns table for reusable block compositions
+-- Date: 2025-01-15
+
+-- ============================================
+-- TABLE
+-- ============================================
+DROP TABLE IF EXISTS public."patterns" CASCADE;
+
+CREATE TABLE IF NOT EXISTS public."patterns" (
+  -- Primary Key (TEXT not UUID!)
+  id                  TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+
+  -- Foreign Keys (team-scoped entity)
+  "userId"            TEXT NOT NULL REFERENCES public."users"(id) ON DELETE CASCADE,
+  "teamId"            TEXT NOT NULL REFERENCES public."teams"(id) ON DELETE CASCADE,
+
+  -- Business Fields
+  title               VARCHAR(200) NOT NULL,
+  slug                VARCHAR(100) NOT NULL,
+  blocks              JSONB NOT NULL DEFAULT '[]'::jsonb,
+  status              VARCHAR(20) NOT NULL DEFAULT 'draft',
+  description         TEXT,
+
+  -- System fields (always last)
+  "createdAt"         TIMESTAMPTZ NOT NULL DEFAULT now(),
+  "updatedAt"         TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  -- Constraints
+  CONSTRAINT patterns_unique_slug_team UNIQUE("teamId", slug),
+  CONSTRAINT patterns_valid_slug CHECK (slug ~ '^[a-z0-9\-]+$'),
+  CONSTRAINT patterns_slug_length CHECK (LENGTH(slug) >= 2 AND LENGTH(slug) <= 100),
+  CONSTRAINT patterns_title_not_empty CHECK (LENGTH(TRIM(title)) > 0),
+  CONSTRAINT patterns_valid_status CHECK (status IN ('draft', 'published'))
+);
+
+-- Comments
+COMMENT ON TABLE  public."patterns"                 IS 'Reusable block compositions for page builder';
+COMMENT ON COLUMN public."patterns"."userId"        IS 'User who created the pattern';
+COMMENT ON COLUMN public."patterns"."teamId"        IS 'Team that owns the pattern';
+COMMENT ON COLUMN public."patterns".title           IS 'Pattern display name';
+COMMENT ON COLUMN public."patterns".slug            IS 'URL-friendly identifier, unique per team';
+COMMENT ON COLUMN public."patterns".blocks          IS 'Array of BlockInstance with props (JSONB)';
+COMMENT ON COLUMN public."patterns".status          IS 'Publication status: draft or published';
+COMMENT ON COLUMN public."patterns".description     IS 'Brief description of pattern purpose';
+
+-- ============================================
+-- TRIGGER updatedAt (uses Better Auth function)
+-- ============================================
+DROP TRIGGER IF EXISTS patterns_set_updated_at ON public."patterns";
+CREATE TRIGGER patterns_set_updated_at
+BEFORE UPDATE ON public."patterns"
+FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
+
+-- ============================================
+-- INDEXES
+-- ============================================
+-- Primary query patterns
+CREATE INDEX IF NOT EXISTS idx_patterns_user_id
+  ON public."patterns"("userId");
+
+CREATE INDEX IF NOT EXISTS idx_patterns_team_id
+  ON public."patterns"("teamId");
+
+CREATE INDEX IF NOT EXISTS idx_patterns_slug
+  ON public."patterns"(slug);
+
+CREATE INDEX IF NOT EXISTS idx_patterns_status
+  ON public."patterns"(status);
+
+CREATE INDEX IF NOT EXISTS idx_patterns_created
+  ON public."patterns"("createdAt" DESC);
+
+-- Compound index for team + slug lookups
+CREATE INDEX IF NOT EXISTS idx_patterns_team_slug
+  ON public."patterns"("teamId", slug);
+
+-- GIN index for JSONB blocks column (for querying block structure)
+CREATE INDEX IF NOT EXISTS idx_patterns_blocks_gin
+  ON public."patterns" USING GIN (blocks);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."patterns" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "patterns team can do all" ON public."patterns";
+
+-- Team isolation policy (shared: true - all team members see same patterns)
+-- Any authenticated user who is a member of the team can read/write patterns
+CREATE POLICY "patterns team can do all"
+ON public."patterns"
+FOR ALL TO authenticated
+USING (
+  public.is_superadmin()
+  OR
+  "teamId" = ANY(public.get_user_team_ids())
+)
+WITH CHECK (
+  public.is_superadmin()
+  OR
+  "teamId" = ANY(public.get_user_team_ids())
+);

package/migrations/019_pattern_usages_table.sql

@@ -0,0 +1,74 @@
+-- Migration: 019_pattern_usages_table.sql
+-- Description: Pattern usages tracking table for usage reports
+-- Date: 2025-01-16
+
+-- ============================================
+-- TABLE
+-- ============================================
+DROP TABLE IF EXISTS public."pattern_usages" CASCADE;
+
+CREATE TABLE IF NOT EXISTS public."pattern_usages" (
+  -- Primary Key (TEXT not UUID!)
+  id                  TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+
+  -- Foreign Keys
+  "patternId"         TEXT NOT NULL REFERENCES public."patterns"(id) ON DELETE CASCADE,
+  "teamId"            TEXT NOT NULL REFERENCES public."teams"(id) ON DELETE CASCADE,
+
+  -- Business Fields
+  "entityType"        VARCHAR(50) NOT NULL,  -- 'pages', 'posts', etc.
+  "entityId"          TEXT NOT NULL,
+
+  -- System fields (always last)
+  "createdAt"         TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  -- Constraints
+  CONSTRAINT pattern_usages_unique UNIQUE("patternId", "entityType", "entityId")
+);
+
+-- Comments
+COMMENT ON TABLE  public."pattern_usages"                 IS 'Tracks which entities use each pattern';
+COMMENT ON COLUMN public."pattern_usages"."patternId"     IS 'Pattern being referenced';
+COMMENT ON COLUMN public."pattern_usages"."teamId"        IS 'Team that owns the usage record';
+COMMENT ON COLUMN public."pattern_usages"."entityType"    IS 'Type of entity using the pattern (pages, posts, etc.)';
+COMMENT ON COLUMN public."pattern_usages"."entityId"      IS 'ID of the entity using the pattern';
+
+-- ============================================
+-- INDEXES
+-- ============================================
+-- Primary query patterns
+CREATE INDEX IF NOT EXISTS idx_pattern_usages_pattern_id
+  ON public."pattern_usages"("patternId");
+
+CREATE INDEX IF NOT EXISTS idx_pattern_usages_entity
+  ON public."pattern_usages"("entityType", "entityId");
+
+CREATE INDEX IF NOT EXISTS idx_pattern_usages_team_id
+  ON public."pattern_usages"("teamId");
+
+-- Compound index for efficient lookups
+CREATE INDEX IF NOT EXISTS idx_pattern_usages_pattern_entity
+  ON public."pattern_usages"("patternId", "entityType");
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."pattern_usages" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "pattern_usages team can do all" ON public."pattern_usages";
+
+-- Team isolation policy (same as patterns)
+CREATE POLICY "pattern_usages team can do all"
+ON public."pattern_usages"
+FOR ALL TO authenticated
+USING (
+  public.is_superadmin()
+  OR
+  "teamId" = ANY(public.get_user_team_ids())
+)
+WITH CHECK (
+  public.is_superadmin()
+  OR
+  "teamId" = ANY(public.get_user_team_ids())
+);

package/nextspark-entities.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ambient type declarations for @nextsparkjs/core entity configs
+ *
+ * These declarations provide TypeScript with type information for
+ * deep imports to entity config files when DTS generation is disabled.
+ *
+ * NOTE: This file must NOT have any imports to work as global declarations.
+ */
+
+// EntityConfig type for reference (simplified version for ambient declarations)
+interface AmbientEntityConfig {
+  slug: string
+  enabled: boolean
+  names: {
+    singular: string
+    plural: string
+  }
+  icon?: unknown
+  access?: {
+    public?: boolean
+    api?: boolean
+    metadata?: boolean
+    shared?: boolean
+    basePath?: string
+  }
+  ui?: {
+    dashboard?: {
+      showInMenu?: boolean
+      showInTopbar?: boolean
+    }
+    public?: {
+      hasArchivePage?: boolean
+      hasSinglePage?: boolean
+    }
+    features?: {
+      searchable?: boolean
+      sortable?: boolean
+      filterable?: boolean
+      bulkOperations?: boolean
+    }
+  }
+  table?: {
+    name?: string
+    columns?: unknown[]
+    relations?: unknown
+  }
+  schemas?: {
+    create?: unknown
+    update?: unknown
+  }
+  fields?: unknown[]
+}
+
+// Core entity: patterns
+declare module '@nextsparkjs/core/entities/patterns/patterns.config' {
+  export const patternsEntityConfig: AmbientEntityConfig
+}
+
+// Add more core entities here as needed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.8",
+  "version": "0.1.0-beta.82",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -54,6 +54,12 @@
       "style": "./dist/styles/ui.css",
       "default": "./dist/styles/ui.css"
     },
+    "./styles/utilities.css": "./styles/utilities.css",
+    "./styles/docs.css": "./styles/docs.css",
+    "./lib/middleware": {
+      "types": "./dist/lib/middleware/index.d.ts",
+      "import": "./dist/lib/middleware/index.js"
+    },
     "./lib/services": {
       "types": "./dist/lib/services/index.d.ts",
       "import": "./dist/lib/services/index.js"
@@ -82,6 +88,10 @@
       "types": "./dist/lib/api/index.d.ts",
       "import": "./dist/lib/api/index.js"
     },
+    "./lib/api/routes": {
+      "types": "./dist/lib/api/routes/index.d.ts",
+      "import": "./dist/lib/api/routes/index.js"
+    },
     "./lib/email": {
       "types": "./dist/lib/email/index.d.ts",
       "import": "./dist/lib/email/index.js"
@@ -90,14 +100,42 @@
       "types": "./dist/lib/oauth/index.d.ts",
       "import": "./dist/lib/oauth/index.js"
     },
-    "./lib/test": {
-      "types": "./dist/lib/test/index.d.ts",
-      "import": "./dist/lib/test/index.js"
-    },
     "./lib/scheduled-actions": {
       "types": "./dist/lib/scheduled-actions/index.d.ts",
       "import": "./dist/lib/scheduled-actions/index.js"
     },
+    "./lib/permissions": {
+      "types": "./dist/lib/permissions/index.d.ts",
+      "import": "./dist/lib/permissions/index.js"
+    },
+    "./lib/permissions/system": {
+      "types": "./dist/lib/permissions/system.d.ts",
+      "import": "./dist/lib/permissions/system.js"
+    },
+    "./lib/permissions/types": {
+      "types": "./dist/lib/permissions/types.d.ts",
+      "import": "./dist/lib/permissions/types.js"
+    },
+    "./lib/permissions/check": {
+      "types": "./dist/lib/permissions/check.d.ts",
+      "import": "./dist/lib/permissions/check.js"
+    },
+    "./lib/permissions/init": {
+      "types": "./dist/lib/permissions/init.d.ts",
+      "import": "./dist/lib/permissions/init.js"
+    },
+    "./lib/config/config-sync": {
+      "types": "./dist/lib/config/config-sync.d.ts",
+      "import": "./dist/lib/config/config-sync.js"
+    },
+    "./lib/blocks/*": {
+      "types": "./dist/lib/blocks/*.d.ts",
+      "import": "./dist/lib/blocks/*.js"
+    },
+    "./lib/plugins/env-loader": {
+      "types": "./dist/lib/plugins/env-loader.d.ts",
+      "import": "./dist/lib/plugins/env-loader.js"
+    },
     "./lib/*": {
       "types": "./dist/lib/*.d.ts",
       "import": "./dist/lib/*.js"
@@ -106,6 +144,10 @@
       "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js"
     },
+    "./hooks/teams": {
+      "types": "./dist/hooks/teams/index.d.ts",
+      "import": "./dist/hooks/teams/index.js"
+    },
     "./hooks/*": {
       "types": "./dist/hooks/*.d.ts",
       "import": "./dist/hooks/*.js"
@@ -178,6 +220,30 @@
       "types": "./dist/components/dashboard/mobile/index.d.ts",
       "import": "./dist/components/dashboard/mobile/index.js"
     },
+    "./components/patterns": {
+      "types": "./dist/components/patterns/index.d.ts",
+      "import": "./dist/components/patterns/index.js"
+    },
+    "./components/patterns/pages": {
+      "types": "./dist/components/patterns/pages/index.d.ts",
+      "import": "./dist/components/patterns/pages/index.js"
+    },
+    "./components/app": {
+      "types": "./dist/components/app/index.d.ts",
+      "import": "./dist/components/app/index.js"
+    },
+    "./components/app/layouts": {
+      "types": "./dist/components/app/layouts/index.d.ts",
+      "import": "./dist/components/app/layouts/index.js"
+    },
+    "./components/app/layouts/PublicNavbar": {
+      "types": "./dist/components/app/layouts/PublicNavbar.d.ts",
+      "import": "./dist/components/app/layouts/PublicNavbar.js"
+    },
+    "./components/app/layouts/PublicFooter": {
+      "types": "./dist/components/app/layouts/PublicFooter.d.ts",
+      "import": "./dist/components/app/layouts/PublicFooter.js"
+    },
     "./components/*": {
       "types": "./dist/components/*.d.ts",
       "import": "./dist/components/*.js"
@@ -204,67 +270,85 @@
     "./migrations/*": "./dist/migrations/*",
     "./config/*": "./dist/config/*",
     "./scripts/*": "./scripts/*",
-    "./testing": {
-      "types": "./dist/testing/index.d.ts",
-      "import": "./dist/testing/index.js"
-    },
     "./cypress-support": "./tests/cypress/support/index.ts",
-    "./jest-setup": "./tests/jest/setup.ts"
+    "./jest-setup": "./tests/jest/setup.ts",
+    "./selectors": {
+      "types": "./dist/lib/selectors/index.d.ts",
+      "import": "./dist/lib/selectors/index.js"
+    },
+    "./lib/selectors": {
+      "types": "./dist/lib/selectors/index.d.ts",
+      "import": "./dist/lib/selectors/index.js"
+    },
+    "./lib/test": {
+      "types": "./dist/lib/test/index.d.ts",
+      "import": "./dist/lib/test/index.js"
+    },
+    "./actions": {
+      "types": "./dist/lib/actions/index.d.ts",
+      "import": "./dist/lib/actions/index.js"
+    },
+    "./lib/actions": {
+      "types": "./dist/lib/actions/index.d.ts",
+      "import": "./dist/lib/actions/index.js"
+    },
+    "./entities/*": {
+      "types": "./dist/entities/*.d.ts",
+      "import": "./dist/entities/*.js"
+    },
+    "./entities/patterns/*": {
+      "types": "./dist/entities/patterns/*.d.ts",
+      "import": "./dist/entities/patterns/*.js"
+    }
   },
   "files": [
     "dist",
+    "styles",
     "templates",
     "migrations",
+    "src/entities",
     "tests/cypress/support",
     "tests/jest/setup.ts",
     "tests/jest/__mocks__",
     "globals.css",
     "theme-styles.css",
+    "nextspark-entities.d.ts",
     "README.md",
     "scripts"
   ],
-  "scripts": {
-    "build": "tsup && pnpm build:dts && pnpm build:ui-css",
-    "build:js": "tsup",
-    "build:dts": "tsc -p tsconfig.dts.json || echo '⚠️  DTS generation completed with some type errors (partial coverage)'",
-    "build:ui-css": "node scripts/build/build-ui-css.mjs",
-    "dev": "tsup --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
-  },
   "peerDependencies": {
     "next": ">=14.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
+    "@cypress/grep": "^5.0.1",
+    "@tailwindcss/cli": "^4",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
+    "@types/fs-extra": "^11.0.4",
     "@types/jest": "^29.5.14",
     "@types/node": "^20",
     "@types/pg": "^8.15.5",
     "@types/react": "^19",
     "@types/react-dom": "^19",
+    "allure-cypress": "^3.4.4",
+    "cypress": "^15.8.2",
     "glob": "^11.0.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "@tailwindcss/cli": "^4",
     "tailwindcss": "^4",
-    "@types/fs-extra": "^11.0.4",
     "ts-jest": "^29.2.5",
     "tsup": "^8.5.1",
     "typescript": "^5"
   },
   "dependencies": {
-    "@inquirer/prompts": "^7.2.0",
-    "chalk": "^5.4.1",
-    "fs-extra": "^11.2.0",
-    "ora": "^8.1.1",
+    "@codemirror/lang-json": "^6.0.2",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@hookform/resolvers": "^5.2.1",
+    "@inquirer/prompts": "^7.2.0",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-avatar": "^1.1.10",
@@ -289,22 +373,31 @@
     "@radix-ui/react-toggle": "^1.1.10",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@shikijs/rehype": "^3.20.0",
+    "@tailwindcss/container-queries": "^0.1.1",
     "@tanstack/react-query": "^5.85.0",
     "@tanstack/react-query-devtools": "^5.85.0",
+    "@uiw/codemirror-theme-github": "^4.25.4",
+    "@uiw/react-codemirror": "^4.25.4",
+    "@upstash/ratelimit": "^2.0.3",
+    "@upstash/redis": "^1.20.6",
     "@vercel/blob": "^2.0.0",
     "better-auth": "^1.3.5",
+    "chalk": "^5.4.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "dotenv": "^17.2.2",
+    "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
     "lucide-react": "^0.539.0",
     "next-intl": "^4.3.4",
     "next-themes": "^0.4.6",
+    "ora": "^8.1.1",
     "pg": "^8.16.3",
     "react-day-picker": "^9.9.0",
     "react-hook-form": "^7.62.0",
+    "react-json-view-lite": "^2.5.0",
     "react-markdown": "^10.1.0",
     "rehype-stringify": "^10.0.1",
     "remark": "^15.0.1",
@@ -316,6 +409,19 @@
     "stripe": "^18.5.0",
     "tailwind-merge": "^3.3.1",
     "uuid": "^13.0.0",
-    "zod": "^4.1.5"
+    "zod": "^4.1.5",
+    "@nextsparkjs/testing": "0.1.0-beta.82",
+    "@nextsparkjs/ui": "0.1.0-beta.82"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs || true",
+    "build": "tsup && pnpm build:dts && pnpm build:ui-css",
+    "build:js": "tsup",
+    "build:dts": "tsc -p tsconfig.dts.json || echo '⚠️  DTS generation completed with some type errors (partial coverage)'",
+    "build:ui-css": "node scripts/build/build-ui-css.mjs",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
   }
-}
+}