pixelize-design-library 2.3.21 → 2.3.25

package/.cursor/modules/layout-navigation/MODULE.md

@@ -1,103 +0,0 @@
-# Layout & Navigation
-
-## Purpose
-
-Accordion, Breadcrumbs, NavigationBar, SideBar, Header, Drawer, FilterSidebar.
-
-## Key paths
-
-- `src/Components/Accordion/`, `Breadcrumbs/`, `NavigationBar/`, `SideBar/`, `Header/`, `Drawer/`, `FilterSidebar/`
-
-## Key rules
-
-- SideBar/Header have sub-`components/` folders
-- Used by crm-frontend, account-frontend sidebars
-
-## SideBar — responsive overlay (< lg / 992px)
-
-At/above `lg` the SideBar is unchanged: inline, sticky, with the collapse/mini-rail
-(`toggle`). Below `lg` it becomes a slide-in **overlay** above the content (it leaves
-layout flow, so content stays full-width — not shrunk):
-
-- `mobileOpen?: boolean` + `onMobileClose?: () => void` props drive the overlay. Wire
-  `mobileOpen` to the NavigationBar hamburger (`sideBarToggole` / `onSideBarToggole`).
-- Overlay is always expanded (collapse/mini-rail is desktop-only and hidden < lg). The
-  header's trailing control becomes a Close (X) instead of the collapse chevron.
-- Dismiss: backdrop scrim click, **Esc**, the Close button, or **swipe-left** on the
-  panel. Body scroll is locked while open; panel exposes `role="dialog"`/`aria-modal`.
-- NavigationBar hamburger now shows below `lg` (was `< md`); its panel icon is
-  state-aware (`PanelLeftClose` open / `PanelRightClose` closed).
-- The overlay panel has **square edges** (no border radius).
-- Overlay panel width = `OVERLAY_WIDTH` (**14.7rem** / 235px — a touch wider than the
-  inline expanded 13rem for touch), capped by `maxW: 88vw` on very small screens.
-
-Breakpoint, scrim/slide, and z-index are Chakra responsive props (no JS flash) when
-`mobileNav` is off; the breakpoint is read once via `useBreakpointValue({ base: true, lg: false })`.
-
-## SideBar — Hide/Show (mobile navbar on big screens)
-
-A footer **Hide/Show** toggle (next to Collapse) switches the navbar *presentation*
-between the docked desktop sidebar and the mobile-style overlay — at **any** width, so
-desktop users can get the full-screen content experience. It is a layout switch, **not**
-a close: toggling never hides the navigation.
-
-- `mobileNav?: boolean` forces overlay presentation regardless of breakpoint:
-  `overlay = (below lg) || mobileNav`. `onToggleMobileNav?: () => void` backs the
-  footer control (render the control only when provided).
-- Footer control: docked → segmented **Collapse | Hide**; desktop mobile-nav overlay →
-  **Show** (return to docked). Pure below-`lg` overlay shows no navbar-mode control.
-- Wire so entering mobile-nav also opens the overlay (sidebar stays visible) and leaving
-  docks it — see `App.tsx`. NavigationBar `forceSideBarToggle` shows the hamburger at all
-  widths while `mobileNav` is on.
-- Selecting a **leaf** menu item in overlay mode auto-closes the overlay (content returns
-  to full-screen); submenu **parents** only expand and do not close it.
-
-## Persisting sidebar choices — `useSidebarPrefs`
-
-Opt-in hook (`src/Hooks/useSidebarPrefs.ts`, exported from `index.ts`) that persists the
-user's **explicit** layout choices to `localStorage` so they survive reload/restart —
-without it, `mobileNav`/collapse reset to desktop default on every mount.
-
-- Persists `{ mobileNav, collapsed, mobileOpen }` so the sidebar restores to **exactly**
-  the same state on refresh / new session (mode, mini-rail, and whether the drawer is
-  open). It deliberately does **not** persist the `lg` breakpoint (viewport-driven, must
-  stay live).
-- SSR-safe (`typeof window` guards); corrupt/invalid stored values fall back to defaults
-  per field; `setItem` failures (private mode / quota) no-op without throwing.
-- API: state `{ mobileNav, collapsed, mobileOpen }`; setters `setMobileNav / setCollapsed
-  / setMobileOpen`; toggles `toggleMobileNav / toggleCollapsed / toggleMobileOpen`; plus
-  **composed handlers** `onToggleMobileNav` (flips navbar mode **and** syncs the drawer)
-  and `closeMobile`. Options: `storageKey` (default `pixelize:sidebar-prefs:v1`, versioned)
-  and `defaults`.
-- **Consumer adoption** — map the returned values straight onto `SideBar` + `NavBar`; the
-  composed handlers mean apps don't re-implement the navbar-mode/drawer behavior:
-
-  ```tsx
-  const sb = useSidebarPrefs();
-  <SideBar
-    toggle={sb.collapsed} changeToggle={sb.toggleCollapsed}
-    mobileNav={sb.mobileNav} onToggleMobileNav={sb.onToggleMobileNav}
-    mobileOpen={sb.mobileOpen} onMobileClose={sb.closeMobile}
-    /* ...menus, user, etc. */
-  />
-  <NavBar
-    sideBarToggole={sb.mobileOpen} onSideBarToggole={sb.toggleMobileOpen}
-    forceSideBarToggle={sb.mobileNav} /* ...nav props */
-  />
-  ```
-
-  Per-app override: pass `storageKey` if an app needs a separate persisted namespace.
-  See `App.tsx` for the live reference wiring.
-
-### Known gaps
-
-- `SecondaryBar` keeps its current side-by-side stacking inside the overlay — revisit if
-  it feels cramped on very narrow screens.
-- Consumer apps (crm/account/…) must pass `mobileOpen`/`onMobileClose` to adopt overlay
-  mode, and adopt `useSidebarPrefs` to get persistence; until then they get the unchanged
-  inline sidebar with non-persisted state.
-- Persisted `collapsed` can be transiently overridden by SideBar's existing "auto-collapse
-  when a secondary panel is active" effect — pre-existing behavior, not regressed.
-- Persisting `mobileOpen` means a real phone (`belowLg`) that was left with the drawer open
-  reloads with it open (covering content until a leaf tap auto-closes it). Accepted to honor
-  "restore exactly the same state"; revisit with a `belowLg` gate if it proves annoying.

