@signal9/era-ui 32.0.0 → 33.0.0

package/dist/docs/chip.md

@@ -1,20 +0,0 @@
-## Usage
-
-```svelte
-<script>
-	import { Chip } from '@signal9/era-ui/chip';
-
-	let tags = $state(['alpha', 'beta', 'gamma']);
-</script>
-
-{#each tags as tag}
-	<Chip ondismiss={() => (tags = tags.filter((t) => t !== tag))}>
-		{tag}
-	</Chip>
-{/each}
-```
-
-## Notes
-
-- Internal pointerdown/up events on the dismiss button are stopped from bubbling — this prevents accidental toggling when a Chip is nested inside a Select/Popover trigger.
-- Uses the `xxs` tier tokens (height, radius, inset). Part of the Badge/Chip/KV "tag" family.

package/dist/docs/component-docs-core.d.ts

@@ -1,8 +0,0 @@
-import type { ComponentEntry } from '../../routes/registry.js';
-import type { RootExport, SubExport } from './component-source-scanners.js';
-export interface ComponentDocSources {
-    rootExports: Record<string, RootExport>;
-    subExportsBySlug: Record<string, SubExport[]>;
-    svelteBySlug: Record<string, Record<string, string>>;
-}
-export declare function buildComponentDocFromSources(entry: ComponentEntry, sources: ComponentDocSources, appendix?: string): string;

package/dist/docs/component-docs-core.js

