@sky.ui/core 0.0.1

package/dist/helper/internals/form-control-base.d.ts

@@ -0,0 +1,81 @@
+import { LitElement } from "lit";
+export type FormState = string | File | FormData | null | string;
+export declare abstract class FormControlBase extends LitElement {
+    /** Enables form-associated custom element behavior */
+    static formAssociated: boolean;
+    protected internals: ElementInternals;
+    protected defaultValue: string;
+    /** Native form attributes you’ll reuse everywhere */
+    name: string;
+    formId: string | null;
+    disabled: boolean;
+    readonly: boolean;
+    required: boolean;
+    requiredMessage: string;
+    constructor();
+    get form(): HTMLFormElement | null;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    formStateRestoreCallback(state: FormState): void;
+    /** Must return current “submission value” (string/file/formdata) */
+    protected abstract getFormValue(): FormState;
+    /** Must set the component state from restored state (usually string) */
+    protected abstract setValueFromFormState(state: FormState): void;
+    /** Must return the internal focusable control to anchor validity bubbles */
+    protected abstract getValidityAnchor(): HTMLElement | undefined;
+    /** Must return true if empty (for required) */
+    protected abstract isEmpty(): boolean;
+    /** ✅ Must return the native control you want to proxy to (input/textarea/select/...) */
+    protected abstract getNativeControl(): HTMLElement | null;
+    /** Optional: return first custom error message (or empty string) */
+    protected getCustomErrorMessage(): string;
+    protected validateForForm(): string;
+    /** Optional: reset component to default */
+    protected onFormReset(): void;
+    /** Optional: react to fieldset disabled */
+    protected onFormDisabled(_disabled: boolean): void;
+    /** Optional: handle BFCache restore */
+    protected onFormStateRestore(state: FormState): void;
+    /**
+     * ✅ Called by base after a proxy method mutates the native control.
+     * Subclasses should pull native.value into their state and optionally validate.
+     */
+    protected onNativeValueMutated(_native: any): void;
+    protected syncFormValue(): void;
+    protected syncValidity(): void;
+    protected reemitNativeEvent(type: string, originalEvent: Event, init?: Partial<EventInit> & {
+        detail?: any;
+    }): void;
+    /** Call once after initial render */
+    protected captureDefaultValue(initial: string): void;
+    protected get nativeControl(): any | null;
+    protected get nativeInput(): HTMLInputElement | null;
+    protected get nativeTextarea(): HTMLTextAreaElement | null;
+    /** Central sync after proxy calls */
+    protected syncFromNative(runValidity?: boolean): void;
+    focus(options?: FocusOptions): void;
+    blur(): void;
+    click(): void;
+    showPicker(): boolean;
+    protected getSelectionTarget(): HTMLInputElement | HTMLTextAreaElement | null;
+    get selectionStart(): number | null;
+    set selectionStart(v: number | null);
+    get selectionEnd(): number | null;
+    set selectionEnd(v: number | null);
+    get selectionDirection(): "forward" | "backward" | "none" | null;
+    select(): void;
+    setSelectionRange(start: number, end: number, direction?: "forward" | "backward" | "none"): void;
+    setRangeText(replacement: string, start?: number, end?: number, selectionMode?: "select" | "start" | "end" | "preserve"): void;
+    get valueAsNumber(): number;
+    set valueAsNumber(v: number);
+    get valueAsDate(): Date | null;
+    set valueAsDate(v: Date | null);
+    stepUp(n?: number): void;
+    stepDown(n?: number): void;
+    setCustomValidity(message: string): void;
+}

package/dist/helper/internals/form-control-base.js