package/.cursor/modules/overlays/MODULE.md

@@ -1,30 +0,0 @@
-# Overlays
-
-## Purpose
-
-Modal, AlertDialog, ToolTip / OverflowToolTip, Toaster (+ `useToaster` hook).
-
-## Key paths
-
-- `src/Components/Modal/`, `AlertDialog/`, `ToolTip/`, `Toaster/`
-
-## Key rules
-
-- **Toaster `showToast({ actions })`:** optional `actions?: (onClose) => ReactNode`
-  renders action buttons under the message (e.g. Jira-style "View" / "Copy link").
-  The render-prop receives the toast's own `onClose` so an action can dismiss it;
-  callers style the buttons with their app theme. Prefer this over a bespoke Chakra
-  `useToast` in a consumer app — a second `useToast` renders into a *different* toast
-  portal that a `Modal`'s overlay/focus-trap can hide, so the toast silently never
-  appears. The toast card slides in (framer tween), pulses the status icon once on
-  mount, and **pauses the auto-dismiss countdown on hover** so the user can read and
-  click an action before it dismisses.
-- Modal exports ModalHeader, ModalBody, ModalFooter subcomponents
-- **ToolTip `overflowOnly`:** pass `overflowOnly` to show the tooltip **only**
-  when the child text is actually truncated (ellipsis active) — no tooltip when
-  it fits. The child must be the single clamping element (e.g. `Text` with
-  `noOfLines`); its ref is managed internally. Works for single- and multi-line
-  clamps and combines with `isDisabled`. **`OverflowToolTip`** is sugar for
-  `<ToolTip overflowOnly>`. Powered by the `useIsTruncated` hook (see
-  `utils-hooks`). Inert unless `overflowOnly` is set — no measurement/observer
-  for ordinary tooltips, and it never measures on hover/scroll.

