@schandlergarcia/sf-web-components 1.9.65 → 1.9.66

package/.a4drules/skills/command-center-builder/charts-visualization.md

@@ -1,4 +1,4 @@
-## Charts & Visualizations (MANDATORY)
+## Charts & Visualizations
 
 **All charts, graphs, maps, and visualizations MUST use library components.** Never use Recharts, Chart.js, Nivo, or any third-party charting library. Never hand-roll SVG, canvas, or custom chart markup. The ONLY charting tools allowed are `D3Chart` (via `D3ChartTemplates` or a custom `renderChart` function) and `GeoMap`.
 

package/.a4drules/skills/command-center-builder/components-styling.md

@@ -55,7 +55,7 @@ Defined in `global.css` (`--color-brand-*` and `--color-engine-*`), available as
 
 Canonical: `"operational"`, `"degraded"`, `"outage"`, `"maintenance"`. Always show color + text label.
 
-## Dark Mode (MANDATORY)
+## Dark Mode
 
 Every visible element needs both light and dark styles. Library components handle this automatically — which is another reason to use them.
 

package/.a4drules/skills/command-center-builder/getting-started.md

@@ -1,8 +1,8 @@
-## STOP — READ BEFORE WRITING ANY CODE
+## Core Conventions
 
-**Every time you build a dashboard, you MUST follow these non-negotiable rules. Violations are the #1 cause of rejected dashboards.**
+The following conventions apply to all dashboard development in this project.
 
-1. **Actually write COMPLETE files to disk.** Use the file-writing tools to create `.tsx` files (NOT `.jsx`) in `src/pages/` and update `CommandCenter.tsx` to import your dashboard. This is a TypeScript project - all React components MUST use `.tsx` extension. **CRITICAL: Write the ENTIRE file from import statements through the closing brace `}` of the export statement. Do NOT stop mid-file, mid-function, or mid-line. Every JSX tag you open must be closed. Every string you open must be closed. Every className attribute must be complete.** If you only describe what you would build without creating the files, the dashboard will not render. Verify the files exist after writing them.
+1. **Write `.tsx` files** in `src/pages/` and update `CommandCenter.tsx` to import the dashboard. This is a TypeScript project — all React components use `.tsx` extension.
 
 2. **Use ONLY library components** from `@/components/library` for all cards, charts, tables, lists, and feeds. The library has 30+ components — there is no reason to hand-roll HTML. See the component table below.
 
@@ -14,11 +14,9 @@
 
 6. **Never `npm install` Salesforce packages.** The `@salesforce/*` packages are platform-provided via broken symlinks. They are stubbed in `src/stubs/` and aliased in `vite.config.ts`. Do not try to install them — they don't exist on npm. If you see a TypeScript error about `@salesforce/vite-plugin-webapp-experimental`, ignore it — the build still succeeds via `vite build` (the `tsc` error is in `vite.config.ts` which is handled separately by `tsconfig.node.json`).
 
-If your output violates any of these 6 rules, it will be rejected and you will need to redo the work.
+## Use Library Components — Not Hand-Rolled HTML Cards
 
-## CRITICAL: Use Library Components — Never Hand-Roll HTML Cards
-
-**This is the #1 mistake.** The component library (`@/components/library`) provides pre-built, themed, dark-mode-ready cards for every common dashboard need. You MUST use them instead of writing raw `<div>` cards with custom classes.
+The component library (`@/components/library`) provides pre-built, themed, dark-mode-ready cards for every common dashboard need. Use them instead of writing raw `<div>` cards with custom classes.
 
 ### Before writing ANY card-like UI, check this table:
 
@@ -34,7 +32,7 @@ If your output violates any of these 6 rules, it will be rejected and you will n
 | Text summary | `NarrativeSummary` / `SectionCard` | `<div>` with headings and paragraphs |
 | Alert / callout | `CalloutCard` | Custom banner div |
 
-**Every visible section of a dashboard should be a library component.** If you find yourself writing `<div className="bg-white border rounded-[10px] shadow-sm p-6">` with content inside, STOP — you are hand-rolling a card. Find the library component that fits.
+Every visible section of a dashboard should be a library component. If you're writing `<div className="bg-white border rounded-[10px] shadow-sm p-6">` with content inside, that's a hand-rolled card — use a library component instead.
 
 ### Correct example:
 