@@ -0,0 +1,2 @@
+import{__decorate as t,__metadata as e}from"tslib";import{LitElement as i}from"lit";import{property as s}from"lit/decorators.js";class n extends i{static{this.formAssociated=!0}constructor(){if(super(),this.defaultValue="",this.name="",this.formId=null,this.disabled=!1,this.readonly=!1,this.required=!1,this.requiredMessage="This field is required.","function"!=typeof this.attachInternals)throw new Error("ElementInternals / form-associated custom elements not supported in this browser.");this.internals=this.attachInternals()}get form(){return this.internals.form}get validity(){return this.internals.validity}get validationMessage(){return this.internals.validationMessage}get willValidate(){return this.internals.willValidate}checkValidity(){return this.internals.checkValidity()}reportValidity(){return this.internals.reportValidity()}formResetCallback(){this.onFormReset(),this.syncFormValue(),this.syncValidity()}formDisabledCallback(t){this.disabled=t,this.onFormDisabled(t),this.syncValidity()}formStateRestoreCallback(t){this.onFormStateRestore(t),this.syncFormValue(),this.syncValidity()}getCustomErrorMessage(){return""}validateForForm(){return""}onFormReset(){this.setValueFromFormState(this.defaultValue)}onFormDisabled(t){}onFormStateRestore(t){this.setValueFromFormState(t)}onNativeValueMutated(t){}syncFormValue(){if(!this.name||this.disabled)return void this.internals.setFormValue(null);const t=this.getFormValue();null!==t?this.internals.setFormValue(t):this.internals.setFormValue(null)}syncValidity(){if(this.disabled)return void this.internals.setValidity({});if(this.required&&this.isEmpty())return void this.internals.setValidity({valueMissing:!0},this.requiredMessage||"This field is required.",this.getValidityAnchor());const t=this.validateForForm();t?this.internals.setValidity({customError:!0},t,this.getValidityAnchor()):this.internals.setValidity({})}reemitNativeEvent(t,e,i){const s={bubbles:!0,composed:!0,cancelable:!!["submit"].includes(t)},n=void 0!==i?.detail?new CustomEvent(t,{...s,...i}):new Event(t,{...s,...i});n.__originalEvent=e,this.dispatchEvent(n)}captureDefaultValue(t){this.defaultValue=t??""}get nativeControl(){return this.getNativeControl()}get nativeInput(){const t=this.getNativeControl();return t instanceof HTMLInputElement?t:null}get nativeTextarea(){const t=this.getNativeControl();return t instanceof HTMLTextAreaElement?t:null}syncFromNative(t=!0){const e=this.nativeControl;e&&(this.onNativeValueMutated(e),this.syncFormValue(),t&&this.syncValidity())}focus(t){this.nativeControl?.focus?.(t)}blur(){this.nativeControl?.blur?.()}click(){this.nativeControl?.click?.()}showPicker(){const t=this.nativeInput;if(!t||"function"!=typeof t.showPicker)return!1;try{return t.showPicker(),!0}catch(t){return!1}}getSelectionTarget(){const t=this.getNativeControl();if(!t)return null;if(t instanceof HTMLTextAreaElement)return t;if(t instanceof HTMLInputElement){const e=(t.type||"").toLowerCase();return"date"===e||"time"===e||"week"===e||"month"===e||"datetime-local"===e||"number"===e||"file"===e?null:t}return null}get selectionStart(){return this.getSelectionTarget()?.selectionStart??null}set selectionStart(t){const e=this.getSelectionTarget();e&&(e.selectionStart=t)}get selectionEnd(){return this.getSelectionTarget()?.selectionEnd??null}set selectionEnd(t){const e=this.getSelectionTarget();e&&(e.selectionEnd=t)}get selectionDirection(){return this.getSelectionTarget()?.selectionDirection??null}select(){this.getSelectionTarget()?.select?.()}setSelectionRange(t,e,i){this.getSelectionTarget()?.setSelectionRange?.(t,e,i)}setRangeText(t,e,i,s){const n=this.getSelectionTarget();!n||this.disabled||this.readonly||(void 0!==e&&void 0!==i?n.setRangeText(t,e,i,s):n.setRangeText(t),this.syncFromNative(!0))}get valueAsNumber(){return this.nativeInput?.valueAsNumber??Number.NaN}set valueAsNumber(t){const e=this.nativeInput;!e||this.disabled||this.readonly||(e.valueAsNumber=t,this.syncFromNative(!0))}get valueAsDate(){return this.nativeInput?.valueAsDate??null}set valueAsDate(t){const e=this.nativeInput;!e||this.disabled||this.readonly||(e.valueAsDate=t,this.syncFromNative(!0))}stepUp(t){const e=this.nativeInput;!e||this.disabled||this.readonly||(e.stepUp(t),this.syncFromNative(!0))}stepDown(t){const e=this.nativeInput;!e||this.disabled||this.readonly||(e.stepDown(t),this.syncFromNative(!0))}setCustomValidity(t){this.disabled||(t?this.internals.setValidity({customError:!0},t,this.getValidityAnchor()):(this.internals.setValidity({}),this.syncValidity()))}}t([s({type:String,reflect:!0}),e("design:type",Object)],n.prototype,"name",void 0),t([s({type:String,reflect:!0}),e("design:type",Object)],n.prototype,"formId",void 0),t([s({type:Boolean,reflect:!0}),e("design:type",Object)],n.prototype,"disabled",void 0),t([s({type:Boolean,reflect:!0}),e("design:type",Object)],n.prototype,"readonly",void 0),t([s({type:Boolean,reflect:!0}),e("design:type",Object)],n.prototype,"required",void 0),t([s({type:String}),e("design:type",Object)],n.prototype,"requiredMessage",void 0);export{n as FormControlBase};
+//# sourceMappingURL=form-control-base.js.map

