@stacksjs/defaults 0.75.109 → 0.75.111

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

@@ -8,171 +8,80 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Stacks Types
 
-## Key Paths
-- Core types: `storage/framework/core/types/src/`
-- Generated types: `storage/framework/types/`
-- ORM globals: `storage/framework/types/orm-globals.d.ts`
-- Environment: `storage/framework/types/env.d.ts`
-- Actions: `storage/framework/types/actions.d.ts` (generated `ActionPath` union)
-- Model traits: `storage/framework/types/traits.d.ts`
-- Model attributes: `storage/framework/types/attributes.d.ts`
-- Events: `storage/framework/types/events.ts`
-- Attributes: `storage/framework/types/attributes.ts`
-
-## Authentication Types (auth.ts)
-
-```typescript
-interface AuthConfig {
-  default: string
-  guards: { [key: string]: { driver: 'session' | 'token', provider: string } }
-  providers: { [key: string]: { driver: 'database', table: string } }
-  username: string
-  password: string
-  tokenExpiry: number           // 30 days
-  tokenRotation?: number        // deprecated; rotate explicitly
-  defaultAbilities: string[]
-  defaultTokenName: string
-}
-```
-
-## ORM Global Types (orm-globals.d.ts)
-
-```typescript
-// Full database row — model attributes + system fields + FK columns
-type ModelRow<T> = { id: number, uuid: string, created_at: string, updated_at: string } & ModelAttributes<T>
-
-// Insertable data — all fields optional
-type NewModelData<T> = Partial<ModelAttributes<T>>
-
-// Updateable data — all fields optional
-type UpdateModelData<T> = Partial<ModelAttributes<T>>
-
-// Model-aware request — narrows field names to model's attributes
-interface RequestInstance<TModel> {
-  get(key: keyof TModel): any
-  all(): TModel
-  validate(): Promise<void>
-}
-```
-
-## Environment Types (env.d.ts)
-
-```typescript
-// Application
-APP_NAME, APP_ENV: 'local' | 'dev' | 'stage' | 'prod', APP_KEY, APP_URL, PORT, DEBUG
-
-// Database
-DB_CONNECTION: 'mysql' | 'sqlite' | 'postgres' | 'dynamodb'
-DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD
-
-// AWS
-AWS_ACCOUNT_ID, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION
-
-// Mail
-MAIL_MAILER: 'smtp' | 'mailgun' | 'ses' | 'postmark' | 'sendmail' | 'log'
-MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM_NAME, MAIL_FROM_ADDRESS
-
-// Search
-SEARCH_ENGINE_DRIVER: 'meilisearch' | 'algolia' | 'typesense'
-MEILISEARCH_HOST, MEILISEARCH_KEY
-
-// Frontend
-FRONTEND_APP_ENV: 'development' | 'staging' | 'production', FRONTEND_APP_URL
-```
-
-## Event Types (events.ts)
-
-All model CRUD events: `model:created`, `model:updated`, `model:deleted`
-
-- **Content**: author, post, page
-- **Core**: user, activity, campaign, comment, email-list, notification, social-post, subscription, tag
-- **Commerce (37 models)**: cart, cart-item, category, coupon, customer, order, order-item, payment, product, product-variant, review, shipping-method, shipping-rate, tax-rate, transaction, gift-card, license-key, and more
-
-All payloads are `Record<string, any>`.
-
-## Billing Types (billing.ts)
-
-```typescript
-interface TransactionHistory {
-  id?, uuid?, name, description?, amount, type, provider_id?, user_id?, paymentmethod_id?, created_at, updated_at?
-}
-
-interface PaymentMethod {
-  id?, uuid?, type, last_four, brand, exp_month, exp_year, is_default?, provider_id?, user_id?
-}
-
-interface Product {
-  id?, uuid?, name, key, unit_price?, status?, image?, provider_id?
-}
-
-interface Subscription {
-  id?, uuid?, type, provider_id, provider_status, provider_type, unit_price?, quantity?, trial_ends_at?, ends_at?, user_id?
-}
-```
-
-## Attribute Types (attributes.ts)
-
-200+ attribute definitions covering all models:
-
-| Category | Fields |
-|----------|--------|
-| Basic | name, slug, description, title, subject, content, body |
-| Dates | created_at, updated_at, published_at, scheduled_at, expires_at |
-| Commerce | unit_price, price, amount, tax_amount, discount_amount, total, currency |
-| User | email, password, phone, avatar, author_name, author_email |
-| Shipping | delivery_address, delivery_fee, region, countries |
-| Loyalty | loyalty_points_earned, loyalty_points_redeemed, points_required |
-| Analytics | views, conversions, clicks, reach, likes, shares |
-
-## Request Types (traits.d.ts)
-
-Auto-generated per model:
-
-```typescript
-interface PasskeysRequestType extends Request {
-  get(key: 'id' | 'cred_public_key' | 'user_id' | 'counter' | ...): any
-}
-
-interface CommentablesRequestType extends Request {
-  get(key: 'title' | 'body' | 'status' | 'commentables_id' | ...): any
-}
-```
-
-## Auto-Imported Globals
-
-### Framework Modules
-`Action`, `response`, `route`, `Router`, `schema`, `validate`, `slug`, `camelCase`, `pascalCase`, `snakeCase`, `kebabCase`, `titleCase`, `path`, `storage`, `log`, `handleError`, `Auth`, `register`
-
-### 60+ ORM Models (globally available)
-User, Team, Post, Page, Author, Comment, Product, Order, Cart, Customer, Coupon, Category, Tag, Payment, Subscription, Driver, ShippingRate, GiftCard, LicenseKey, Job, FailedJob, Error, Log, Notification, and many more.
-
-### stx components
-Components under `resources/components/` are resolved by the stx plugin and used directly in templates (`<Card />`) - no import, no global registration step. Editor metadata is generated into `storage/framework/core/web-types.json` and `custom-elements.json` by `buddy generate:web-types` / `generate:custom-data`. There is no `components.d.ts`.
-
-### Actions Type
-```typescript
-type ActionPath = 'Actions/LogAction' | 'Actions/HealthAction' | 'Actions/ExampleAction' | (string & {})
-```
-
-## CLI Types (cli.ts)
-
-```typescript
-interface CliOptions {
-  verbose?: boolean, silent?: boolean, quiet?: boolean
-  cwd?: string, background?: boolean, timeoutMs?: number, project?: string
-}
-
-interface CleanOptions extends CliOptions {}
-interface CommitOptions extends CliOptions {}
-interface FreshOptions extends CliOptions { dryRun?: boolean }
-```
-
-## Gotchas
-- **Types are auto-generated** — many files in `storage/framework/types/` are generated from model definitions
-- **ORM globals are truly global** — `ModelRow<T>`, `NewModelData<T>` available without imports
-- **RequestInstance is model-aware** — `.get()` and `.all()` narrowed to model's fields when typed
-- **Event payloads are untyped** — all `Record<string, any>`, not strongly typed per-model
-- **Env types augment Bun.env** — `Bun.env.DB_CONNECTION` is typed
-- **Attributes is a shared type** — 200+ fields covering ALL models, not per-model
-- **Router types auto-generated** — 130+ typed route definitions, regenerated when routes change
-- **Components.d.ts has 150+ entries** — globally registered, no imports needed
+Read the owning package's exported type before writing a parallel interface.
+`@stacksjs/types` contains shared config/model/request/provider contracts;
+`storage/framework/types/` contains app augmentations and generated registries.
+Ambient types are not proof of runtime globals.
+
+## Model and query types
+
+~~~ts
+import type { ModelRow, NewModelData, UpdateModelData } from '@stacksjs/orm'
+import { User } from '@stacksjs/orm'
+
+type UserRow = ModelRow<typeof User>
+type UserInsert = NewModelData<typeof User>
+type UserUpdate = UpdateModelData<typeof User>
+~~~
+
+ModelRow derives attributes, trait fields and relationship foreign keys from
+the actual model. It is not a universal row with uuid/timestamps always present.
+Use that inferred row instead of a legacy UserModel interface when custom
+columns matter. NewModelData/UpdateModelData follow their real exported definitions;
+do not assume every field is optional. Global compatibility aliases delegate to
+those package types in orm-globals.d.ts; explicit imports keep modules portable.
+
+DatabaseSchema augmentation and RowOf/TableName provide typed raw-table access.
+ModelRegistry/ModelNames derive model-name completion from the models barrel;
+empty registries may fall back to string until the app has generated its surface.
+See stacks-models/stacks-query-builder for relationships and query result kinds.
+
+## Requests, actions and registries
+
+RequestInstance<TFields, TParams> from @stacksjs/types describes enhanced incoming
+requests, with typed field access and string route params. The ambient
+RequestInstance<typeof Model> compatibility alias maps a model to its ModelRow;
+that generic is different from the package type's field generic.
+Read core/types/src/request.ts before annotating all/validate/file/rawBody calls.
+
+ActionPath, listener/middleware/job names and payload maps are generated from
+the same discovered app/default resources their resolvers use. Route/action
+helpers infer literal params; a name map is not a separately maintained count.
+For custom registry augmentation use the owning package's interface. There are
+no UserRequest/UserRequestModel runtime globals or a Model-suffix global variant.
+
+## Events and environment
+
+AppEvents is augmented on @stacksjs/events; auth and model events carry typed
+payloads. Model before-events carry model objects, after-events carry rows;
+the map is derived from models, not Record<string, any> for all events. Read
+stacks-events for completion and cancellation semantics.
+
+config/env.ts plus defineEnv is the schema and typing source for app variables.
+The env proxy is typed/coerced and values may be undefined. Bun.env/process.env
+hold raw environment strings; an old generated Bun.env augmentation is absent.
+Do not copy stale MAIL_MAILER/DB_CONNECTION enums into another declaration.
+Driver availability comes from config's capability registry, not a string union.
+Auth tokenExpiry is milliseconds; current configured defaults are in auth.ts,
+not a hard-coded thirty-day type comment. See stacks-env and stacks-auth.
+
+## Browser globals and component metadata
+
+STX runtime-attached names determine bare calls. The old browser manifest's
+ambient declaration can disagree with runtime; read stacks-auto-imports and
+stacks-composables. Imported modules need their own imports. Built-in names such
+as Error/Request are preserved; import conflicting models explicitly.
+
+Components resolve by the STX component pipeline, not a fabricated components.d.ts
+global list. Editor web-types/custom-elements metadata is separate from runtime
+components and package discovery. buddy generate and its typed registry commands
+refresh declared resources; it cannot conjure a missing runtime export.
+
+## Source and checks
+
+`storage/framework/core/types/src/index.ts` exports shared declarations;
+request.ts/model.ts/model-names.ts own those contracts.
+`storage/framework/types/orm-globals.d.ts`, env.d.ts, models.d.ts,
+model-events.d.ts and registries.d.ts connect application inference.
+Read stacks-auto-imports/stacks-build for generated-declaration and runtime-export
+checks. The types package no longer needs old Vite-only build/layout/SSG imports.

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

