@signal9/era-ui 26.1.0 → 27.0.0

package/skill/SKILL.md

@@ -181,10 +181,19 @@ a component into the role. Full reference (including every named scale above):
 
 ## Composing the library
 
+One entry point per component — nothing re-exports them together, so an import
+can never pull in a component you did not ask for. The ROOT is the system layer
+(`cn`, `tv`, the axis registry, `ModeProvider`) and holds no components.
+
 ```svelte
 <script lang="ts">
-	import { Button, Badge, OS, AI } from '@signal9/era-ui';
-	import * as Select from '@signal9/era-ui'; // namespaced parts: Select.Root…
+	import { Button } from '@signal9/era-ui/button';
+	import { Badge } from '@signal9/era-ui/badge';
+	import * as Select from '@signal9/era-ui/select'; // namespaced parts: Select.Root…
+	import { Desktop } from '@signal9/era-ui/os';
+	import { Conversation } from '@signal9/era-ui/ai/conversation';
+
+	import { cn } from '@signal9/era-ui'; // the root: system only
 </script>
 ```
 
@@ -192,8 +201,8 @@ a component into the role. Full reference (including every named scale above):
   through; style via `class` (merged with tailwind-merge, consumer wins — the
   named classes conflict-resolve against internals, so `class="h-bar"` on a
   control-tier control just works).
-- `OS` (or `@signal9/era-ui/os`): WindowManager + workspaces, Desktop,
-  Window, Taskbar (built-in command bar). `AI` (or `/ai`): Conversation,
+- `@signal9/era-ui/os`: WindowManager + workspaces, Desktop, Pane, Taskbar
+  (built-in command bar), Toaster. `@signal9/era-ui/ai/<part>`: Conversation,
   Message, Response, PromptInput, Tool/Reasoning/Task over the Step primitive.
 - List-item keyboard highlight is `data-[highlighted]:bg-hover` — never
   `hover:text-bright` on items.

package/dist/docs/llms-txt.d.ts

@@ -1,2 +0,0 @@
-export declare function buildLlmsTxt(origin?: string): string;
-export declare function buildLlmsFullTxt(): string;

package/dist/docs/llms-txt.js