package/dist/helper/internals/form-control-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-control-base.js","sources":["../../../src/helper/internals/form-control-base.ts"],"sourcesContent":[null],"names":["FormControlBase","LitElement","this","formAssociated","constructor","super","defaultValue","name","formId","disabled","readonly","required","requiredMessage","attachInternals","Error","internals","form","validity","validationMessage","willValidate","checkValidity","reportValidity","formResetCallback","onFormReset","syncFormValue","syncValidity","formDisabledCallback","onFormDisabled","formStateRestoreCallback","state","onFormStateRestore","getCustomErrorMessage","validateForForm","setValueFromFormState","_disabled","onNativeValueMutated","_native","setFormValue","v","getFormValue","setValidity","isEmpty","valueMissing","getValidityAnchor","msg","customError","reemitNativeEvent","type","originalEvent","init","common","bubbles","composed","cancelable","includes","ev","undefined","detail","CustomEvent","Event","__originalEvent","dispatchEvent","captureDefaultValue","initial","nativeControl","getNativeControl","nativeInput","el","HTMLInputElement","nativeTextarea","HTMLTextAreaElement","syncFromNative","runValidity","native","focus","options","blur","click","showPicker","input","err","getSelectionTarget","t","toLowerCase","selectionStart","selectionEnd","selectionDirection","select","setSelectionRange","start","end","direction","setRangeText","replacement","selectionMode","valueAsNumber","Number","NaN","valueAsDate","stepUp","n","stepDown","setCustomValidity","message","__decorate","property","String","reflect","prototype","Boolean"],"mappings":"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"}

package/dist/helper/internals/index.d.ts

@@ -0,0 +1 @@
+export * from "./form-control-base";