package/.cursor/modules/playground/MODULE.md

@@ -1,15 +0,0 @@
-# Playground
-
-## Purpose
-
-Vite dev playground — demo pages not published to npm.
-
-## Key paths
-
-- `src/Pages/` (49 demo files), `src/App.tsx`, `src/Layout.tsx`
-- `npm start` launches playground
-
-## Key rules
-
-- Demo API calls to dev.pixelizetech.com are playground-only
-- Not included in `dist/` publish output

package/.cursor/modules/table/MODULE.md

@@ -1,15 +0,0 @@
-# Table
-
-## Purpose
-
-Data table with virtualization, filters, pagination, column management.
-
-## Key paths
-
-- `src/Components/Table/`, `Table/components/`, `Table/settings/`, `Table/filters/`, `Table/hooks/`
-- Tests: `components/TableBody.virtualize.test.tsx`, `settings/ManageColumns.test.tsx`
-
-## Key rules
-
-- Core CRM list UI — high change frequency
-- `src/Utils/table.ts` helpers

package/.cursor/modules/theme/MODULE.md

@@ -1,15 +0,0 @@
-# Theme
-
-## Purpose
-
-Eight brand presets (Default, Dark, Emerald, Meadow, Radiant, Rosewood, Skyline, Slate), `useCustomTheme`, `withTheme` HOC, token builders.
-
-## Key paths
-
-- `src/Theme/`, `src/withTheme.tsx`
-- Export: `useCustomTheme`, `ThemesList`, `withTheme`
-
-## Key rules
-
-- Consumers wrap app with `withTheme`; use theme tokens not hardcoded colors
-- Chart colors from theme via `chartColorsFromTheme`

package/.cursor/modules/types-exports/MODULE.md

@@ -1,17 +0,0 @@
-# Types & Exports
-
-## Purpose
-
-Public API surface — semver-sensitive.
-
-## Key paths
-
-- `src/index.ts` (~80 value exports + typed Props groups for UserDetails, RolesPermission, CustomModulesTable, SignInActivityTable, OrganizationDetails)
-- `src/types/`
-- `src/withTheme.tsx`
-
-## Key rules
-
-- Every public component must be exported here
-- Breaking export changes require major version bump
-- Run `npm run build` after export changes

package/.cursor/modules/utility-ui/MODULE.md

@@ -1,15 +0,0 @@
-# Utility UI
-
-## Purpose
-
-Generic standalone UI helpers: CopyButton, ScrollToTop, LazyWrapper, MoreItems, EmptyState, PdfViewer, FilePreview, FieldSelectModal, ProfilePhotoViewer, StageProgress.
-
-## Key paths
-
-- `src/Components/CopyButton/`, `ScrollToTop/`, `LazyWrapper/`, `MoreItems/`, `EmptyState/`, `PdfViewer/`, `FilePreview/`, `FieldSelectModal/`, `ProfilePhotoViewer/`, `StageProgress/`
-
-## Key rules
-
-- FilePreview also exports `FilePreviewTrigger`; StageProgress also exports `StageItem` (StepperStage is internal)
-- LazyWrapper wraps lazy/Suspense loading; ScrollToTop is a scroll-position helper — keep them framework-agnostic (props in, events out)
-- Single-file components (CopyButton, ScrollToTop, LazyWrapper, PdfViewer, FieldSelectModal) have no colocated Props file — types are inline

package/.cursor/modules/utils-hooks/MODULE.md

