@stacksjs/defaults 0.70.207 → 0.70.208

package/ai/skills/stacks-datetime/SKILL.md

@@ -0,0 +1,269 @@
+---
+name: stacks-datetime
+description: Use when working with dates and times in Stacks — the DateTime class with Carbon-like API (add/sub, comparison, formatting, start/end of day/month/year), date parsing, format tokens, or timezone handling. Covers @stacksjs/datetime.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Stacks DateTime
+
+Carbon-inspired DateTime class with immutable operations and zero external dependencies.
+
+## Key Paths
+- Core package: `storage/framework/core/datetime/src/`
+- Package: `@stacksjs/datetime`
+
+## Architecture
+
+The `index.ts` exports:
+```typescript
+export { DateTime, now } from './now'
+export { format } from './format'
+export { parse } from './parse'
+export { format as dateFormat } from './format'  // convenience alias
+```
+
+Three source files:
+- `now.ts` — `DateTime` class and `now()` helper
+- `format.ts` — standalone `format()` function with token-based formatting and timezone support
+- `parse.ts` — standalone `parse()` function with token-based parsing
+
+## DateTime Class (`now.ts`)
+
+### Construction
+```typescript
+import { DateTime, now } from '@stacksjs/datetime'
+
+const dt = new DateTime()                          // current time
+const dt = new DateTime(new Date())                // from native Date (cloned)
+const dt = new DateTime('2024-06-15')              // from date string
+const dt = new DateTime('15/06/2024', 'DD/MM/YYYY') // from string with format
+
+// Static factory methods
+const dt = DateTime.now()                          // current time
+const dt = DateTime.create(2024, 6, 15, 10, 30, 0) // year, month (1-12), day, hour, min, sec
+const dt = DateTime.fromDate(new Date())           // from native Date
+const dt = DateTime.parse('2024-06-15')            // from string
+const dt = DateTime.parse('15/06/2024', 'DD/MM/YYYY') // from string with format
+```
+
+Note: `DateTime.create()` uses 1-based months (1=January), converting internally with `month - 1`.
+
+### Getters (read-only properties)
+```typescript
+dt.year        // number -- full year (e.g. 2024)
+dt.month       // number -- 1-12 (1-based, NOT zero-based like native Date)
+dt.day         // number -- day of month (1-31)
+dt.hour        // number -- 0-23
+dt.minute      // number -- 0-59
+dt.second      // number -- 0-59
+dt.dayOfWeek   // number -- 0 (Sunday) through 6 (Saturday)
+dt.timestamp   // number -- milliseconds since Unix epoch
+```
+
+### Formatting
+```typescript
+dt.format('YYYY-MM-DD HH:mm:ss')           // '2024-06-15 10:30:00'
+dt.format('MMMM D, YYYY', 'en')            // 'June 15, 2024'
+dt.format('HH:mm', { locale: 'de', tz: 'Europe/Berlin' })
+
+dt.toDateString()                            // 'YYYY-MM-DD' format
+dt.toTimeString()                            // 'HH:mm:ss' format
+dt.toDateTimeString()                        // 'YYYY-MM-DD HH:mm:ss' format
+dt.toISOString()                             // ISO 8601 (native Date.toISOString)
+dt.toString()                                // same as toDateTimeString()
+dt.toJSON()                                  // same as toISOString()
+```
+
+### Format Tokens
+
+Used by both `DateTime.format()` and the standalone `format()` function:
+
+| Token | Output | Description |
+|-------|--------|-------------|
+| YYYY | 2024 | 4-digit year |
+| YY | 24 | 2-digit year |
+| MMMM | January | Full month name (via Intl.DateTimeFormat) |
+| MMM | Jan | Short month name (via Intl.DateTimeFormat) |
+| MM | 01 | 2-digit month (01-12) |
+| M | 1 | Month (1-12) |
+| DD | 01 | 2-digit day (01-31) |
+| D | 1 | Day (1-31) |
+| dddd | Wednesday | Full weekday name (via Intl.DateTimeFormat) |
+| ddd | Wed | Short weekday name (via Intl.DateTimeFormat) |
+| d | W | Narrow weekday (via Intl.DateTimeFormat) |
+| HH | 00 | 24-hour padded (00-23) |
+| H | 0 | 24-hour (0-23) |
+| hh | 12 | 12-hour padded (01-12) |
+| h | 12 | 12-hour (1-12) |
+| mm | 05 | Minutes padded (00-59) |
+| m | 5 | Minutes (0-59) |
+| ss | 09 | Seconds padded (00-59) |
+| s | 9 | Seconds (0-59) |
+| A | AM/PM | Uppercase AM/PM |
+| a | am/pm | Lowercase am/pm |
+| Z | +0530 | Timezone offset (no colon, e.g. +0800, -0500) |
+
+Tokens are matched longest-first to avoid partial matching.
+
+### Arithmetic (all return NEW DateTime instances -- immutable)
+```typescript
+dt.addSeconds(30)      dt.subSeconds(30)
+dt.addMinutes(15)      dt.subMinutes(15)
+dt.addHours(2)         dt.subHours(2)
+dt.addDays(7)          dt.subDays(7)
+dt.addWeeks(1)         dt.subWeeks(1)    // delegates to addDays(n * 7)
+dt.addMonths(3)        dt.subMonths(3)
+dt.addYears(1)         dt.subYears(1)
+```
+
+Implementation details:
+- `addSeconds/Minutes/Hours` use millisecond arithmetic on timestamp
+- `addDays` uses `Date.setDate()` (handles month boundaries correctly)
+- `addMonths` uses `Date.setMonth()` (handles year boundaries)
+- `addYears` uses `Date.setFullYear()`
+- All `sub*` methods delegate to `add*(-n)`
+
+### Period Boundaries (return NEW DateTime instances)
+```typescript
+dt.startOfDay()     // sets time to 00:00:00.000
+dt.endOfDay()       // sets time to 23:59:59.999
+
+dt.startOfMonth()   // sets to 1st of month, 00:00:00.000
+dt.endOfMonth()     // sets to last day of month, 23:59:59.999
+                    // uses new Date(year, month + 1, 0) trick for last day
+
+dt.startOfYear()    // January 1, 00:00:00.000
+dt.endOfYear()      // December 31, 23:59:59.999
+```
+
+### Setters (return NEW DateTime instances)
+```typescript
+dt.setYear(2025)     // new DateTime with year changed
+dt.setMonth(6)       // 1-based month (internally does month - 1)
+dt.setDay(15)        // uses Date.setDate()
+dt.setHour(10)
+dt.setMinute(30)
+dt.setSecond(0)
+```
+
+### Comparison
+```typescript
+dt.isBefore(other)         // true if this < other (millisecond comparison)
+dt.isAfter(other)          // true if this > other
+dt.isSame(other)           // true if exact same millisecond
+dt.isSameDay(other)        // true if same year, month, day (ignores time)
+dt.isBetween(start, end)   // true if this > start AND this < end (exclusive)
+dt.isPast()                // true if before Date.now()
+dt.isFuture()              // true if after Date.now()
+dt.isToday()               // true if same day as today (uses isSameDay)
+dt.isLeapYear()            // true if year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0)
+```
+
+All comparison methods accept `DateTime | Date` as the `other` parameter.
+
+### Difference
+```typescript
+dt.diffInSeconds(other)    // number -- Math.floor((this - other) / 1000)
+dt.diffInMinutes(other)    // number -- Math.floor(diffInSeconds / 60)
+dt.diffInHours(other)      // number -- Math.floor(diffInSeconds / 3600)
+dt.diffInDays(other)       // number -- Math.floor(diffInSeconds / 86400)
+```
+
+Returns signed values: positive if `this` is after `other`, negative if before.
+
+### Conversion
+```typescript
+dt.toNativeDate()          // new Date (cloned)
+dt.valueOf()               // number (milliseconds since epoch)
+dt.toJSON()                // ISO string (for JSON serialization)
+```
+
+## Standalone `format()` Function (`format.ts`)
+
+```typescript
+import { format } from '@stacksjs/datetime'
+
+format(new Date(), 'YYYY-MM-DD')                    // '2024-06-15'
+format('2024-06-15', 'MMMM D, YYYY')                // 'June 15, 2024'
+format(new Date(), 'dddd, MMMM D, YYYY h:mm A')     // 'Saturday, June 15, 2024 10:30 AM'
+
+// With locale
+format(new Date(), 'dddd, MMMM D', 'de')            // 'Samstag, Juni 15'
+
+// With timezone
+format(new Date(), 'YYYY-MM-DD HH:mm Z', { tz: 'America/New_York' })
+format(new Date(), 'HH:mm', { locale: 'en', tz: 'Asia/Tokyo' })
+```
+
+Signature: `format(inputDate: Date | string, formatStr?: string, localeOrOptions?: string | { locale?: string, tz?: string })`
+
+Default format string: `'YYYY-MM-DD'`
+Default locale: `'en'`
+
+### Timezone Support
+When a `tz` option is provided, the function uses `Intl.DateTimeFormat` with `timeZone` to extract date parts in the target timezone. The timezone offset (`Z` token) is computed by comparing UTC wall-clock time to the timezone's wall-clock time.
+
+Without `tz`, uses local time via native Date getters (faster path, no Intl overhead for numeric parts). Named parts (month names, weekday names) always use Intl for locale support.
+
+## Standalone `parse()` Function (`parse.ts`)
+
+```typescript
+import { parse } from '@stacksjs/datetime'
+
+// Without format string -- native Date parsing with fix
+parse('2024-06-15')                    // Date -- treated as LOCAL time (not UTC)
+parse('2024-06-15T10:30:00Z')          // Date -- ISO string, native parsing
+
+// With format string -- token-based extraction
+parse('15/06/2024', 'DD/MM/YYYY')      // Date
+parse('June 15, 2024', 'MMMM DD, YYYY') // Date
+parse('2024-06-15 10:30:00', 'YYYY-MM-DD HH:mm:ss')  // Date
+parse('03:30 PM', 'hh:mm A')          // Date with AM/PM handling
+parse('2024-06-15 10:30 +0530', 'YYYY-MM-DD HH:mm Z') // Date with timezone offset
+```
+
+### Parse Behavior
+
+**Without format string**:
+- Date-only ISO strings (YYYY-MM-DD) are parsed as LOCAL time, not UTC -- this is a deliberate fix for the native Date behavior where `new Date('2024-06-15')` treats it as UTC causing day shifts
+- All other strings use native `new Date()` parsing
+- Throws on invalid dates
+
+**With format string**:
+- Builds a regex from the format tokens and extracts named groups
+- Supports tokens: YYYY, YY, MMMM, MMM, MM, M, DD, D, HH, H, hh, h, mm, m, ss, s, A, a, Z
+- YY: years 70-99 become 1900s, 00-69 become 2000s
+- AM/PM: adjusts hours for 12-hour format (12 AM = 0, 12 PM = 12)
+- Month names: handles full ("January") and short ("Jan") names, case-insensitive
+- Z token: parses +HHMM offset, constructs UTC time and adjusts
+- Throws if the format doesn't match the input string
+
+## `now()` Helper
+
+```typescript
+import { now } from '@stacksjs/datetime'
+
+now()                                  // DateTime.now()
+now().toDateString()                   // '2024-06-15'
+now().format('MMMM D, YYYY')          // 'June 15, 2024'
+now().addDays(7).toDateString()        // one week from now
+now().startOfMonth().toDateString()    // first of current month
+```
+
+## Gotchas
+- All DateTime arithmetic operations return NEW instances -- the original is never mutated
+- `DateTime.month` returns 1-12 (1-based), NOT 0-11 like native Date
+- `DateTime.create(year, month)` takes 1-based month -- internally converts with `month - 1`
+- `dayOfWeek` returns 0 (Sunday) through 6 (Saturday) -- matches native Date.getDay()
+- `timestamp` returns MILLISECONDS since epoch, not seconds
+- `diffIn*` methods return signed values -- positive when `this` is after `other`
+- `isBetween(start, end)` is EXCLUSIVE on both ends (strictly between)
+- `parse('2024-06-15')` without format is treated as LOCAL time (intentional deviation from spec)
+- The `Z` timezone offset token format is `+HHMM` (no colon) -- e.g. `+0530`, `-0800`
+- `format()` with `tz` option uses `Intl.DateTimeFormat` which requires valid IANA timezone names
+- The `d` token in formatting returns the NARROW weekday (single letter like "W"), not a day number
+- `endOfMonth()` uses the `new Date(year, month + 1, 0)` trick to find the last day
+- Application timezone should be configured in `config/app.ts`
+- Prefer `@stacksjs/datetime` over raw `Date` for framework consistency