@@ -1,73 +0,0 @@
-import { importLine } from './consumer-import.js';
-import { extractProps } from './extract-props.js';
-export function buildComponentDocFromSources(entry, sources, appendix) {
-    const { slug, name, description } = entry;
-    const root = sources.rootExports[slug];
-    const lines = [`# ${name}`, '', description, ''];
-    if (!root) {
-        if (appendix) {
-            const trimmed = stripRedundantHeader(appendix).trim();
-            if (trimmed)
-                lines.push(trimmed, '');
-        }
-        return lines.join('\n');
-    }
-    lines.push('## Import', '', '```ts', importLine(root.kind, root.alias, slug), '```', '');
-    const subs = sources.subExportsBySlug[slug] ?? [];
-    const files = sources.svelteBySlug[slug] ?? {};
-    if (root.kind === 'namespace') {
-        lines.push('Composed from sub-components — compose explicitly at the call site:', '', ...subs.map((s) => `- \`${root.alias}.${s.name}\``), '');
-        for (const sub of subs) {
-            lines.push(`## ${root.alias}.${sub.name}`, '');
-            if (sub.source.kind === 'passthrough') {
-                lines.push(`Re-exports \`${sub.source.ref}\` directly — see [bits-ui docs](https://bits-ui.com) for its full API.`, '');
-                continue;
-            }
-            const spec = extractProps(files[sub.source.file] ?? '');
-            lines.push(...renderPropsSection(spec));
-        }
-    }
-    else {
-        const sub = subs.find((s) => s.source.kind === 'file');
-        const file = sub && sub.source.kind === 'file' ? sub.source.file : `${slug}.svelte`;
-        const spec = extractProps(files[file] ?? '');
-        lines.push('## Props', '');
-        lines.push(...renderPropsSection(spec));
-    }
-    if (appendix) {
-        const trimmed = stripRedundantHeader(appendix).trim();
-        if (trimmed)
-            lines.push(trimmed, '');
-    }
-    return lines.join('\n');
-}
-function renderPropsSection(spec) {
-    if (!spec)
-        return ['_Props could not be parsed from source._', ''];
-    const out = [];
-    for (const inh of spec.inherits) {
-        out.push(`Inherits all props from \`${inh}\`.`);
-    }
-    if (spec.inherits.length)
-        out.push('');
-    if (!spec.props.length) {
-        if (!spec.inherits.length)
-            out.push('_No wrapper-specific props._', '');
-        return out;
-    }
-    out.push('| Prop | Type | Default | Notes |');
-    out.push('|------|------|---------|-------|');
-    for (const p of spec.props) {
-        const notes = [p.bindable ? 'bindable' : '', p.description ?? ''].filter(Boolean).join(' — ');
-        out.push(`| \`${p.name}${p.optional ? '?' : ''}\` | ${fmtCode(p.type)} | ${p.default !== undefined ? fmtCode(p.default) : '—'} | ${notes || '—'} |`);
-    }
-    out.push('');
-    return out;
-}
-function fmtCode(s) {
-    const normalized = s.replace(/\s+/g, ' ').trim().replace(/\|/g, '\\|');
-    return `\`${normalized}\``;
-}
-function stripRedundantHeader(md) {
-    return md.replace(/^#\s+[^\n]+\n+/, '');
-}

package/dist/docs/component-docs.d.ts

@@ -1,2 +0,0 @@
-import type { ComponentEntry } from '../../routes/registry.js';
-export declare function buildComponentDoc(entry: ComponentEntry, appendix?: string): string;

package/dist/docs/component-docs.js

@@ -1,25 +0,0 @@
-import { buildComponentDocFromSources } from './component-docs-core.js';
-import { groupSvelteBySlug, parseAllSubExports, parseRootExports } from './component-source-scanners.js';
-const svelteSources = import.meta.glob('../ui/**/*.svelte', {
-    query: '?raw',
-    import: 'default',
-    eager: true
-});
-const componentIndexSources = import.meta.glob('../ui/*/index.ts', {
-    query: '?raw',
-    import: 'default',
-    eager: true
-});
-const rootIndexSources = import.meta.glob('../ui/index.ts', {
-    query: '?raw',
-    import: 'default',
-    eager: true
-});
-const sources = {
-    rootExports: parseRootExports(Object.values(rootIndexSources)[0] ?? ''),
-    subExportsBySlug: parseAllSubExports(componentIndexSources),
-    svelteBySlug: groupSvelteBySlug(svelteSources)
-};
-export function buildComponentDoc(entry, appendix) {
-    return buildComponentDocFromSources(entry, sources, appendix);
-}

package/dist/docs/component-source-scanners.d.ts

@@ -1,18 +0,0 @@
-export interface RootExport {
-    kind: 'named' | 'namespace';
-    alias: string;
-}
-export interface SubExport {
-    name: string;
-    source: {
-        kind: 'file';
-        file: string;
-    } | {
-        kind: 'passthrough';
-        ref: string;
-    };
-}
-export declare function parseRootExports(src: string): Record<string, RootExport>;
-export declare function parseAllSubExports(sources: Record<string, string>): Record<string, SubExport[]>;
-export declare function parseSubExports(src: string): SubExport[];
-export declare function groupSvelteBySlug(sources: Record<string, string>): Record<string, Record<string, string>>;

package/dist/docs/component-source-scanners.js

@@ -1,46 +0,0 @@
-export function parseRootExports(src) {
-    const out = {};
-    for (const m of src.matchAll(/export\s*\{\s*([\w]+)(?:\s+as\s+[\w]+)?\s*(?:,[^}]*)?\}\s*from\s*["']\.\/([^/"']+)\/index\.js["']/g)) {
-        out[m[2]] = { kind: 'named', alias: m[1] };
-    }
-    for (const m of src.matchAll(/export\s*\*\s*as\s*([\w]+)\s*from\s*["']\.\/([^/"']+)\/index\.js["']/g)) {
-        out[m[2]] = { kind: 'namespace', alias: m[1] };
-    }
-    return out;
-}
-export function parseAllSubExports(sources) {
-    const out = {};
-    for (const [path, src] of Object.entries(sources)) {
-        const m = path.match(/\/ui\/([^/]+)\/index\.ts$/);
-        if (!m)
-            continue;
-        out[m[1]] = parseSubExports(src);
-    }
-    return out;
-}
-export function parseSubExports(src) {
-    const out = [];
-    for (const m of src.matchAll(/export\s*\{\s*default\s+as\s+([\w]+)\s*\}\s*from\s*["']\.\/([^"']+\.svelte)["']/g)) {
-        out.push({ name: m[1], source: { kind: 'file', file: m[2] } });
-    }
-    for (const m of src.matchAll(/export\s+const\s+([\w]+)\s*=\s*([\w.]+)\s*;/g)) {
-        out.push({ name: m[1], source: { kind: 'passthrough', ref: m[2] } });
-    }
-    for (const m of src.matchAll(/export\s*\{\s*([\w]+)\s*\}\s*from\s*["']\.\/([^"']+\.svelte)["']/g)) {
-        out.push({ name: m[1], source: { kind: 'file', file: m[2] } });
-    }
-    for (const m of src.matchAll(/export\s*\{\s*default\s*\}\s*from\s*["']\.\/([^"']+\.svelte)["']/g)) {
-        out.push({ name: 'default', source: { kind: 'file', file: m[1] } });
-    }
-    return out;
-}
-export function groupSvelteBySlug(sources) {
-    const out = {};
-    for (const [path, src] of Object.entries(sources)) {
-        const m = path.match(/\/ui\/([^/]+)\/([^/]+\.svelte)$/);
-        if (!m)
-            continue;
-        (out[m[1]] ??= {})[m[2]] = src;
-    }
-    return out;
-}