@@ -80,7 +78,7 @@ import { MetricCard, ListCard, ActivityCard, WidgetCard } from "@/components/lib
 </div>
 ```
 
-## Images (MANDATORY)
+## Images
 
 The only image allowed in dashboards is the **company logo**: `src/assets/images/engine_logo.png`. Import it as a module and use it where a logo is needed (nav header, branding, etc.).
 
@@ -104,7 +102,7 @@ import engineLogo from "@/assets/images/engine_logo.png";
 <div className="w-8 h-8 bg-black rounded" />  // placeholder box instead of logo
 ```
 
-## No Dashboard-Level Navigation (MANDATORY)
+## No Dashboard-Level Navigation
 
 Dashboard pages must NOT include their own `<nav>`, header bar, or top navigation of any kind. Navigation is handled by `appLayout.tsx`. The dashboard renders inside the app shell — adding a nav inside the dashboard creates a duplicate header, which is the most visually obvious mistake.
 

package/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.9.65] - 2026-04-01
+## [1.9.66] - 2026-04-01
 
 ### Fixed
 - **6 data bugs in engine-sample-data.js**:
@@ -19,20 +19,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Updated
 - **PRD (engine-command-center-prd.md)**:
   - Fixed "Sarah Chen" → "Priya Patel" in section 8c escalation example
-  - Updated section 13 build prompts
-- **Simplified .a4drules documentation** - Removed redundancy and contradictions:
-  - `features/engine-dashboard-rule.md` - Reduced from 310 to ~65 lines (non-negotiable constraints)
-  - `features/command-center-dashboard-rule.md` - Reduced from ~100 to ~30 lines (10 core constraints)
-  - `features/pre-code-checklist.md` - Reduced from 216 to ~25 lines (removed auto-load)
-  - `features/phase2-data-pattern.md` - Reduced from 167 to ~20 lines
-  - `skills/command-center-builder/SKILL.md` - Fixed map layout contradiction, removed validator
-  - `skills/command-center-builder/page-layout.md` - Fixed map layout contradiction
-  - `skills/command-center-builder/completion-checklist.md` - Replaced validator "MUST run" with "DO NOT run"
-  - `skills/command-center-builder/improved-build-process.md` - Reduced from 341 to ~30 lines
+  - Rewrote section 13 build prompts to sound natural (removed AI coaching language)
+- **Simplified .a4drules documentation** - Removed redundancy, contradictions, and AI coaching language:
+  - `features/engine-dashboard-rule.md` - Rewritten as "Project Conventions" (reduced from 310 to ~65 lines)
+  - `features/command-center-dashboard-rule.md` - Rewritten as slim conventions (~30 lines)
+  - `features/pre-code-checklist.md` - Rewritten as "Quick Reference" (~25 lines, removed auto-load)
+  - `features/phase2-data-pattern.md` - Rewritten as "Sample Data" documentation (~20 lines)
+  - `skills/command-center-builder/SKILL.md` - Fixed map contradiction, removed validator contradiction, removed AI coaching language
+  - `skills/command-center-builder/page-layout.md` - Fixed map contradiction, softened wiring language
+  - `skills/command-center-builder/completion-checklist.md` - Removed validator contradiction
+  - `skills/command-center-builder/improved-build-process.md` - Rewritten as methodology description (~30 lines)
+  - `skills/command-center-builder/getting-started.md` - Removed AI coaching language
+  - `skills/command-center-builder/components-styling.md` - Removed (MANDATORY) header
+  - `skills/command-center-builder/charts-visualization.md` - Removed (MANDATORY) header
   - `skills/command-center-project/SKILL.md` - Fixed file path contradiction (src/components/pages/ → src/pages/)
   - `skills/command-center-guide/SKILL.md` - Reduced from 270 to ~45 lines (simplified routing guide)
 
-**Context:** Streamlined documentation to eliminate confusion caused by scattered, contradictory guidance across multiple files.
+**Context:** Complete documentation overhaul to eliminate confusion from scattered, contradictory guidance. Removed prescriptive AI coaching language in favor of clear technical conventions.
+
+## [1.9.65] - 2026-04-01
+
+### Updated
+- **Documentation improvements** - Initial sync of changes from react-cursor-1 (incomplete, superseded by 1.9.66)
 
 ## [1.9.64] - 2026-04-01
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schandlergarcia/sf-web-components",
-  "version": "1.9.65",
+  "version": "1.9.66",
   "description": "Reusable Salesforce web components library with Tailwind CSS v4 and shadcn/ui",
   "type": "module",
   "main": "./dist/index.js",