@@ -1,100 +0,0 @@
-import { docs, hasDoc, listEntries } from './index.js';
-import { buildUtilitiesIndex } from './css-utilities.js';
-import { utilities } from './utilities.js';
-import { modes, defaultMode, surfaces, defaultSurface, corners, defaultCorners, fonts, defaultFont, motions, defaultMotion } from '../ui/provider/index.js';
-const H1 = '# era-ui';
-const MISSION = '> A Svelte 5 + Bits UI component library. Every surface — heights, paddings, radii, gaps — derives from a single spacing atom, so density is a one-attribute override at any scope.';
-function orientation(origin) {
-    const axisList = (arr, dflt) => arr.map((v) => (v === dflt ? `**${v}** (default)` : v)).join(' · ');
-    return [
-        '## Using the library',
-        '',
-        '```ts',
-        'import { Button, Table, Select } from "@signal9/era-ui";',
-        'import "@signal9/era-ui/css";',
-        '```',
-        '',
-        'Named exports wrap a single primitive (`Button`, `Badge`, `Chip`, `Input`, …). Namespace exports compose primitives via sub-components (`Table.Root`, `Table.Row`, `Select.Trigger`, `Dialog.Content`, …). Every wrapper forwards unknown props to its underlying element or bits-ui primitive, so standard HTML attributes (`class`, `style`, event handlers, `aria-*`, `data-*`) work without ceremony.',
-        '',
-        '## Scoped overrides',
-        '',
-        'Five orthogonal axes are exposed as HTML attributes on any ancestor. The entire subtree re-tiers through CSS inheritance — no JS, no context provider.',
-        '',
-        `- \`data-mode\`: ${axisList(modes, defaultMode)} — adjusts the spacing atom (\`--era-sp\`).`,
-        `- \`data-surface\`: ${axisList(surfaces, defaultSurface)} — swaps the background treatment.`,
-        `- \`data-corners\`: ${axisList(corners, defaultCorners)} — scales all radii toward 0.`,
-        `- \`data-font\`: ${axisList(fonts, defaultFont)} — switches the font stack.`,
-        `- \`data-motion\`: ${axisList(motions, defaultMotion)} — sets animation speed (\`--era-duration\` / \`--era-ease\`), independent of density.`,
-        '',
-        'The `Mode` component is a thin wrapper that applies these attributes plus optional `primary` / `primaryFg` color overrides to a subtree.',
-        '',
-        '## Spacing system',
-        '',
-        'One atom, `--era-sp` (8px dense / 10px balanced / 12px spacious), drives everything. The tier ladder is:',
-        '',
-        '```',
-        'xs   = sp + 6       icons, tight affordances        14 / 16 / 18 px',
-        'xxs  = sp + 10      nested pill (badge, chip)       18 / 20 / 22 px',
-        'sm   = 2·sp + 6     standalone pill (kv)            22 / 26 / 30 px',
-        'md   = 3·sp         buttons, inputs, triggers       24 / 30 / 36 px',
-        'lg   = 4·sp         bars, top-level containers      32 / 40 / 48 px',
-        '```',
-        '',
-        'Heights (`--era-h-*`), insets (`--era-inset-*`), radii (`--era-rd-*`), and concentric gaps (`--era-icon-inset-chip`, `--era-pill-inset-control`, …) are all `calc()` chains off `--era-sp`. Never hard-code pixel values — setting `data-mode` on any ancestor re-derives the whole subtree. Type is the second density input (12 px at dense, 14 px above); the spacing atom moves with it.',
-        '',
-        '## Per-component docs',
-        '',
-        `Every component has a passive markdown doc at \`${origin}/<slug>.md\`.`,
-        `Examples: \`${origin}/button.md\`, \`${origin}/select.md\`, \`${origin}/table.md\`.`,
-        `Full concatenated reference: \`${origin}/llms-full.txt\`.`,
-        '',
-        'Each page is generated from the component source, so props/variants/defaults stay in sync with the code automatically.'
-    ].join('\n');
-}
-function utilitiesSection(origin) {
-    return [
-        '## CSS utilities',
-        '',
-        'Classes, not components — they need no import beyond the stylesheet. Reach for one of these before hand-rolling the same styling or bending a component into the role.',
-        '',
-        ...buildUtilitiesIndex(utilities),
-        '',
-        `Full reference (what each emits, when to use it): \`${origin}/utilities.md\`. Machine-readable list: \`${origin}/utilities.json\`.`
-    ].join('\n');
-}
-export function buildLlmsTxt(origin = '') {
-    const entries = listEntries();
-    const lines = [H1, '', MISSION, '', orientation(origin), ''];
-    if (entries.length) {
-        lines.push('## Components', '');
-        lines.push(entries.map((e) => e.slug).join(', '), '');
-    }
-    lines.push(utilitiesSection(origin), '');
-    return lines.join('\n');
-}
-// Module-init-cached: the concatenated reference has no request-dependent
-// inputs, so we pay its ~80 KB assembly cost once per worker instance instead
-// of on every request.
-let llmsFullTxtCache;
-export function buildLlmsFullTxt() {
-    if (llmsFullTxtCache !== undefined)
-        return llmsFullTxtCache;
-    const entries = listEntries().filter((e) => hasDoc(e.slug));
-    const parts = [
-        H1,
-        '',
-        MISSION,
-        '',
-        orientation(''),
-        '',
-        utilitiesSection(''),
-        '',
-        '<!-- Full component documentation, concatenated. The utilities page below carries the CSS each utility emits. -->',
-        ''
-    ];
-    for (const e of entries) {
-        parts.push(`<!-- begin: ${e.slug} -->`, '', docs[e.slug].trim(), '', `<!-- end: ${e.slug} -->`, '');
-    }
-    llmsFullTxtCache = parts.join('\n');
-    return llmsFullTxtCache;
-}