package/dist/docs/consumer-import.d.ts

@@ -1,65 +0,0 @@
-/**
- * The import line a CONSUMER writes, and the two ways it has been wrong.
- *
- * WRONG ONCE (fixed in 12.1.1): the docs printed `$lib/ui/<slug>`, a SvelteKit
- * alias that resolves inside this repo and nowhere else.
- *
- * WRONG AGAIN, and this one survived that fix because it is a different
- * mistake: every component was documented with NAMED import syntax. That is
- * right for `export { Button }` and silently wrong for `export * as PinInput`,
- * where the component's own index exports `Root` and `Cell` and no `PinInput`
- * at all. `import { PinInput } from '@signal9/era-ui/pin-input'` therefore
- * type-checks, builds, and evaluates to `undefined` — it fails at RENDER, and
- * the docs are the only place a consumer could have learned otherwise.
- *
- * The shape is decided by how src/lib/ui/index.ts re-exports the component,
- * which is a barrel consumers cannot import — so the two spellings have to be
- * translated here rather than copied from it.
- *
- * npm's name deliberately: the package publishes under two names
- * (`@sig-nine/era-ui` on GitHub Packages, where the scope must match the repo
- * owner) and npm's is the one a reader can install without auth.
- *
- * Its own module, with no imports of its own, because the node doc builder
- * loads it through --experimental-strip-types — which cannot follow the `.js`
- * specifiers the rest of src/lib/docs uses.
- */
-export declare const PACKAGE = "@signal9/era-ui";
-/**
- * The install command WITH the pin, because npm's default fights era's cadence.
- *
- * `npm install @signal9/era-ui` writes a caret range. A caret still holds the
- * major — `^26.1.0` resolves `<27.0.0` — so it is not the open subscription to
- * the next breaking release it gets mistaken for. The real exposure is smaller
- * and sharper than that, and it is worse:
- *
- *   1. era's majors are not annual. Measured at 26.1.1: 132 releases in the
- *      preceding 30 days, 24 of them major. The protection a caret buys is
- *      about a day and a quarter of era time.
- *   2. Inside that window the minors and patches MOVE PIXELS. `fix(command): a
- *      row carries its OWN tier's radius` is a patch, and it changes what every
- *      command palette row looks like. For a library whose output is geometry
- *      there is no such thing as a rendering-neutral patch, so semver's promise
- *      — "patches are safe to float" — does not describe what era ships.
- *
- * So era's advice is to pin exact. This is that advice as the command that
- * PRODUCES the pin, rather than as a sentence printed next to a command that
- * does not: a reader who copies the snippet is pinned, whereas a reader given a
- * bare `npm install` and a note about `--save-exact` is pinned only if they
- * copied the prose too.
- *
- * Found by signalnine.org, which shipped a caret it never meant to and caught it
- * reading its own diff. Every other pin in that repo was exact and deliberate —
- * the docs had simply never said so, and the default quietly answered instead.
- */
-export declare const INSTALL = "npm install --save-exact @signal9/era-ui";
-/** How a component is re-exported by the internal barrel. */
-export type ImportKind = 'named' | 'namespace';
-/** The import statement, in the spelling that actually resolves. */
-export declare function importLine(kind: ImportKind, alias: string, slug: string): string;
-/**
- * The symbol a consumer must be able to reach, given the documented import.
- * For a namespace import that is nothing — `import * as X` always binds — so
- * only named imports can be checked against the component's own exports.
- */
-export declare function requiredExport(kind: ImportKind, alias: string): string | null;