package/dist/helper/utils/color-resolver.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Color resolution utilities for Sky Design System
+ * Provides consistent color token mapping across components
+ */
+export type ColorToken = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'light' | 'dark' | 'default' | string;
+export interface ColorResolverConfig {
+    /** CSS variable prefix (default: 'sky') */
+    prefix?: string;
+    /** Whether to use color-mix for hover states */
+    useColorMix?: boolean;
+}
+/**
+ * Default color token mapping to CSS variables
+ */
+export declare const DEFAULT_COLOR_TOKENS: Record<string, string>;
+/**
+ * Resolves a color token to its CSS value
+ * @param input - Color token (e.g., 'primary') or custom CSS color
+ * @param customMap - Optional custom token mapping (overrides defaults)
+ * @returns CSS color value
+ */
+export declare function resolveColor(input: string, customMap?: Record<string, string>): string;
+/**
+ * Determines appropriate text color for a given background color token
+ * @param input - Color token (e.g., 'primary')
+ * @returns CSS color value for text
+ */
+export declare function resolveTextColorForToken(input: string): string;
+/** True when the token is the neutral glass surface (`default`), not a brand accent. */
+export declare function isDefaultColorToken(input: string): boolean;
+/** Foreground ink (labels, borders) — never use glass-solid as text. */
+export declare function resolveInkColorForToken(input: string): string;
+/** Accent for hover/focus on neutral surfaces. */
+export declare function resolveAccentColorForToken(input: string): string;
+/**
+ * Theme glass border shorthand (`1px solid …` from `--sky-border-primary`).
+ * Use as a full `border` value — do not wrap in `Npx solid var(--sky-border-primary)`.
+ */
+export declare function skyBorderPrimaryShorthand(): string;
+/**
+ * Separator stroke for custom widths (`--sky-border-light` is a color, not shorthand).
+ */
+export declare function skyBorderWidthSolid(widthPx: number): string;
+/** Partial variant overrides when `color="default"` (surface token, not ink). */
+export type DefaultColorVariantPatch = Partial<{
+    bg: string;
+    color: string;
+    border: string;
+    shadow: string;
+    hoverBg: string;
+    hoverColor: string;
+    hoverShadow: string;
+    hoverBorder: string;
+    arrow: string;
+}>;
+/**
+ * Applies variant style overrides for `color="default"` so glass tokens are not
+ * used as text/border/hover ink on translucent surfaces.
+ */
+export declare function tuneSurfaceVariantForDefaultColor<T extends DefaultColorVariantPatch>(colorToken: string, variant: string, styles: T): T;
+/**
+ * Creates a hover shade using color-mix
+ * @param color - Base CSS color
+ * @param amount - Percentage of black to mix (0-100)
+ * @returns CSS color-mix() value
+ */
+export declare function hoverShade(color: string, amount?: number): string;
+/**
+ * Creates a hover shade using color-mix
+ * @param color - Base CSS color
+ * @param amount - Percentage of black to mix (0-100)
+ * @returns CSS color-mix() value
+ */
+export declare function darkShade(color: string, amount?: number): string;
+/**
+ * Creates a hover shade using color-mix
+ * @param color - Base CSS color
+ * @param amount - Percentage of black to mix (0-100)
+ * @returns CSS color-mix() value
+ */
+export declare function lightShade(color: string, amount?: number): string;
+/**
+ * Creates a faded/transparent version of a color
+ * @param color - Base CSS color
+ * @param amount - Percentage of transparency (0-100)
+ * @returns CSS color-mix() value with transparency
+ */
+export declare function fadeMix(color: string, amount?: number): string;
+/**
+ * Resolves gradient stop tokens to CSS colors
+ * @param stop - Gradient stop token (e.g., 'primary 30%')
+ * @returns CSS gradient stop value
+ */
+export declare function resolveGradientStop(stop: string): string;
+/**
+ * Parses a gradient specification string
+ */
+export interface GradientSpec {
+    kind: 'linear' | 'radial' | 'conic';
+    args: string;
+    stops: string[];
+}
+/**
+ * Parses gradient specification string
+ * Format: "kind@args: stop1, stop2, stop3"
+ * Example: "linear@90deg: primary, secondary 50%, danger"
+ * Example: "radial@circle: primary, transparent"
+ */
+export declare function parseGradientSpec(input: string): GradientSpec;
+/**
+ * Creates a CSS gradient from a specification string
+ * @param specStr - Gradient specification string
+ * @param fallbackColor - Fallback color if no stops provided
+ * @returns CSS gradient value
+ */
+export declare function createGradient(specStr: string, fallbackColor?: string): string;
+/**
+ * Color resolver with configuration support
+ */
+export declare class ColorResolver {
+    private config;
+    constructor(config?: ColorResolverConfig);
+    /**
+     * Resolves a color with prefix-aware variable names
+     */
+    resolve(input: string): string;
+    /**
+     * Gets text color for a background color
+     */
+    getTextColor(backgroundColor: string): string;
+    /**
+     * Creates a hover state color
+     */
+    getHoverColor(baseColor: string, darkenAmount?: number): string;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const colorResolver: ColorResolver;

package/dist/helper/utils/color-resolver.js

@@ -0,0 +1,2 @@
+const r={primary:"var(--sky-active-primary)",active:"var(--sky-active-primary)",secondary:"var(--sky-info-primary)",success:"var(--sky-success-primary)",danger:"var(--sky-danger-primary)",warning:"var(--sky-warning-primary)",info:"var(--sky-info-primary)",light:"var(--sky-text-light)",dark:"var(--sky-text-dark)",muted:"var(--sky-text-tertiary)","border-light":"var(--sky-border-light)",default:"var(--sky-glass-solid)"};function t(t,a={}){const e={...r,...a};return e[t]||t||e.primary}function a(r){return{dark:"var(--sky-text-light)",light:"var(--sky-text-dark)",warning:"var(--sky-text-black)",success:"var(--sky-text-black)",default:"var(--sky-text-primary)"}[r]||"var(--sky-text-white)"}function e(r){return"default"===r}function i(r){return e(r)?"var(--sky-text-primary)":t(r)}function o(r){return e(r)?"var(--sky-active-primary)":t(r)}function s(){return"var(--sky-border-primary)"}function n(r){return`${r}px solid var(--sky-border-light)`}const y={shadow:{bg:"var(--sky-glass-solid)",hoverBg:"var(--sky-glass-solid)",color:"var(--sky-text-primary)",hoverColor:"var(--sky-active-primary)",arrow:"var(--sky-glass-solid)"},solid:{hoverShadow:"var(--sky-box-shadow-primary)"},faded:{color:"var(--sky-text-primary)",hoverColor:"var(--sky-text-primary)",arrow:"var(--sky-hover-tertiary)"},bordered:{color:"var(--sky-text-primary)",border:n(2),hoverColor:"var(--sky-text-primary)",hoverBorder:"2px solid var(--sky-text-tertiary)",arrow:"var(--sky-border-light)"},transparent:{color:"var(--sky-text-primary)",hoverBg:"var(--sky-hover-tertiary)",hoverColor:"var(--sky-text-primary)"},flat:{bg:"var(--sky-hover-tertiary)",color:"var(--sky-text-primary)",hoverBg:"var(--sky-hover-secondary)",hoverColor:"var(--sky-active-primary)",arrow:"var(--sky-hover-tertiary)"},ghost:{color:"var(--sky-text-primary)",border:n(2),hoverBg:"var(--sky-hover-secondary)",hoverColor:"var(--sky-text-primary)"},link:{color:"var(--sky-text-primary)",hoverColor:"var(--sky-active-primary)"},light:{color:"var(--sky-text-primary)"}};function v(r,t,a){if(!e(r))return a;const i=y[t];return i?{...a,...i}:a}function c(r,t=20){return`color-mix(in srgb, ${r} ${100-t}%, var(--sky-text-dark))`}function l(r,t=20){return`color-mix(in srgb, ${r} ${100-t}%, var(--sky-text-black))`}function k(r,t=20){return`color-mix(in srgb, ${r} ${100-t}%, var(--sky-text-white))`}function d(r,t=15){return`color-mix(in srgb, ${r} ${t}%, transparent)`}function u(t){const a=t.match(/^([^\s]+)(\s+.+)?$/),e=a?.[1]??t;return`${r[e]||e}${a?.[2]??""}`}function p(r){const t=(r||"").trim(),a=t.indexOf(":");let e="",i=t;-1!==a&&(e=t.slice(0,a).trim(),i=t.slice(a+1).trim());let o="linear",s="90deg";if(e){const[r,a]=e.split("@").map(r=>r.trim()),n=(r||"").toLowerCase();"linear"===n||"radial"===n||"conic"===n?(o=n,s=a||("linear"===o?"90deg":"radial"===o?"circle":"from 0deg at 50% 50%")):i=t}return{kind:o,args:s,stops:i.split(",").map(r=>r.trim()).filter(Boolean)}}function g(r,t="var(--sky-active-primary)"){const a=p(r),e=(a.stops.length?a.stops:[t,t]).map(r=>u(r)),{kind:i,args:o}=a;switch(i){case"linear":return`linear-gradient(${o}, ${e.join(", ")})`;case"radial":return`radial-gradient(${o}, ${e.join(", ")})`;case"conic":return`conic-gradient(${o}, ${e.join(", ")})`;default:return`linear-gradient(90deg, ${e.join(", ")})`}}class h{constructor(r={}){this.config={prefix:r.prefix||"sky",useColorMix:r.useColorMix??!0}}resolve(t){if(t.startsWith("#"))return t;if(t.startsWith("rgb")||t.startsWith("hsl"))return t;if(t.startsWith("var("))return t;const a=`var(--${this.config.prefix}-${t})`;return r[t]||a||r.primary}getTextColor(t){return t in r?a(t):"var(--sky-text-white)"}getHoverColor(r,t=20){return this.config.useColorMix?c(r,t):r}}const m=new h;export{h as ColorResolver,r as DEFAULT_COLOR_TOKENS,m as colorResolver,g as createGradient,l as darkShade,d as fadeMix,c as hoverShade,e as isDefaultColorToken,k as lightShade,p as parseGradientSpec,o as resolveAccentColorForToken,t as resolveColor,u as resolveGradientStop,i as resolveInkColorForToken,a as resolveTextColorForToken,s as skyBorderPrimaryShorthand,n as skyBorderWidthSolid,v as tuneSurfaceVariantForDefaultColor};
+//# sourceMappingURL=color-resolver.js.map

package/dist/helper/utils/color-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-resolver.js","sources":["../../../src/helper/utils/color-resolver.ts"],"sourcesContent":[null],"names":["DEFAULT_COLOR_TOKENS","primary","active","secondary","success","danger","warning","info","light","dark","muted","default","resolveColor","input","customMap","map","resolveTextColorForToken","isDefaultColorToken","resolveInkColorForToken","resolveAccentColorForToken","skyBorderPrimaryShorthand","skyBorderWidthSolid","widthPx","DEFAULT_COLOR_VARIANT_PATCHES","shadow","bg","hoverBg","color","hoverColor","arrow","solid","hoverShadow","faded","bordered","border","hoverBorder","transparent","flat","ghost","link","tuneSurfaceVariantForDefaultColor","colorToken","variant","styles","patch","hoverShade","amount","darkShade","lightShade","fadeMix","resolveGradientStop","stop","match","head","parseGradientSpec","raw","trim","idx","indexOf","prefix","stopsStr","slice","kind","args","k","a","split","s","kLower","toLowerCase","stops","filter","Boolean","createGradient","specStr","fallbackColor","spec","length","st","join","ColorResolver","constructor","config","this","useColorMix","resolve","startsWith","customVar","getTextColor","backgroundColor","getHoverColor","baseColor","darkenAmount","colorResolver"],"mappings":"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"}

package/dist/helper/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./color-resolver";
+export * from "./size-resolver";

package/dist/helper/utils/size-resolver.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves a radius input into a valid CSS radius value.
+ * @param input - The radius input (`sm`, `md`, `lg`, `full`, `none`, or CSS length).
+ * @returns The resolved CSS radius value.
+ */
+export declare function resolveRadius(input: string): string;

package/dist/helper/utils/size-resolver.js

@@ -0,0 +1,2 @@
+function r(r){const a={none:"0px",sm:"var(--sky-radius-primary)",md:"var(--sky-radius-secondary)",lg:"var(--sky-radius-tertiary)",full:"9999px"};return Object.prototype.hasOwnProperty.call(a,r)?a[r]:r}export{r as resolveRadius};
+//# sourceMappingURL=size-resolver.js.map

package/dist/helper/utils/size-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-resolver.js","sources":["../../../src/helper/utils/size-resolver.ts"],"sourcesContent":[null],"names":["resolveRadius","input","map","none","sm","md","lg","full","Object","prototype","hasOwnProperty","call"],"mappings":"AAKM,SAAUA,EAAcC,GAC1B,MAAMC,EAA8B,CAClCC,KAAM,MACNC,GAAI,4BACJC,GAAI,8BACJC,GAAI,6BACJC,KAAM,UAER,OAAOC,OAAOC,UAAUC,eAAeC,KAAKT,EAAKD,GAC7CC,EAAID,GACJA,CACN"}

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+export { html } from 'lit';
+export * from './helper';
+export * from './sky-accordion';
+export * from './sky-accordion-item';
+export * from './sky-alert';
+export * from './sky-appbar';
+export * from './sky-avatar';
+export * from './sky-badge';
+export * from './sky-breadcrumb';
+export * from './sky-button';
+export * from './sky-button-group';
+export * from './sky-card';
+export * from './sky-carousel';
+export * from './sky-checkbox';
+export * from './sky-chip';
+export * from './sky-col';
+export * from './sky-combobox';
+export * from './sky-counter';
+export * from './sky-dialog';
+export * from './sky-divider';
+export * from './sky-drawer';
+export * from './sky-dropdown';
+export * from './sky-dropdown-item';
+export * from './sky-flexbar';
+export * from './sky-flexbox';
+export * from './sky-flexcol';
+export * from './sky-flexitem';
+export * from './sky-form';
+export * from './sky-grid';
+export * from './sky-icon';
+export * from './sky-image';
+export * from './sky-input';
+export * from './sky-list';
+export * from './sky-listitem';
+export * from './sky-navbar';
+export * from './sky-navpanel';
+export * from './sky-notification';
+export * from './sky-otp';
+export * from './sky-overlay';
+export * from './sky-pagination';
+export * from './sky-progress';
+export * from './sky-radio';
+export * from './sky-radio-group';
+export * from './sky-range';
+export * from './sky-row';
+export * from './sky-serial';
+export * from './sky-sheet';
+export * from './sky-skeleton';
+export * from './sky-slider';
+export * from './sky-speeddial';
+export * from './sky-spinner';
+export * from './sky-steps';
+export * from './sky-switch';
+export * from './sky-tab';
+export * from './sky-tab-button';
+export * from './sky-theme-provider';
+export * from './sky-theme-switcher';
+export * from './sky-tooltip';

package/dist/index.js

@@ -0,0 +1,2 @@
+export{html}from"lit";export{FormControlBase}from"./helper/internals/form-control-base.js";export{ColorResolver,DEFAULT_COLOR_TOKENS,colorResolver,createGradient,darkShade,fadeMix,hoverShade,isDefaultColorToken,lightShade,parseGradientSpec,resolveAccentColorForToken,resolveColor,resolveGradientStop,resolveInkColorForToken,resolveTextColorForToken,skyBorderPrimaryShorthand,skyBorderWidthSolid,tuneSurfaceVariantForDefaultColor}from"./helper/utils/color-resolver.js";export{resolveRadius}from"./helper/utils/size-resolver.js";export{AnimationController}from"./helper/controllers/animation-controller.js";export{PopoverController}from"./helper/controllers/popover-controller.js";export{extractIconNames,fetchIconsForOffline,registerOfflineIcons}from"./helper/iconify-offline.js";export{SkyAccordion}from"./sky-accordion/sky-accordion.js";export{SkyAccordionItem}from"./sky-accordion-item/sky-accordion-item.js";export{SkyAlert}from"./sky-alert/sky-alert.js";export{SkyAppbar}from"./sky-appbar/sky-appbar.js";export{SkyAvatar}from"./sky-avatar/sky-avatar.js";export{SkyBadge}from"./sky-badge/sky-badge.js";export{SkyBreadcrumb}from"./sky-breadcrumb/sky-breadcrumb.js";export{SkyButton}from"./sky-button/sky-button.js";export{SkyButtonGroup}from"./sky-button-group/sky-button-group.js";export{SkyCard}from"./sky-card/sky-card.js";export{SkyCarousel}from"./sky-carousel/sky-carousel.js";export{SkyCheckbox}from"./sky-checkbox/sky-checkbox.js";export{SkyChip}from"./sky-chip/sky-chip.js";export{SkyCol}from"./sky-col/sky-col.js";export{SkyCombobox}from"./sky-combobox/sky-combobox.js";export{SkyCounter}from"./sky-counter/sky-counter.js";export{SkyDialog}from"./sky-dialog/sky-dialog.js";export{SkyDivider}from"./sky-divider/sky-divider.js";export{SkyDrawer}from"./sky-drawer/sky-drawer.js";export{SkyDropdown}from"./sky-dropdown/sky-dropdown.js";export{SkyDropdownItem}from"./sky-dropdown-item/sky-dropdown-item.js";export{SkyFlexbar}from"./sky-flexbar/sky-flexbar.js";export{SkyFlexbox}from"./sky-flexbox/sky-flexbox.js";export{SkyFlexcol}from"./sky-flexcol/sky-flexcol.js";export{SkyFlexitem}from"./sky-flexitem/sky-flexitem.js";export{SkyForm}from"./sky-form/sky-form.js";export{SkyGrid}from"./sky-grid/sky-grid.js";export{SkyIcon}from"./sky-icon/sky-icon.js";export{SkyImage}from"./sky-image/sky-image.js";export{SkyInput}from"./sky-input/sky-input.js";export{SkyList}from"./sky-list/sky-list.js";export{SkyListitem}from"./sky-listitem/sky-listitem.js";export{SkyNavbar}from"./sky-navbar/sky-navbar.js";export{SkyNavpanel}from"./sky-navpanel/sky-navpanel.js";export{SkyNotification}from"./sky-notification/sky-notification.js";export{SkyOtp}from"./sky-otp/sky-otp.js";export{SkyOverlay}from"./sky-overlay/sky-overlay.js";export{SkyPagination}from"./sky-pagination/sky-pagination.js";export{SkyProgress}from"./sky-progress/sky-progress.js";export{SkyRadio}from"./sky-radio/sky-radio.js";export{SkyRadioGroup}from"./sky-radio-group/sky-radio-group.js";export{SkyRange}from"./sky-range/sky-range.js";export{SkyRow}from"./sky-row/sky-row.js";export{SkySerial}from"./sky-serial/sky-serial.js";export{SkySheet,resolveSheetRadius}from"./sky-sheet/sky-sheet.js";export{SkySkeleton}from"./sky-skeleton/sky-skeleton.js";export{SkySlider}from"./sky-slider/sky-slider.js";export{SkySpeeddial}from"./sky-speeddial/sky-speeddial.js";export{SkySpinner}from"./sky-spinner/sky-spinner.js";export{SkySteps}from"./sky-steps/sky-steps.js";export{SkySwitch}from"./sky-switch/sky-switch.js";export{SkyTab}from"./sky-tab/sky-tab.js";export{SkyTabButton}from"./sky-tab-button/sky-tab-button.js";export{SkyThemeProvider,defaultTheme,getCurrentTheme,getThemePreference,mergeTheme,onThemeChange,resolveActualTheme,themeContext}from"./sky-theme-provider/sky-theme-provider.js";export{SkyThemeSwitcher}from"./sky-theme-switcher/sky-theme-switcher.js";export{SkyTooltip}from"./sky-tooltip/sky-tooltip.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/sky-accordion/index.d.ts

@@ -0,0 +1 @@
+export * from "./sky-accordion";

package/dist/sky-accordion/index.js

@@ -0,0 +1 @@
+export * from './sky-accordion.js';

package/dist/sky-accordion/sky-accordion.d.ts

@@ -0,0 +1,201 @@
+import { LitElement } from "lit";
+import { SkyAccordionItem } from "../sky-accordion-item/sky-accordion-item";
+export type SkyAccordionVariant = "transparent" | "solid" | "bordered" | "splitted";
+export type SkyAccordionToggleEventDetail = {
+    open: boolean;
+};
+/**
+ * @element sky-accordion
+ *
+ * @summary Container that manages direct `<sky-accordion-item>` children, open-state coordination, and keyboard navigation.
+ *
+ * @status stable
+ * @since 1.0.0
+ *
+ * @documentation https://library.sky-ui.com/components/accordion
+ * @dependency sky-accordion-item
+ *
+ * @slot - One or more direct `<sky-accordion-item>` children.
+ *
+ * @property {boolean} singleOpen - Allows at most one direct item to remain open at a time.
+ * @property {SkyAccordionVariant} variant - Visual presentation variant for the accordion container.
+ * @property {boolean} disabled - Disables user interaction for the entire accordion.
+ * @property {string} label - Accessible name applied to the group via `aria-label`.
+ * @method expandAll Opens all direct items; in `single-open` mode, opens only the first direct item.
+ * @method collapseAll Closes all direct items.
+ * @method openItem Opens a direct item by index and returns whether the operation succeeded.
+ * @method closeItem Closes a direct item by index and returns whether the operation succeeded.
+ * @method toggleItem Toggles a direct item by index and returns whether the operation succeeded.
+ * @method openFirst Opens the first direct item and returns whether the operation succeeded.
+ * @method openLast Opens the last direct item and returns whether the operation succeeded.
+ * @method focusItem Moves focus to a direct item header by index and returns whether focus was moved.
+ * @method focusFirst Moves focus to the first direct item header and returns whether focus was moved.
+ * @method focusLast Moves focus to the last direct item header and returns whether focus was moved.
+ * @method getItems Returns a snapshot of direct `<sky-accordion-item>` children.
+ *
+ * @fires {CustomEvent<SkyAccordionToggleEventDetail>} accordion-toggle - Emitted by a direct child item when its open state changes; used by the container to enforce `single-open` behavior.
+ *
+ * @csspart group - Wrapper that contains all slotted accordion items.
+ *
+ * @Behavior
+ * - Default mode allows multiple direct items to remain open.
+ * - `single-open` ensures only one direct item is open at any time.
+ * - Nested item events are ignored; coordination applies only to direct children.
+ * - Keyboard navigation supports `ArrowDown`/`ArrowRight`, `ArrowUp`/`ArrowLeft`, `Home`, and `End`.
+ * - Accessibility is provided through `role="group"` and optional `aria-label` on the wrapper.
+ *
+ * @example
+ * ```html
+ * <sky-accordion label="FAQs" single-open variant="splitted">
+ *   <sky-accordion-item open>
+ *     <span slot="title">What is Sky UI?</span>
+ *     <div slot="content">A reusable web component library.</div>
+ *   </sky-accordion-item>
+ * </sky-accordion>
+ * ```
+ * ```vue
+ * <template>
+ *   <sky-accordion label="FAQs" single-open variant="splitted">
+ *     <sky-accordion-item open>
+ *       <span slot="title">What is Sky UI?</span>
+ *       <div slot="content">A reusable web component library.</div>
+ *     </sky-accordion-item>
+ *   </sky-accordion>
+ * </template>
+ * ```
+ * ```jsx
+ * export default function Demo() {
+ *   return (
+ *     <sky-accordion label="FAQs" single-open variant="splitted">
+ *       <sky-accordion-item open>
+ *         <span slot="title">What is Sky UI?</span>
+ *         <div slot="content">A reusable web component library.</div>
+ *       </sky-accordion-item>
+ *     </sky-accordion>
+ *   );
+ * }
+ * ```
+ */
+export declare class SkyAccordion extends LitElement {
+    /**
+     * Enables single-open coordination for direct items.
+     * @default false
+     */
+    singleOpen: boolean;
+    /**
+     * Visual variant applied to the accordion container.
+     * @default "solid"
+     */
+    variant: SkyAccordionVariant;
+    /**
+     * Disables interaction for all direct accordion items.
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * Accessible group label mapped to `aria-label`.
+     */
+    label: string;
+    /**
+     * Cached list of direct accordion children.
+     * Reset when slot content changes.
+     */
+    private _itemsCache;
+    static styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens direct items.
+     * In `single-open` mode, opens only the first direct item.
+     *
+     * @returns {void}
+     */
+    expandAll(): void;
+    /**
+     * Closes all direct items.
+     *
+     * @returns {void}
+     */
+    collapseAll(): void;
+    /**
+     * Opens a direct item by index.
+     * In `single-open` mode, opening one item closes the others.
+     *
+     * @param index Zero-based direct child index.
+     * @returns True when an item exists at the index and is opened.
+     */
+    openItem(index: number): boolean;
+    /**
+     * Closes a direct item by index.
+     *
+     * @param index Zero-based direct child index.
+     * @returns True when an item exists at the index and is closed.
+     */
+    closeItem(index: number): boolean;
+    /**
+     * Toggles a direct item by index.
+     * In `single-open` mode, opening one item closes the others.
+     *
+     * @param index Zero-based direct child index.
+     * @returns True when an item exists at the index and is toggled.
+     */
+    toggleItem(index: number): boolean;
+    /**
+     * Opens the first direct item.
+     *
+     * @returns True when at least one direct item exists and is opened.
+     */
+    openFirst(): boolean;
+    /**
+     * Opens the last direct item.
+     *
+     * @returns True when at least one direct item exists and is opened.
+     */
+    openLast(): boolean;
+    /**
+     * Moves focus to a direct item header by index.
+     *
+     * @param index Zero-based direct child index.
+     * @returns True when a header is found and focused.
+     */
+    focusItem(index: number): boolean;
+    /**
+     * Moves focus to the first direct item header.
+     *
+     * @returns True when a first item header is found and focused.
+     */
+    focusFirst(): boolean;
+    /**
+     * Moves focus to the last direct item header.
+     *
+     * @returns True when a last item header is found and focused.
+     */
+    focusLast(): boolean;
+    /**
+     * Returns a snapshot of direct items.
+     *
+     * @returns A shallow copy of direct `<sky-accordion-item>` children.
+     */
+    getItems(): SkyAccordionItem[];
+    /**
+     * Handles child toggle events for single-open coordination.
+     * Ignores events from nested or non-direct accordion items.
+     *
+     * @param e Toggle event emitted by a descendant item.
+     * @returns {void}
+     */
+    private handleItemToggle;
+    /**
+     * Handles keyboard navigation across direct item headers.
+     * Focuses adjacent or boundary headers without changing open state.
+     */
+    private handleKeydown;
+    /** Clears the direct-item cache after slot content changes. */
+    private handleSlotChange;
+    /**
+     * Returns direct `<sky-accordion-item>` children.
+     * Uses `this.children`, so nested descendants are excluded.
+     */
+    private get items();
+    render(): import("lit-html").TemplateResult<1>;
+}