@@ -1,6 +1,6 @@
 ---
 name: stacks-ui
-description: Use when working with UI in a Stacks application - components, composables, reactivity (refs/watch/computed), Craft native components, Crosswind CSS, Crosswind utility framework, accessibility, or the STX templating engine. Covers @stacksjs/ui, @stacksjs/stx, and related UI tooling.
+description: Use when composing Stacks UI components, web fonts, pagination controls, accessibility, or choosing frontend primitives. Covers @stacksjs/ui, its components subpath, the STX component plugin, and native frontend skill discovery.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -8,239 +8,77 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Stacks UI
 
-## Design & anti-slop skills
-
-For premium, non-templated UI (layout, typography, color, motion) built on stx + Crosswind, reach for the design-taste skill family:
-- `stacks-design-taste` - flagship anti-slop frontend skill (brief inference, the three dials, layout/type/color discipline, strict pre-flight check)
-- Aesthetic presets: `stacks-design-soft`, `stacks-design-minimalist`, `stacks-design-brutalist`
-- `stacks-redesign` - audit-first upgrade of an existing UI; `stacks-design-output` - full-output enforcement (no placeholder or truncated components)
-- Image-first: `stacks-image-to-code`, plus reference-image generators `stacks-imagegen-web`, `stacks-imagegen-mobile`, `stacks-brandkit`
-
-## Key Paths
-- Core package: `storage/framework/core/ui/src/`
-- Components: `storage/framework/core/ui/src/components/`
-- UI config: `config/ui.ts` (Crosswind)
-- STX config: `config/ui.ts`
-- STX engine: `node_modules/@stacksjs/stx/`
-- Crosswind: `node_modules/@cwcss/crosswind/`
-- Editor metadata: `storage/framework/core/web-types.json`, `storage/framework/core/custom-elements.json`
-
-## Source Files
-```
-ui/src/
-├── index.ts              # Re-exports from @stacksjs/stx
-├── components.ts         # Component re-exports
-└── components/
-    ├── autocomplete.ts   # Combobox, ComboboxInput, ComboboxOption, ComboboxOptions
-    ├── disclosure.ts     # Disclosure, DisclosureButton, DisclosurePanel
-    ├── menu.ts           # Menu, MenuButton, MenuItem, MenuItems
-    ├── modal.ts          # Dialog, DialogDescription, DialogPanel, DialogTitle
-    ├── popover.ts        # Popover, PopoverButton, PopoverPanel
-    ├── radio-group.ts    # RadioGroup, RadioGroupLabel, RadioGroupOption
-    ├── select.ts         # Combobox-based select
-    ├── tabs.ts           # Tab, TabGroup, TabList, TabPanel, TabPanels
-    ├── toggle.ts         # Switch
-    └── transition.ts     # TransitionChild, TransitionRoot
-```
-
-## Headless Components
-
-```typescript
-import { Combobox, ComboboxInput, ComboboxOption, ComboboxOptions } from '@stacksjs/ui'
-import { Dialog, DialogDescription, DialogPanel, DialogTitle } from '@stacksjs/ui'
-import { Menu, MenuButton, MenuItem, MenuItems } from '@stacksjs/ui'
-import { Tab, TabGroup, TabList, TabPanel, TabPanels } from '@stacksjs/ui'
-import { Switch } from '@stacksjs/ui'
-import { TransitionChild, TransitionRoot } from '@stacksjs/ui'
-```
-
-## Craft Native Components
-
-Built-in components with native HTML fallbacks:
-
-| Component | Fallback | Key Props |
-|-----------|----------|-----------|
-| `craft-button` | `<button>` | variant (primary/secondary/outline) |
-| `craft-text-input` | `<input>` | placeholder, value, type, disabled |
-| `craft-textarea` | `<textarea>` | placeholder, value, rows |
-| `craft-checkbox` | `<input type="checkbox">` | checked, disabled, label |
-| `craft-select` | `<select>` | value, options, placeholder |
-| `craft-modal` | `<dialog>` | open, title, closable, size |
-| `craft-tabs` | `<div>` | activeTab, tabs |
-| `craft-table` | `<table>` | columns, rows, sortable, selectable |
-| `craft-card` | `<div>` | title, subtitle, variant |
-| `craft-alert` | `<div>` | variant, title, dismissible |
-| `craft-toast` | `<div>` | variant, duration, position |
-| `craft-tooltip` | `<span>` | content, position |
-| `craft-pagination` | `<nav>` | total, page, pageSize |
-| `craft-code-editor` | `<textarea>` | value, language, theme, lineNumbers |
-| `craft-date-picker` | `<input type="date">` | value, min, max, format |
-| `craft-color-picker` | `<input type="color">` | value, format |
-| `craft-badge` | `<span>` | variant, size |
-| `craft-avatar` | `<div>` | src, alt, size, fallback |
-| `craft-progress` | `<div>` | value, max, variant |
-| `craft-spinner` | `<div>` | size |
-| `craft-accordion` | `<details>` | open, title |
-| `craft-divider` | `<hr>` | orientation, variant |
-| `craft-breadcrumb` | `<nav>` | items, separator |
-| `craft-menu` | `<nav>` | items, orientation |
-| `craft-tree` | `<div>` | nodes, expandable, selectable |
-| `craft-list` | `<ul>` | items, selectable |
-| `craft-slider` | `<input type="range">` | value, min, max, step |
-| `craft-radio` | `<input type="radio">` | checked, name, value, label |
-| `craft-file-browser` | `<div>` | path, showHidden, selectable |
-
-## Reactivity System
-
-```typescript
-import { ref, namedRef, computed, watch } from '@stacksjs/stx'
-
-const count = ref(0)
-count.value = 5
-
-const doubled = computed(() => count.value * 2)
-
-const stop = watch(
-  () => count.value,
-  (newVal, oldVal) => console.log(`${oldVal} → ${newVal}`),
-  { immediate: false }
-)
-stop()  // cleanup
-```
-
-### Types
-```typescript
-interface Ref<T> { value: T | null, readonly current: T | null }
-
-interface ComponentInstance {
-  id: string, element: Element | null
-  mountHooks: LifecycleHook[], destroyHooks: CleanupFn[], updateHooks: LifecycleHook[]
-  refs: Map<string, Ref<any>>, watchers: Array<{ stop: () => void }>
-  isMounted: boolean
-}
-```
-
-## Lifecycle Hooks
-
-```typescript
-import { onMount, onDestroy, onUpdate } from '@stacksjs/stx'
-// Aliases: onMounted, onUnmounted, onUpdated
-
-onMount(() => {
-  console.log('mounted')
-  return () => console.log('cleanup')  // optional
-})
-onDestroy(() => console.log('destroyed'))
-onUpdate(() => console.log('updated'))
+Start with the package boundary. Templates use STX signals and Crosswind utilities;
+the CSS implementation in this checkout is `@stacksjs/ts-css/engine`. Read
+`stacks-stx` for template behavior, `stacks-composables` for browser delivery
+and reactive contracts, and `stacks-crosswind` for actual CSS configuration.
+For visually important work also read `stacks-design-taste` and the matching
+aesthetic skill. Native applications pair with `stacks-mobile` or
+`stacks-desktop`; admin pages pair with `stacks-dashboard`.
+
+## Package and component resolution
+
+- `@stacksjs/ui` exports `CssEngine`, `ui`, font helpers, and pagination
+  helpers. It does not re-export the STX engine or headless components.
+- Headless components are exported from `@stacksjs/ui/components`, forwarding
+  `@stacksjs/components`. Use that subpath for explicit TypeScript imports.
+- STX tags such as `<Button />` and `<Sidebar />` resolve through the plugin
+  in `config/ui.ts`, `storage/framework/defaults/stx-components-plugin.ts`.
+  Application `resources/components/` overrides are handled by STX. Plugin
+  roots contain the component library, framework defaults, then package roots.
+  Installed packages contribute additive roots through `packageComponentRoots()`;
+  inspect that resolver before changing precedence.
+- `STX_COMPONENTS_DIR` explicitly selects a library source directory. The
+  plugin otherwise tries a local STX development checkout and the installed
+  library. A missing component warning is a resolution problem, not proof
+  that a tag is a globally registered Vue component.
+
+```ts
+import { Dialog, DialogPanel, Switch, Tabs } from '@stacksjs/ui/components'
+import { renderFontHead, buildPageSequence, urlForPage } from '@stacksjs/ui'
 ```
 
-## Dependency Injection
+## Fonts
 
-```typescript
-import { provide, inject, createInjectionKey, withInjectionScope } from '@stacksjs/stx'
+`renderFontPreloads(fonts)`, `renderFontFaceCss(fonts)`, and
+`renderFontHead(fonts)` return HTML/CSS strings for a layout head.
+`FontEntry` carries family, src, format, weight, style, display, preload and
+unicodeRange. The default format is woff2, the default display is swap, and
+each entry preloads unless `preload: false` is set. Keep preload lists small.
+Own the list in application config; importing a helper does not load a font.
+Render these trusted helper outputs with STX raw HTML syntax, not escaped text.
 