package/dist/docs/consumer-import.js

@@ -1,70 +0,0 @@
-/**
- * The import line a CONSUMER writes, and the two ways it has been wrong.
- *
- * WRONG ONCE (fixed in 12.1.1): the docs printed `$lib/ui/<slug>`, a SvelteKit
- * alias that resolves inside this repo and nowhere else.
- *
- * WRONG AGAIN, and this one survived that fix because it is a different
- * mistake: every component was documented with NAMED import syntax. That is
- * right for `export { Button }` and silently wrong for `export * as PinInput`,
- * where the component's own index exports `Root` and `Cell` and no `PinInput`
- * at all. `import { PinInput } from '@signal9/era-ui/pin-input'` therefore
- * type-checks, builds, and evaluates to `undefined` — it fails at RENDER, and
- * the docs are the only place a consumer could have learned otherwise.
- *
- * The shape is decided by how src/lib/ui/index.ts re-exports the component,
- * which is a barrel consumers cannot import — so the two spellings have to be
- * translated here rather than copied from it.
- *
- * npm's name deliberately: the package publishes under two names
- * (`@sig-nine/era-ui` on GitHub Packages, where the scope must match the repo
- * owner) and npm's is the one a reader can install without auth.
- *
- * Its own module, with no imports of its own, because the node doc builder
- * loads it through --experimental-strip-types — which cannot follow the `.js`
- * specifiers the rest of src/lib/docs uses.
- */
-export const PACKAGE = '@signal9/era-ui';
-/**
- * The install command WITH the pin, because npm's default fights era's cadence.
- *
- * `npm install @signal9/era-ui` writes a caret range. A caret still holds the
- * major — `^26.1.0` resolves `<27.0.0` — so it is not the open subscription to
- * the next breaking release it gets mistaken for. The real exposure is smaller
- * and sharper than that, and it is worse:
- *
- *   1. era's majors are not annual. Measured at 26.1.1: 132 releases in the
- *      preceding 30 days, 24 of them major. The protection a caret buys is
- *      about a day and a quarter of era time.
- *   2. Inside that window the minors and patches MOVE PIXELS. `fix(command): a
- *      row carries its OWN tier's radius` is a patch, and it changes what every
- *      command palette row looks like. For a library whose output is geometry
- *      there is no such thing as a rendering-neutral patch, so semver's promise
- *      — "patches are safe to float" — does not describe what era ships.
- *
- * So era's advice is to pin exact. This is that advice as the command that
- * PRODUCES the pin, rather than as a sentence printed next to a command that
- * does not: a reader who copies the snippet is pinned, whereas a reader given a
- * bare `npm install` and a note about `--save-exact` is pinned only if they
- * copied the prose too.
- *
- * Found by signalnine.org, which shipped a caret it never meant to and caught it
- * reading its own diff. Every other pin in that repo was exact and deliberate —
- * the docs had simply never said so, and the default quietly answered instead.
- */
-export const INSTALL = `npm install --save-exact ${PACKAGE}`;
-/** The import statement, in the spelling that actually resolves. */
-export function importLine(kind, alias, slug) {
-    const spec = `"${PACKAGE}/${slug}"`;
-    return kind === 'namespace'
-        ? `import * as ${alias} from ${spec};`
-        : `import { ${alias} } from ${spec};`;
-}
-/**
- * The symbol a consumer must be able to reach, given the documented import.
- * For a namespace import that is nothing — `import * as X` always binds — so
- * only named imports can be checked against the component's own exports.
- */
-export function requiredExport(kind, alias) {
-    return kind === 'named' ? alias : null;
-}