package/ai/skills/stacks-dependencies/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: stacks-dependencies
+description: Use when managing dependencies in a Stacks project — system dependencies via Pantry, Bun workspaces, buddy-bot updates, better-dx tooling, or dependency configuration. Covers config/deps.ts, Pantry, and workspace management.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Stacks Dependencies
+
+## Key Paths
+- Root: `package.json`
+- Deps config: `config/deps.ts`
+- Bun lock: `bun.lock`
+- Bun config: `bunfig.toml`
+
+## Pantry Configuration (config/deps.ts)
+
+```typescript
+import type { PantryConfig } from 'ts-pantry'
+
+interface PantryConfig {
+  dependencies: Record<string, string>   // System-level dependencies
+  global: boolean
+  services: {
+    enabled: boolean
+    autoStart: boolean
+    database: DatabaseConfig
+    postDatabaseSetup: string[]
+    frameworks: FrameworkConfig
+  }
+  preSetup: LifecycleHook
+  postSetup: LifecycleHook
+  preActivation: LifecycleHook
+  postActivation: LifecycleHook
+  cache: CacheConfig
+  network: NetworkConfig
+  security: SecurityConfig
+  logging: LoggingConfig
+  updates: UpdateConfig
+  resources: ResourceConfig
+  profiles: ProfileConfig
+  verbose: boolean
+  installPath: string
+  autoInstall: boolean
+  installDependencies: boolean
+  installBuildDeps: boolean
+}
+```
+
+### System Dependencies
+
+```typescript
+dependencies: {
+  bun: '1.3.0',
+  sqlite: '3.47.2',
+  redis: '7.0.0',
+  // ... other system-level requirements
+}
+```
+
+## Workspace Dependencies
+
+Core packages use `workspace:*` references:
+
+```json
+{
+  "@stacksjs/auth": "workspace:*",
+  "@stacksjs/database": "workspace:*",
+  "@stacksjs/router": "workspace:*"
+}
+```
+
+## Key Framework Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `better-dx` | Shared dev tooling (provides `typescript`, `pickier`, `bun-plugin-dtsx`) |
+| `bun-query-builder` | Database query building |
+| `@stacksjs/ts-auth` | Authentication library |
+| `@stacksjs/ts-cloud` | Cloud infrastructure (AWS CDK) |
+| `ts-rate-limiter` | Rate limiting |
+| `ts-collect` | Collection utilities |
+| `ts-mocker` | Fake data generation |
+| `ts-slug` | URL slug generation |
+
+## CLI Commands
+
+```bash
+buddy add <package>        # Add a dependency
+buddy install              # Install dependencies
+buddy outdated             # Check for outdated packages
+buddy fresh                # Clean + reinstall
+bun run upgrade            # Upgrade dependencies
+bun run build:reset        # Full reset: rm deps → reinstall → generate → lint → build
+```
+
+## Dependency Update System
+
+- **buddy-bot** handles dependency updates — NOT renovatebot
+- Automated PR creation for dependency updates
+- Configured via `config/buddy-bot.ts`
+
+## Gotchas
+- **buddy-bot, not renovatebot** — Stacks uses its own dependency update bot
+- **better-dx provides peer deps** — do NOT separately install `typescript`, `pickier`, or `bun-plugin-dtsx` if `better-dx` is present
+- **`bunfig.toml` requires `linker = "hoisted"`** when using `better-dx`
+- **Pantry manages system deps** — OS-level dependencies like SQLite, Redis, Bun itself
+- **Workspace references** — all `@stacksjs/*` packages use `workspace:*` in the monorepo
+- **`bun.lock` not `bun.lockb`** — Stacks uses the text-based lockfile format
+- **Build reset is destructive** — `bun run build:reset` removes all deps and reinstalls from scratch