@@ -1,23 +0,0 @@
-# Utils & Hooks
-
-## Purpose
-
-Shared utilities and hooks: debounce, table helpers, preferences, ref merging,
-truncation detection.
-
-## Key paths
-
-- `src/Utils/table.ts`, `src/Utils/mergeRefs.ts`, `src/Hooks/usePreferences.ts`,
-  `src/Hooks/useIsTruncated.ts`, `src/services/feedback.ts`
-
-## Key rules
-
-- `debounce` exported from index.ts
-- **`useIsTruncated(content?, enabled?)`** (exported) — returns `{ ref, isTruncated }`;
-  attach `ref` to a clamped element to detect real overflow (`scrollWidth/Height`
-  vs `clientWidth/Height`, single- and multi-line). Re-measures on mount, element
-  resize (`ResizeObserver`), and `content` change — never on hover/scroll. Pass
-  `enabled=false` to make it fully inert. Powers `ToolTip overflowOnly` (see
-  `overlays`).
-- **`mergeRefs(...refs)`** (internal) — combine a caller ref with an injected one
-  when cloning an element.

package/.cursor/pixelize-task-statusline.sh

@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-# Local status line only — never sent to the model. See .cursor/TASK-SETUP.md
-set -euo pipefail
-
-STATE_FILE="${HOME}/.cursor/pixelize-skill-session-state.json"
-
-payload=$(cat)
-dir=$(echo "$payload" | jq -r ".cwd // .workspace.current_dir // empty")
-session_id=$(echo "$payload" | jq -r ".session_id // empty")
-base=$(basename "$dir")
-
-show_no_skill_warning=false
-if [[ -n "$session_id" && -f "$STATE_FILE" ]]; then
-  if jq -e --arg id "$session_id" '.[$id].chatting_without_skill == true' "$STATE_FILE" >/dev/null 2>&1; then
-    show_no_skill_warning=true
-  fi
-fi
-
-case "$base" in
-  account-frontend|account-service)
-    line1="/ → task  (Account FE + BE)"
-    line2=""
-    ;;
-  crm-frontend|crm-service)
-    line1="/ → task  (this repo)"
-    line2="/ → crm-task  (CRM FE + BE)"
-    ;;
-  social-frontend|social-service)
-    line1="/ → task  (this repo)"
-    line2="/ → social-task  (Social FE + BE)"
-    ;;
-  tickets-frontend)
-    line1="/ → task  (this repo)"
-    line2="/ → tickets-task"
-    ;;
-  crm-mobile)
-    line1="/ → task  (this repo)"
-    line2="/ → crm-mobile-task"
-    ;;
-  Micro-Components)
-    line1="/ → task  (this repo)"
-    line2="/ → design-task"
-    ;;
-  hrms)
-    line1="/ → task  (this repo)"
-    line2="/ → hrms-task  (HRMS FE + BE)"
-    ;;
-  *)
-    line1="Open a Pixelize repo root for / → task"
-    line2=""
-    ;;
-esac
-
-if [[ "$show_no_skill_warning" == "true" ]]; then
-  echo -e "\033[1;33m\033[7m  ⚠  CHATTING WITHOUT TASK SKILL — use / menu  ⚠  \033[0m"
-  echo -e "\033[1;33m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m"
-fi
-
-echo -e "\033[1;33m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m"
-echo -e "\033[1;33m  FEATURE WORK → $line1\033[0m"
-if [ -n "$line2" ]; then
-  echo -e "\033[1;33m  Full pipeline → $line2\033[0m"
-fi
-echo -e "\033[1;33m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m"

package/.cursor/plans/current.md

@@ -1,12 +0,0 @@
-# Fix Kanban collapsed column reset on drag
-
-## Problem
-`collapsedColumns` is re-hydrated from stale `kanbanPreferencesJson` whenever `mergedColumns` changes (e.g. after drag when parent updates `data`).
-
-## Solution
-1. Hydrate `collapsedColumns` from preferences **once** (when prefs load and columns exist).
-2. On `mergedColumns` change, only **prune** keys for removed columns — never re-apply saved prefs.
-
-## Files
-- `src/Components/KanbanBoard/KanbanBoard.tsx`
-- `src/Components/KanbanBoard/KanbanBoard.test.tsx`

