@stacksjs/stx 0.2.21 → 0.2.26

package/dist/animation.d.ts

@@ -1,3 +1,25 @@
+import type { CustomDirective, StxOptions } from './types';
+/**
+ * Create an animation timeline for coordinated animations
+ */
+export declare function createAnimationTimeline(entries: TimelineEntry[]): string;
+/**
+ * Generate CSS for a custom animation
+ */
+export declare function generateAnimationCSS(name: string, keyframes: Keyframe[], options: KeyframeAnimationOptions): string;
+/**
+ * Parse animation shorthand string
+ * Format: "duration [delay] [easing] [iterations] [direction] [fill]"
+ */
+export declare function parseAnimationShorthand(shorthand: string): KeyframeAnimationOptions;
+/**
+ * Generate client-side animation runtime
+ */
+export declare function generateAnimationRuntime(): string;
+/**
+ * Register animation directives
+ */
+export declare function registerAnimationDirectives(options: StxOptions): StxOptions;
 /**
  * Default transition options
  */
@@ -7,6 +29,14 @@ export declare const DEFAULT_TRANSITION_OPTIONS: {
   ease: string
   direction: string
 };
+/**
+ * @stagger directive for staggered child animations
+ */
+export declare const staggerDirective: CustomDirective;
+/**
+ * @spring directive for spring physics animations
+ */
+export declare const springDirective: CustomDirective;
 /**
  * Available transition types that can be used with @transition directive
  */

package/dist/builtins/drawer.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinComponentDef } from '../component-registry';
+export declare const StxDrawerBuiltin: BuiltinComponentDef;

package/dist/builtins/index.d.ts

@@ -1,4 +1,5 @@
 import { IconBuiltin } from './icon';
+import { StxDrawerBuiltin } from './drawer';
 import { StxImageBuiltin } from './stx-image';
 import { StxLinkBuiltin } from './stx-link';
 import { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
@@ -12,8 +13,9 @@ export declare function registerBuiltins(): void;
 /**
  * Builtin Components Barrel
  *
- * Re-exports all builtin component definitions and provides a
- * convenience function to register them with the component registry.
+ * These are engine-level builtins that need deep template processing
+ * integration or inject runtime globals. Presentational UI components
+ * live in packages/components instead.
  *
  * @module builtins
  */
@@ -22,4 +24,6 @@ export { StxImageBuiltin } from './stx-image';
 export { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
 export { StxToastBuiltin } from './toast';
 export { StxModalBuiltin } from './modal';
+export { StxDrawerBuiltin } from './drawer';
 export { IconBuiltin, preloadIconCollection } from './icon';
+export { getTooltipRuntime } from './tooltip';

package/dist/builtins/tooltip.d.ts

@@ -0,0 +1,18 @@
+/**
+ * x-tooltip Directive Runtime
+ *
+ * Provides a lightweight tooltip directive for the signals runtime.
+ * Uses event delegation with a single shared tooltip element.
+ *
+ * Usage:
+ *   <button x-tooltip="Save changes">Save</button>
+ *   <button x-tooltip="Delete item" x-tooltip-position="bottom">Delete</button>
+ *   <span x-tooltip="Copy to clipboard" x-tooltip-position="left">Copy</span>
+ *   <span x-tooltip="More info" x-tooltip-position="right">Info</span>
+ *
+ * Positions: top (default), bottom, left, right
+ * Override with x-tooltip-position attribute.
+ *
+ * @module builtins/tooltip
+ */
+export declare function getTooltipRuntime(): string;

package/dist/caching.d.ts

@@ -2,6 +2,14 @@ import type { StxOptions } from './types';
 /**
  * Read a file with mtime-based caching.
  * Returns cached content if file hasn't been modified since last read.
+ *
+ * Race-safe: stats → reads → re-stats. If the mtime moved between the
+ * initial stat and the read, the content we just got may not match the
+ * mtime we'd cache it under, so we retry up to 3 times. Without this,
+ * a writer flushing the file between our stat() and our read() would
+ * have us cache the *new* content under the *old* mtime — and the
+ * subsequent invalidation never fires because the cached mtime already
+ * "matches" the new file mtime on the next cache-hit check.
  */
 export declare function readFileCached(filePath: string): Promise<string>;
 /**