@mhmo91/schmancy 0.9.15 → 0.9.17

package/types/src/textarea/textarea.d.ts

@@ -1,7 +1,15 @@
 import { LitElement, type PropertyValues } from 'lit';
 declare const SchmancyTextarea_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
- * Textarea component with auto-resize and form integration.
+ * Multi-line text input with auto-resize and form integration. Form-associated.
+ *
+ * @element schmancy-textarea
+ * @summary Textarea for freeform text — notes, descriptions, messages. Auto-grows with content up to a maxlength.
+ * @example
+ * <schmancy-textarea name="description" label="Description" rows="4" maxlength="500"></schmancy-textarea>
+ * @platform textarea change - Schmancy-skinned native `<textarea>`. Degrades to styled native `<textarea>` if the tag never registers.
+ * @fires input - On every keystroke.
+ * @fires change - On blur.
  *
  * @prop {string} name - Name attribute for form submission
  * @prop {string} value - Current value of the textarea

package/types/src/theme/theme.component.d.ts

@@ -2,28 +2,23 @@ import { TSchmancyTheme } from './theme.interface';
 export declare const tailwindStyles: import("lit").CSSResult;
 declare const SchmancyThemeComponent_base: CustomElementConstructor & import("../../mixins/constructor").Constructor<import("lit").LitElement> & import("../../mixins/constructor").Constructor<import("../../mixins/baseElement").IBaseMixin>;
 /**
- * SchmancyThemeComponent - Provides theming capabilities for Schmancy components.
- *
- * This component manages color schemes, primary colors, and theme distribution
- * throughout the component tree. It can be used at the root level or nested
- * to provide different themes to different parts of the application.
+ * Theme provider — generates a Material 3 palette from a seed color, resolves light/dark scheme, and publishes the token set to descendants as CSS custom properties (var(--schmancy-sys-color-…)).
  *
  * @element schmancy-theme
- *
+ * @summary Always wrap your app root in a `<schmancy-theme root scheme="auto" color="#…">`. Nest additional `<schmancy-theme>` blocks to override theming for a subtree.
  * @example
- * ```html
  * <!-- Root theme provider -->
- * <schmancy-theme color="#6200ee" scheme="auto" root>
+ * <schmancy-theme root scheme="auto" color="#6200ee">
  *   <your-app></your-app>
  * </schmancy-theme>
- *
- * <!-- Nested theme for specific section -->
- * <schmancy-theme color="#2196f3" scheme="dark">
- *   <div class="dark-section">
- *     <!-- Components here will use blue dark theme -->
- *   </div>
+ * @example
+ * <!-- Nested theme for a specific section -->
+ * <schmancy-theme scheme="dark" color="#2196f3">
+ *   <schmancy-surface fill="all">
+ *     <!-- Components here use the blue dark theme -->
+ *   </schmancy-surface>
  * </schmancy-theme>
- * ```
+ * @platform div - Styled `<div>` that publishes theme tokens via inline `--schmancy-sys-color-*` custom properties. Degrades to a plain div if the tag never registers — children lose theming and fall back to browser defaults.
  */
 export declare class SchmancyThemeComponent extends SchmancyThemeComponent_base {
     /**

package/types/src/tree/tree.d.ts

@@ -1,6 +1,18 @@
 declare const SchmancyTree_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
+ * Expandable tree node — a recursive disclosure widget. One root slot, one default slot for child nodes. Each node can itself contain schmancy-tree children.
+ *
  * @element schmancy-tree
+ * @summary Use for hierarchical navigation / file-explorer layouts. Each level is a schmancy-tree with a `root` slot (the parent label) and default slot (the children, which may be more schmancy-trees).
+ * @example
+ * <schmancy-tree>
+ *   <schmancy-list-item slot="root">src/</schmancy-list-item>
+ *   <schmancy-tree>
+ *     <schmancy-list-item slot="root">components/</schmancy-list-item>
+ *     <schmancy-list-item>button.ts</schmancy-list-item>
+ *   </schmancy-tree>
+ * </schmancy-tree>
+ * @platform details toggle - Recursive `<details>`-like disclosure. Degrades to a plain nested list if the tag never registers — loses expand/collapse but stays navigable.
  * @slot root - The root element of the tree
  * @slot - The children of the tree
  */