-const ThemeKey = createInjectionKey<string>('theme')
-provide(ThemeKey, 'dark')
-const theme = inject(ThemeKey)             // 'dark'
-const theme = inject(ThemeKey, 'light')    // with default
-```
-
-## Browser Composables
-
-```typescript
-import {
-  useLocalStorage, useSessionStorage, useEventListener,
-  useClickOutside, useWindowSize, useMediaQuery,
-  usePrefersDark, useOnline
-} from '@stacksjs/stx'
-
-const { value, remove } = useLocalStorage('key', defaultValue)
-const { width, height } = useWindowSize()
-const isDark = usePrefersDark()
-const isOnline = useOnline()
-const cleanup = useClickOutside(elementRef, handler)
-```
-
-## Crosswind Configuration (config/ui.ts)
+## Pagination controls
 
-```typescript
-export default {
-  content: [
-    './resources/**/*.{html,js,ts,jsx,tsx,stx}',
-    './storage/framework/defaults/**/*.{html,js,ts,jsx,tsx,stx}',
-    './storage/framework/views/**/*.{html,js,ts,jsx,tsx,stx}',
-  ],
-  output: './storage/framework/assets/headwind.css',
-  minify: false,
-} satisfies CrosswindOptions
-```
-
-## STX Configuration (config/ui.ts)
-
-```typescript
-export default {
-  componentsDir: 'components',
-  layoutsDir: 'layouts',
-  partialsDir: 'partials',
-} satisfies StxOptions
-```
-
-### Full StxConfig
-```typescript
-interface StxConfig {
-  enabled: boolean, debug: boolean
-  templatesDir?, componentsDir, partialsDir, layoutsDir?, defaultLayout?
-  ssr?: boolean, cache?: boolean, cachePath: string
-  i18n?: Partial<I18nConfig>
-  webComponents?: Partial<WebComponentConfig>
-  streaming?: Partial<StreamingConfig>
-  hydration?: Partial<HydrationConfig>
-  a11y?: Partial<A11yConfig>
-  seo?: Partial<SeoFeatureConfig>
-  animation?: Partial<AnimationConfig>
-  markdown?: Partial<MarkdownConfig>
-  pwa?: Partial<PwaConfig>
-  strict?: boolean | StrictModeConfig
-}
-```
+Use the bundled `<Pagination>` component with canonical full, simple, or
+cursor paginator results. For a custom control:
 
-## Accessibility
+- `buildPageSequence(current, last, window?)` returns page numbers and ellipses.
+- `urlForPage(paginator, page)` preserves the existing URL's filter parameters.
+- `paginatorVariant(paginator)` selects full, simple, or cursor behavior.
 
-```typescript
-import { checkA11y, autoFixA11y, scanA11yIssues } from '@stacksjs/stx'
-
-const violations = await checkA11y(html, filePath)
-const result = autoFixA11y(html, config)
-const issues = await scanA11yIssues('./resources', { recursive: true })
-```
-
-```typescript
-interface A11yConfig {
-  enabled: boolean, addSrOnlyStyles: boolean
-  level: 'AA' | 'AAA', ignoreChecks?: string[], autoFix: boolean
-}
-```
-
-## Crosswind CSS Framework
-
-Utility-first CSS (like Tailwind), built into Stacks:
-
-```typescript
-import { buildCrosswindCSS, extractClassNames, generateCrosswindCSS } from '@stacksjs/stx'
-
-const css = await buildCrosswindCSS(cwd)
-const classNames = extractClassNames(htmlContent)
-```
-
-Features: theme config, 40+ variant modifiers, custom rules, shortcuts, attributify mode, bracket syntax, presets.
+Full pagination provides counts and page jumps. Simple/cursor results do not
+have a last page; render previous/next controls using their URLs/cursors.
+Outside a request, missing URL context is normal rather than a broken query.
 
 ## Gotchas
-- **@stacksjs/ui re-exports from @stacksjs/stx** — the UI package is thin, the engine is in STX
-- **Craft components use native fallbacks** — `preferNative: true` renders plain HTML
-- **Refs are not Vue refs** — similar API but custom reactive implementation
-- **Lifecycle hooks require component context** — must be called within `setupComponent()`
-- **Crosswind is not Tailwind** — Stacks' own CSS utility implementation
-- **Crosswind is the utility engine** — handles class extraction, CSS generation, purging
-- **STX is the templating engine** — handles `.stx` files, SSR, streaming, hydration
-- **Two CSS systems coexist** — Crosswind (config) and Crosswind (engine)
-- **150+ globally registered Vue components** — no imports needed
+
+- `config/ui.ts` configures STX topology; `config/css.ts` configures utilities.
+- Module-level STX `Ref` helpers and browser callable signals are distinct.
+  Prefer `state`, `derived`, and `effect` in templates. Imported TypeScript
+  modules explicitly import every binding they use.
+- Native components can have web fallbacks; verify the relevant platform
+  implementation rather than promising native parity from a component name.
+- Resolve Iconify classes through the existing icon pipeline; use semantic
+  controls, associated labels, keyboard behavior and reduced-motion signals.
+- A typecheck does not verify client delivery. Render and exercise the page.
+
+## Source and evidence
+
+Public boundaries: `core/ui/src/index.ts`, `core/ui/src/components.ts`,
+`core/ui/package.json`. Component plugin:
+`storage/framework/defaults/stx-components-plugin.ts`. Helpers:
+`core/ui/src/fonts.ts`, `core/ui/src/pagination.ts`. Retained tests:
+`core/ui/tests/fonts.test.ts`, `core/ui/tests/modal.test.ts`, and
+`tests/unit/default-component-names.test.ts` (all core paths are relative
+to `storage/framework/`).

package/ai/skills/stacks-unslop/NOTICE.md

@@ -0,0 +1,25 @@
+# Source and license
+
+- Upstream: [theclaymethod/unslop](https://github.com/theclaymethod/unslop).
+- Revision: [`17ed39c9d0b522f44190ff0c6233867eadee192a`](https://github.com/theclaymethod/unslop/tree/17ed39c9d0b522f44190ff0c6233867eadee192a).
+- Author in upstream skill metadata: claytonkim.
+- Skill version at that revision: 2.3.0.
+- Upstream declares `license: MIT` in
+  [SKILL.md](https://github.com/theclaymethod/unslop/blob/17ed39c9d0b522f44190ff0c6233867eadee192a/SKILL.md)
+  and "Licensed MIT" in the
+  [README](https://github.com/theclaymethod/unslop/blob/17ed39c9d0b522f44190ff0c6233867eadee192a/README.md#requirements-and-license).
+  That revision supplies no standalone license or copyright-notice file.
+
+Stacks adapts the core preservation contract, contextual pattern categories,
+cleanup and rewrite flows, teach and mimic voice-card workflows, and four
+presets. The namespaced entrypoint and references are maintained under Stacks'
+MIT license with credit to the upstream author.
+
+The adaptation uses qualitative agent review instead of upstream's Python
+scanners, machine voice profiles, private-transcript harvesting, model
+orchestration, and evaluation harness. It makes no claim of scanner parity,
+measured voice fidelity, automated preservation coverage, or benchmark results.
+Any future executable helper for this adaptation must use TypeScript and Bun.
+
+This snapshot is bundled locally. Installing or invoking the skill requires
+no upstream download, extra dependency, or runtime script.