@kubuild/components 0.2.0 → 0.3.0

package/dist/traits/common.d.ts

@@ -0,0 +1,8 @@
+import { ComponentTraitDefinition } from './types';
+/** `id` — a custom, document-unique identifier for the element. */
+export declare function idTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
+/** `title` — advisory title shown on hover / used as a fallback label. */
+export declare function titleTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
+/** `aria-label` — accessible name for elements without visible text. */
+export declare function ariaLabelTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
+//# sourceMappingURL=common.d.ts.map

package/dist/traits/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/traits/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAiB,MAAM,SAAS,CAAC;AAElE,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAY/F;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAYlG;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAYtG"}

package/dist/{traits.d.ts → traits/form.d.ts}

@@ -1,80 +1,6 @@
-/**
- * Trait metadata (STORA-210).
- *
- * A **trait** is a *functional* prop — it carries behavior, semantics, or
- * identity rather than pure visual styling. Examples: `href`, `target`, `alt`,
- * `title`, `placeholder`, `aria-label`, and a custom `id`.
- *
- * Traits are deliberately separated from styling concerns:
- * - Styling lives in `defaultStyles` (a `ResponsiveStyles` object) and is
- *   applied via the style abstraction, never as raw HTML attributes.
- * - Traits describe the *semantic/behavioral* surface of a component and map
- *   to real HTML attributes at render time (see `attribute`).
- *
- * This module defines the trait metadata shape plus a set of reusable trait
- * factories so every component definition can declare its traits with clear
- * data types and default values — satisfying STORA-210's acceptance criteria.
- */
-/** The primitive data types a trait value can take. */
-export type TraitType = 'string' | 'number' | 'boolean' | 'select';
-/** A constrained choice for `select`-typed traits. */
-export interface TraitOption {
-    label: string;
-    value: unknown;
-}
-/**
- * Logical grouping used to organize traits in an inspector UI. Kept as a
- * closed union so hosts can render a stable, ordered set of trait sections.
- */
-export type TraitGroup = 'link' | 'media' | 'form' | 'accessibility' | 'identity' | 'behavior' | 'semantic';
-/** Ordered display order for trait groups in an inspector. */
-export declare const TRAIT_GROUP_ORDER: TraitGroup[];
-/** Human-readable labels for each trait group. */
-export declare const TRAIT_GROUP_LABELS: Record<TraitGroup, string>;
-/**
- * Metadata describing a single functional trait on a component.
- *
- * `name` is the prop key on the node's `props` object; `attribute` is the HTML
- * attribute it maps to at render time (when they differ, e.g. `name` → `id`).
- */
-export interface ComponentTraitDefinition {
-    /** Prop key on the node's `props` object (e.g. `'href'`, `'alt'`). */
-    name: string;
-    /** Human-readable label shown in the inspector. */
-    label: string;
-    /** Data type of the trait value. */
-    type: TraitType;
-    /** Default value applied when the trait is not set. */
-    defaultValue?: unknown;
-    /** Constrained choices for `select`-typed traits. */
-    options?: TraitOption[];
-    /** Short description of the trait's purpose. */
-    description?: string;
-    /** The HTML attribute this trait maps to at render time (e.g. `'href'`). */
-    attribute?: string;
-    /** Whether the trait must be present for the component to be valid. */
-    required?: boolean;
-    /** Logical grouping for inspector organization. */
-    group?: TraitGroup;
-}
-/** Convenience alias for a list of trait definitions. */
-export type ComponentTraits = ComponentTraitDefinition[];
-/** `href` — the destination URL for links, buttons, and form actions. */
-export declare function hrefTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `target` — where the linked resource opens (`_self`, `_blank`, ...). */
-export declare function targetTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `rel` — relationship between the current document and the linked resource. */
-export declare function relTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `alt` — alternative text for media, required for accessibility. */
-export declare function altTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `title` — advisory title shown on hover / used as a fallback label. */
-export declare function titleTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
+import { ComponentTraitDefinition } from './types';
 /** `placeholder` — hint text shown inside an empty form control. */
 export declare function placeholderTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `aria-label` — accessible name for elements without visible text. */
-export declare function ariaLabelTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `id` — a custom, document-unique identifier for the element. */
-export declare function idTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `name` — the form field name submitted with the form data. */
 export declare function fieldNameTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `required` — whether the form field must be filled before submission. */
@@ -83,22 +9,6 @@ export declare function requiredTrait(overrides?: Partial<ComponentTraitDefiniti
 export declare function disabledTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `readOnly` — whether the control value can be changed by the user. */
 export declare function readOnlyTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `src` — the source URL for media (image, video). */
-export declare function srcTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `poster` — a preview image shown before a video plays. */
-export declare function posterTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `controls` — whether native media controls are shown. */
-export declare function controlsTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `autoplay` — whether media starts playing automatically. */
-export declare function autoplayTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `loop` — whether media restarts from the beginning when it ends. */
-export declare function loopTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `muted` — whether media starts with sound muted. */
-export declare function mutedTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `cite` — the source URL for a blockquote. */
-export declare function citeTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `loading` — native lazy/eager loading hint for images (STORA-213). */
-export declare function loadingTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `action` — the URL a form submits to. */
 export declare function actionTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `method` — the HTTP method a form uses to submit. */
@@ -113,12 +23,6 @@ export declare function defaultCheckedTrait(overrides?: Partial<ComponentTraitDe
 export declare function defaultValueTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `rows` — the visible number of lines in a textarea. */
 export declare function rowsTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `colSpan` — the number of columns a table cell spans. */
-export declare function colSpanTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `rowSpan` — the number of rows a table cell spans. */
-export declare function rowSpanTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/** `tag` — the semantic HTML tag a component renders as (e.g. `ul`/`ol`, `td`/`th`). */
-export declare function tagTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `type` — the input type of a form control (text, email, number, ...). */
 export declare function inputTypeTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `buttonType` — the button's form behavior (`button`, `submit`, `reset`). */
@@ -173,15 +77,4 @@ export declare function loadingTextTrait(overrides?: Partial<ComponentTraitDefin
 export declare function showSpinnerTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
 /** `autoDisableOnSubmit` — whether the submit button is automatically disabled during submission. */
 export declare function autoDisableOnSubmitTrait(overrides?: Partial<ComponentTraitDefinition>): ComponentTraitDefinition;
-/**
- * Sort a component's traits into a stable, inspector-friendly order:
- * identity first, then the remaining groups in `TRAIT_GROUP_ORDER`, with
- * ungrouped traits last. Preserves relative order within each group.
- */
-export declare function sortTraits(traits: ComponentTraits): ComponentTraits;
-/**
- * Collect the union of all trait names declared across a set of component
- * definitions. Useful for building a global trait catalog / search index.
- */
-export declare function collectTraitNames(traitsList: ComponentTraits[]): string[];
-//# sourceMappingURL=traits.d.ts.map
+//# sourceMappingURL=form.d.ts.map

package/dist/traits/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/traits/form.ts"],"names":[],"mappings":"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"}