package/dist/docs/css-utilities.d.ts

@@ -1,58 +0,0 @@
-export interface CssUtility {
-    /** Class name, e.g. `era-link` — the first of `names` for a ladder. */
-    name: string;
-    /**
-     * Every class the doc comment governs. Usually one; a scale documented as a
-     * run of consecutive `@utility` blocks under a single comment (h-icon … h-bar)
-     * lists the whole ladder.
-     */
-    names: string[];
-    /** Stylesheet the utility is declared in, relative to src/lib/styles. */
-    file: string;
-    /** One-line use case from the comment's `@use` line, if present. */
-    useCase?: string;
-    /** The rest of the doc comment — rationale, caveats, axis behaviour. */
-    description: string;
-    /** The `@utility` block verbatim, as authored. */
-    css: string;
-}
-/**
- * `@theme` namespace → the utility prefixes it generates.
- *
- * Half of era's public class API is registered this way rather than as
- * `@utility` blocks — `rounded-control` from `--radius-control`, `shadow-lg`,
- * `bg-highlight`, `text-body`, and the whole spacing scale. They are classes a
- * consumer writes exactly like the others, and until this table existed the
- * doc pipeline could not see any of them: `@utility` was the only thing it
- * parsed, so era's most-used names were also its least-documented.
- *
- * The list per namespace is the SPELLINGS WORTH DOCUMENTING, not everything
- * Tailwind derives — a spacing token really does generate `mt-`, `gap-x-`,
- * `inset-`, `translate-` and a dozen more, and printing all of them per name
- * would bury the point. The prose says the rest.
- */
-export declare const THEME_CLASS_PREFIXES: Record<string, string[]>;
-/** Every prefix a namespace really generates — the map the codemod needs. */
-export declare const THEME_ALL_PREFIXES: Record<string, string[]>;
-/**
- * The classes one `@theme` key generates, each with the utility PREFIX that
- * generated it — `--spacing-inset-control` → `{ prefix: 'px', name:
- * 'px-inset-control' }`. The prefix cannot be recovered from the name (both
- * `px` and `px-inset` are hyphen-splits of `px-inset-control`), and the codemod
- * matches on it, so it is returned rather than re-derived.
- */
-export declare function themeKeyClassEntries(themeKey: string, prefixes?: Record<string, string[]>): {
-    prefix: string;
-    name: string;
-}[];
-/** The class names one `@theme` key generates, e.g. `--radius-control` → `rounded-control`. */
-export declare function themeKeyClasses(themeKey: string, prefixes?: Record<string, string[]>): string[];
-/**
- * @param sources stylesheet text keyed by path relative to src/lib/styles
- *   (e.g. `index.css`, `surfaces/glass.css`).
- */
-export declare function parseUtilities(sources: Record<string, string>): CssUtility[];
-/** Renders the utilities reference — the generated `utilities.md` body. */
-export declare function buildUtilitiesDoc(utilities: CssUtility[]): string;
-/** One line per utility (or ladder) for llms.txt — plus its searchable use case. */
-export declare function buildUtilitiesIndex(utilities: CssUtility[]): string[];