package/.cursor/rules

@@ -1,31 +0,0 @@
-## Session start
-- Always read CLAUDE.md before starting any task
-- Always read MODULE.md before touching a component family (`.cursor/modules/<domain>/MODULE.md`)
-- Read one similar existing component before implementing
-- Never invent a new pattern if one already exists
-
-## Implementation
-- Components live in `src/Components/<Name>/`
-- Public API via `src/index.ts` only
-- Demo pages in `src/Pages/` for playground — not published
-- Never add CRM/app-specific API calls to library components
-- Use theme tokens from `src/Theme/` — no hardcoded brand colors
-- Add Jest tests for new behavior (`*.test.tsx`)
-- Keep changes minimal — no scope creep
-
-## Output quality
-- Never create placeholder files unless explicitly asked
-- Never use fake data, lorem ipsum, example.com, or demo seeds
-- Never leave TODO comments — implement fully or report blocked
-- Production-ready components with loading/error states where applicable
-
-## Branch rules
-- Always branch from **develop** — never from main
-- Feature work: `feature/<domain>-<short-description>`
-- Bug fixes: `fix/<domain>-<short-description>`
-- Never commit directly to main
-
-## Commit rules
-- Never commit without explicit user confirmation
-- Never run git push under any condition
-- Never add Cursor co-author lines

package/.cursor/skills/task/SKILL.md