package/ai/skills/stacks-deploy/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: stacks-deploy
+description: Use when deploying a Stacks application — the deployment workflow (build → deploy), pre/post deploy hooks, server vs serverless mode selection, first-time deployment setup, deployment troubleshooting, or the buddy deploy command. For cloud infrastructure details (EC2, Lambda, CloudFormation, Route53, IAM), see stacks-cloud.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript, AWS
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Stacks Deployment
+
+The deployment workflow for Stacks applications.
+
+## Quick Deploy
+
+```bash
+buddy deploy
+```
+
+## Deployment Prerequisites
+
+1. **AWS credentials configured**: `buddy configure:aws`
+2. **APP_KEY generated**: `buddy key:generate` (must be colon-separated format)
+3. **APP_URL set** in `.env`
+4. **Team configured** in `config/team.ts`
+
+## Deployment Flow
+
+1. **Validation** — checks APP_KEY format, AWS region, app URL, team config
+2. **Build** — compiles application for production
+3. **Infrastructure** — generates CloudFormation template via ts-cloud
+4. **Deploy** — creates or updates the CloudFormation stack
+   - Capabilities: CAPABILITY_IAM, CAPABILITY_NAMED_IAM
+   - OnFailure: ROLLBACK
+   - Tags: Environment, Project, ManagedBy
+
+## Deploy Hooks (cloud/deploy-script.ts)
+
+```typescript
+export default {
+  beforeDeploy({ environment, region }) {
+    // Build assets, run tests, send notifications
+    console.log(`Deploying to ${environment} in ${region}`)
+  },
+
+  afterDeploy({ environment, region, outputs }) {
+    // Cache warming, smoke tests, database seeding
+    console.log('Public IP:', outputs.PublicIp)
+    console.log('DNS:', outputs.DNS)
+    console.log('Endpoint:', outputs.Endpoint)
+  }
+}
+```
+
+## Deployment Modes
+
+### Server Mode (default)
+- EC2 instances with ALB
+- Best for: full-stack apps, WebSocket support, persistent connections
+- Config: `config/cloud.ts` → `mode: 'server'`
+
+### Serverless Mode
+- Lambda + API Gateway + CloudFront
+- Best for: API-only, cost optimization, auto-scaling
+- Config: `config/cloud.ts` → `mode: 'serverless'`
+
+## First Deployment Checklist
+
+```bash
+# 1. Configure AWS
+buddy configure:aws
+
+# 2. Generate app key
+buddy key:generate
+
+# 3. Set environment variables
+buddy env:set APP_URL https://myapp.com
+buddy env:set APP_ENV production
+
+# 4. Review cloud config
+# Edit config/cloud.ts
+
+# 5. Deploy
+buddy deploy
+```
+
+## CLI Commands
+
+```bash
+buddy deploy                  # deploy to cloud
+buddy cloud --diff            # preview infrastructure changes before deploying
+buddy cloud --ssh             # SSH into deployed server
+buddy cloud:remove            # tear down infrastructure
+buddy cloud:cleanup           # clean retained resources
+```
+
+## Gotchas
+- First deployment creates the CloudFormation stack — subsequent deploys update it
+- APP_KEY must be colon-separated format (validated during deployment)
+- Default region is `us-east-1` (from AWS_DEFAULT_REGION env)
+- `buddy cloud --diff` shows changes BEFORE deploying — always review first
+- Deploy hooks run in the deployment process, not on the target server
+- For infrastructure details (EC2, Lambda, VPC, etc.), see the `stacks-cloud` skill