@@ -1,167 +0,0 @@
----
-name: task
-description: >-
-  Runs the Pixelize Design Library dev pipeline: task-plan → fe-impl → test-create → test-exec → review gate → commit. Use when the user invokes @task, /task, or requests component library delivery.
-disable-model-invocation: true
----
-
-# Task Pipeline — Pixelize Design Library
-
-Single library repo **Micro-Components** (`pixelize-design-library`). Module docs: `.cursor/modules/<domain>/MODULE.md`.
-
-Run phases in order. Do not skip unless user opts out.
-
-```
-- [ ] 1. Task plan       (agent: task-plan)
-- [ ] 2. Implementation  (agents: fe-impl + be-impl, parallel when both needed)
-- [ ] 3a. Test creation  (agent: test-create)
-- [ ] 3b. Test execution (agent: test-exec)
-- [ ] 4. Review gate     (orchestrator — show diff, wait for user)
-- [ ] 5. Commit          (orchestrator only)
-```
-
----
-
-## Before Starting
-
-1. Read CLAUDE.md
-2. Confirm user goal — feat / fix / refactor / chore
-3. Tell user which phases apply
-
----
-
-## Phase 1 — Task Plan
-
-Agent: task-plan → `.cursor/agents/task-plan.md`
-
-- Read `.cursor/modules/<domain>/MODULE.md` for touched component families
-- Plan saved to `.cursor/plans/current.md`
-- If current.md already exists — read it first, user may be resuming
-
-Gate: do not start phase 2 until plan has concrete tasks.
-
----
-
-## Phase 2 — Implementation
-
-| Plan says | Action |
-|-----------|--------|
-| Library only | Invoke fe-impl only |
-| Both | Rare — fe-impl + test agents |
-
-Pass `.cursor/plans/current.md` to each agent.
-
-If blocked mid-task:
-- Save progress to `.cursor/plans/blocked/<task-name>.md` with exact blocker details
-- Stop pipeline and report to user
-
-Gate: all required agents must report Done or Blocked before phase 3.
-
----
-
-## Phase 3 — Tests
-
-3a: test-create → `.cursor/agents/test-create.md`
-3b: test-exec → `.cursor/agents/test-exec.md`
-
-Jest: `npm test` from repo root.
-
-Gate: do not proceed to review if tests failed and not explicitly waived by user.
-
----
-
-## Phase 4 — Review Gate
-
-```bash
-git status
-git diff
-git diff --staged
-git log -5 --oneline
-```
-
-Run git status/diff. STOP and wait for user approval.
-
-```
-CHANGES READY TO COMMIT
-
-Backend:
-- path/to/file — what changed
-
-Frontend:
-- path/to/component — what changed
-
-Tests:
-- path/to/test — what it covers
-
-MODULE.md updates:
-- path/to/MODULE.md
-
-Excluded:
-- none
-```
-
-STOP. Wait for: "yes" / "commit" / "looks good" / "go ahead"
-
-
-## Phase 5 — Commit
-
-### Commit message format
-
-```
-<type>(<module>): <concise imperative title>
-
-Backend:
-- <specific change — file context>
-
-Frontend:
-- <specific change — file context>
-
-Tests:
-- <what is covered and where>
-
-Config:
-- <migrations, registry changes, config updates>
-```
-
-### Commit steps
-
-1. Scan diff — if .env or secrets found, warn user and ask if they want to include. Commit only on confirmation.
-2. git add relevant files — state any exclusions clearly
-3. git commit using HEREDOC — never add Cursor attribution lines
-4. If Cursor injects co-author lines — amend immediately if unpushed
-5. Verify: git status + git log -1 --format=full
-6. Show commit hash to user
-7. Move `.cursor/plans/current.md` → `.cursor/plans/done/<YYYY-MM-DD>-<title>.md`
-
-Never run git push under any condition.
-
-### Commit safety
-
-- Never --no-verify unless user explicitly requests
-- Never force-push any branch
-- Nothing staged → skip commit, report clearly
-
----
-
-## Final Report
-
-| Phase    | Status         | Notes                             |
-| -------- | -------------- | --------------------------------- |
-| 1 Plan   | done / skipped | saved to .cursor/plans/current.md |
-| 2 Impl   | fe / be / both | done / blocked                    |
-| 3 Tests  | create / exec  | pass / fail / blocked             |
-| 4 Review | approved       | confirmed by user                 |
-| 5 Commit | done / skipped | hash if committed                 |
-
----
-
-## User Opt-outs
-
-| User says     | Effect                                    |
-| ------------- | ----------------------------------------- |
-| "plan only"   | Stop after phase 1                        |
-| "no tests"    | Skip phase 3 — confirm with user first    |
-| "no commit"   | Stop after phase 4 review                 |
-| "commit only" | Phase 4+5 only — still show diff and wait |
-| "skip review" | Go straight to commit — confirm with user |
-

package/CLAUDE.md

@@ -1,122 +0,0 @@
-# Pixelize Design Library — Agent Guide
-
-Rules for AI assistants working in **Micro-Components** (npm: `pixelize-design-library`).
-
-## 1. App name and purpose
-
-**Pixelize Design Library** — shared React UI component library and theme system for all Pixelize frontends. Published to npm; local Vite playground demos components in `src/Pages/`.
-
-## 2. Stack
-
-| Layer         | Technology                          | Version        |
-| ------------- | ----------------------------------- | -------------- |
-| Framework     | React + TypeScript                  | 18.3.1 / 5.9.3 |
-| UI base       | Chakra UI + Emotion + Framer Motion | 2.8.2          |
-| Build         | `tsc` → `dist/` + CSS copy          | —              |
-| Dev           | Vite playground                     | 6.2.0          |
-| Styling       | Tailwind + global CSS               | 3.4.17         |
-| Tests         | Jest + Testing Library              | 29.7.0         |
-| Package       | `pixelize-design-library`           | 2.2.x          |
-
-Not a monorepo — single package, one `package.json`.
-
-## 3. Repo relationship
-
-| Repo / package              | Role                                              |
-| --------------------------- | ------------------------------------------------- |
-| **Micro-Components** (here) | Source of `pixelize-design-library` npm package   |
-| **crm-frontend**            | Consumer — `npm run pixelize` to update           |
-| **account-frontend**        | Consumer                                          |
-| **social-frontend**         | Consumer                                          |
-| **tickets-frontend**        | Consumer                                          |
-| **crm-mobile**              | Consumer (native-base overlap — check mobile)     |
-| **pixelize-authenticator**  | Companion auth UI package (separate repo)         |
-
-No backend API in this repo. Demo pages may call dev APIs for playground only.
-
-## 4. Folder structure (2 levels)
-
-```
-Micro-Components/
-├── package.json, tsconfig.json, vite.config.ts
-├── src/
-│   ├── index.ts              public exports (~80)
-│   ├── withTheme.tsx         HOC wrapper
-│   ├── Components/           73 component families
-│   ├── Theme/                8 brand presets + useCustomTheme
-│   ├── Pages/                49 Vite demo/playground pages
-│   ├── Utils/, Hooks/, services/, types/
-│   └── App.tsx, Layout.tsx   playground shell
-├── dist/                     publish output (gitignored)
-└── .cursor/modules/          MODULE.md per component domain (22 domains)
-```
-
-## 5. Dev commands
-
-```bash
-npm start              # Vite playground
-npm run build          # tsc + copy CSS → dist/
-npm test               # Jest
-npm run test:watch
-npm run remove         # strip dev artifacts from dist before publish
-npm run package        # version patch + build + publish
-```
-
-## 6. Module / component pattern
-
-Follow the **Table** or **KanbanBoard** pattern for complex components:
-
-| Step | Path |
-| ---- | ---- |
-| Component | `src/Components/<Name>/` |
-| Subcomponents | `src/Components/<Name>/Components/` or nested folders |
-| Props/types | `<Name>Props.ts` or colocated types |
-| Tests | `*.test.tsx` next to component |
-| Stories | `*.stories.tsx` (where present) |
-| Demo page | `src/Pages/<name>.tsx` |
-| Public export | add to `src/index.ts` |
-| Module doc | `.cursor/modules/<domain>/MODULE.md` |
-
-Read `.cursor/modules/<domain>/MODULE.md` before touching a component family.
-
-## 7. Publishing integration
-
-- **Exports:** every public component must be exported from `src/index.ts`
-- **Peers:** React 18, Chakra, Emotion — consumers install alongside library
-- **Build:** `npm run build` compiles to `dist/`; never edit `dist/` directly
-- **Version:** patch releases via `npm run package`; CI publishes on merge to `develop`
-- **Breaking changes:** require version bump + consumer update in frontends
-
-## 8. Checklist — adding a new component
-
-1. Read similar component + `.cursor/modules/<domain>/MODULE.md`
-2. Create `src/Components/<Name>/` with component + props
-3. Add demo page in `src/Pages/` if needed
-4. Export from `src/index.ts`
-5. Add Jest tests (`*.test.tsx`)
-6. Update `.cursor/modules/<domain>/MODULE.md`
-7. Verify playground: `npm start`
-8. After merge to develop: consumers run `npm run pixelize` in their frontend
-
-## 9. Do
-
-- Match existing Chakra + design token patterns in `src/Theme/`
-- Keep components framework-agnostic where possible (props in, events out)
-- Add tests for new behavior
-- Use `useCustomTheme` / theme tokens — no hardcoded brand colors
-- Branch from **feature/cursor-ai-setup** or **develop**
-
-## 10. Don't
-
-- Don't add app-specific business logic (CRM entities, API calls) to library components
-- Don't break existing exports without semver major bump
-- Don't edit `dist/` — always change `src/` and rebuild
-- Don't skip `index.ts` export for public components
-- Don't introduce a second component pattern without team agreement
-- Don't commit npm tokens or `.env` secrets
-
-## Task pipeline
-
-- **Feature work:** invoke via **`/` menu → `task`** (not by typing `/task` in the message).
-- Cross-repo: **`/ → design-task**`.
-- One-time status line + hook details: [.cursor/TASK-SETUP.md](.cursor/TASK-SETUP.md).