package/ai/skills/stacks-design-brutalist/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: stacks-design-brutalist
+description: Use when a Stacks UI should feel industrial and brutalist - designing a data-heavy dashboard, portfolio, or editorial site that needs Swiss typography, sharp high contrast, rigid modular grids, monospace telemetry, and experimental analog-degradation effects. Composes with stacks-design-taste as an aesthetic preset built on stx + Crosswind + composables.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Industrial / Brutalist UI (Stacks)
+
+**Related skills:** refines [`stacks-design-taste`](../stacks-design-taste/SKILL.md) (the flagship anti-slop skill) with an industrial/brutalist preset. Build with [`stacks-stx`](../stacks-stx/SKILL.md) (semantic templating, signals), [`stacks-crosswind`](../stacks-crosswind/SKILL.md) (utilities, custom rules, `gap-px` grids), and [`stacks-ui`](../stacks-ui/SKILL.md) (Craft + headless components). Full composable reference: [`stacks-composables`](../stacks-composables/SKILL.md).
+
+## 1. Skill Meta
+Industrial brutalism and tactical telemetry interface engineering for Stacks apps. Advanced proficiency in architecting stx + Crosswind interfaces that synthesize mid-century Swiss typographic design, industrial manufacturing manuals, and retro-futuristic aerospace/military terminal interfaces. This discipline requires absolute mastery over rigid modular grids, extreme typographic scale contrast, purely utilitarian color palettes, and the programmatic simulation of analog degradation (halftones, CRT scanlines, bitmap dithering). The objective is digital environments that project raw functionality, mechanical precision, and high data density, deliberately discarding conventional consumer UI patterns.
+
+## 2. Visual Archetypes
+The system merges two distinct but highly compatible visual paradigms. **Pick ONE per project and commit to it. Do not alternate or mix both modes within the same interface.**
+
+### 2.1 Swiss Industrial Print
+Derived from 1960s corporate identity systems and heavy machinery blueprints.
+- **Characteristics:** High-contrast light modes (newsprint/off-white substrates). Reliance on monolithic, heavy sans-serif typography. Unforgiving structural grids outlined by visible dividing lines. Aggressive, asymmetric use of negative space punctuated by oversized, viewport-bleeding numerals or letterforms. Heavy use of primary red as an alert/accent color.
+
+### 2.2 Tactical Telemetry & CRT Terminal
+Derived from classified military databases, legacy mainframes, and aerospace Heads-Up Displays (HUDs).
+- **Characteristics:** Dark mode exclusivity. High-density tabular data presentation. Absolute dominance of monospaced typography. Integration of technical framing devices (ASCII brackets, crosshairs). Application of simulated hardware limitations (phosphor glow, scanlines, low bit-depth rendering).
+
+## 3. Typographic Architecture
+Typography is the primary structural and decorative infrastructure. Imagery is secondary. The system demands extreme variance in scale, weight, and spacing. Register font *choices* in the `fonts` config; load with `@font-face` / `<link>` + `font-display: swap` (never `next/font`).
+
+### 3.1 Macro-Typography (Structural Headers)
+- **Classification:** Neo-Grotesque / Heavy Sans-Serif.
+- **Optimal Web Fonts:** Neue Haas Grotesk (Black), Archivo Black, Roboto Flex (Heavy), Monument Extended.
+- **Implementation Parameters:**
+  - **Scale:** Deployed at massive scales using fluid typography (`clamp(4rem, 10vw, 15rem)`).
+  - **Tracking:** Extremely tight, often negative (`-0.03em` to `-0.06em`), forcing glyphs to form solid architectural blocks.
+  - **Leading:** Highly compressed (`0.85` to `0.95`).
+  - **Casing:** Exclusively uppercase for structural impact.
+
+### 3.2 Micro-Typography (Data & Telemetry)
+- **Classification:** Monospace / Technical Sans.
+- **Optimal Web Fonts:** JetBrains Mono, IBM Plex Mono, Space Mono, VT323, Courier Prime.
+- **Implementation Parameters:**
+  - **Scale:** Fixed and small (`10px` to `14px` / `0.7rem` to `0.875rem`).
+  - **Tracking:** Generous (`0.05em` to `0.1em`) to simulate mechanical typewriter spacing or terminal matrices.
+  - **Leading:** Standard to tight (`1.2` to `1.4`).
+  - **Casing:** Exclusively uppercase. Used for all metadata, navigation, unit IDs, and coordinates.
+
+### 3.3 Textural Contrast (Artistic Disruption)
+- **Classification:** High-Contrast Serif.
+- **Optimal Web Fonts:** Playfair Display, EB Garamond, Times New Roman.
+- **Implementation Parameters:** Used exceedingly sparingly. Must be subjected to heavy post-processing (halftone filters, 1-bit dithering) to degrade vector perfection and create textural juxtaposition against the clean sans-serifs.
+
+## 4. Color System
+The color architecture is uncompromising. Gradients, soft drop shadows, and modern translucency are strictly prohibited. Colors simulate physical media or primitive emissive displays.
+
+**CRITICAL: Choose ONE substrate palette per project and use it consistently. Never mix light and dark substrates within the same interface.** Expose these as Crosswind theme tokens in `config/ui.ts`.
+
+### If Swiss Industrial Print (Light)
+- **Background:** `#F4F4F0` or `#EAE8E3` (matte, unbleached documentation paper).
+- **Foreground:** `#050505` to `#111111` (carbon ink).
+- **Accent:** `#E61919` or `#FF2A2A` (aviation/hazard red). This is the ONLY accent color. Used for strike-throughs, thick structural dividing lines, or vital data highlights.
+
+### If Tactical Telemetry (Dark)
+- **Background:** `#0A0A0A` or `#121212` (deactivated CRT; avoid pure `#000000`).
+- **Foreground:** `#EAEAEA` (white phosphor). Primary text color.
+- **Accent:** `#E61919` or `#FF2A2A` (aviation/hazard red). Same red, same rules.
+- **Terminal Green (`#4AF626`):** Optional. Use ONLY for a single specific UI element (one status indicator or one data readout), never as a general text color. If it does not serve a clear purpose, omit it entirely.
+
+## 5. Layout and Spatial Engineering
+The layout must appear mathematically engineered. It rejects conventional web padding in favor of visible compartmentalization.
+- **The Blueprint Grid:** Strict adherence to CSS Grid architectures (`grid` utilities). Elements do not float; they anchor precisely to grid tracks and intersections.
+- **Visible Compartmentalization:** Extensive solid borders (`border` / `border-2 border-solid`) to delineate distinct zones. Horizontal rules (`<hr>`) frequently span the entire container width to segregate operational units.
+- **Bimodal Density:** Layouts oscillate between extreme data density (tightly packed monospace metadata) and vast expanses of calculated negative space framing macro-typography.
+- **Geometry:** Absolute rejection of `border-radius`. All corners must be exactly 90 degrees to enforce mechanical rigidity. Ban `rounded-*` utilities entirely.
+
+## 6. UI Components and Symbology
+Standard web UI conventions are replaced with utilitarian, industrial graphic elements.
+- **Syntax Decoration:** ASCII characters to frame data points.
+  - *Framing:* `[ DELIVERY SYSTEMS ]`, `< RE-IND >`
+  - *Directional:* `>>>`, `///`, `\\\\`
+- **Industrial Markers:** Prominent registration (`®`), copyright (`©`), and trademark (`™`) symbols functioning as structural geometric elements rather than legal text.
+- **Technical Assets:** Crosshairs (`+`) at grid intersections, repeating vertical lines (barcodes), thick horizontal warning stripes, and randomized string data (`REV 2.6`, `UNIT / D-01`) to simulate active mechanical processes.
+- **Icons:** When an icon is unavoidable, use Iconify `i-*` classes with a single sharp monoline collection; NEVER hand-roll SVG icon paths or `npm install` an icon library. Prefer ASCII/typographic symbology over decorative icons.
+
+```html
+<!-- resources/components/TelemetryRow.stx -->
+<div class="grid gap-px grid-cols-4 bg-[#E61919]">
+  <dl class="p-3 font-mono text-[#EAEAEA] text-[11px] tracking-[0.08em] uppercase bg-[#0A0A0A]">
+    <dt class="text-[#E61919]">[ UNIT ID ]</dt>
+    <dd><output>D-01</output></dd>
+  </dl>
+  <dl class="p-3 font-mono text-[#EAEAEA] text-[11px] tracking-[0.08em] uppercase bg-[#0A0A0A]">
+    <dt class="text-[#E61919]">[ REV ]</dt>
+    <dd><samp>2.6</samp></dd>
+  </dl>
+</div>
+```
+
+## 7. Textural and Post-Processing Effects
+To prevent a purely digital look, simulated analog degradation is engineered into the frontend via CSS and SVG filters (in the `.stx` `<style>` block, no external libraries).
+- **Halftone and 1-Bit Dithering:** Transform continuous-tone images or large serif typography into dot-matrix patterns via pre-processing or CSS `mix-blend-mode: multiply` overlays combined with SVG radial dot patterns.
+- **CRT Scanlines:** For terminal interfaces, apply a `repeating-linear-gradient` to simulate horizontal electron beam sweeps (`repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.1) 2px, rgba(0,0,0,0.1) 4px)`).
+- **Mechanical Noise:** A global, low-opacity SVG static/noise filter applied to the DOM root to introduce a unified physical grain across both dark and light modes. Attach to a `position: fixed; pointer-events: none` layer, never a scrolling container.
+
+## 8. Web Engineering Directives
+1. **Grid Determinism:** Use `display: grid; gap: 1px;` (`grid gap-px`) with contrasting parent/child background colors to generate mathematically perfect, razor-thin dividing lines without complex border declarations.
+2. **Semantic Rigidity:** Construct the DOM with precise semantic tags (`<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`) to accurately reflect the technical nature of the telemetry. This aligns with stx's div-soup ban; use real semantic elements.
+3. **Typography Clamping:** Use CSS `clamp()` exclusively for macro-typography so massive text scales aggressively while maintaining structural integrity across viewports.
+4. **Motion (if any):** Stacks ships no animation library; do NOT import `motion`, `gsap`, or `framer-motion`. Keep motion mechanical and minimal via Crosswind transitions and CSS keyframes. For any scroll-triggered reveal use `useIntersectionObserver(target, cb)`; NEVER `window.addEventListener('scroll', ...)`. Animate only `transform` and `opacity`. No `var`/`document.*`/`window.*` in stx scripts. Gate motion with `@media (prefers-reduced-motion: reduce)` and/or `useMediaQuery('(prefers-reduced-motion: reduce)')`.
+5. **Output:** Ship complete stx files, never a skeleton or placeholder comment.