@stacksjs/stx 0.2.154 → 0.2.156

package/dist/parser/expression-parser.d.ts

@@ -1,8 +1,31 @@
+/**
+ * Expression Parser
+ *
+ * Provides utilities for parsing JavaScript expressions in templates,
+ * using proper tokenization instead of regex-based approaches.
+ *
+ * @module parser/expression-parser
+ */
 import { extractBalancedExpression, findMatchingDelimiter, splitByPipe, Tokenizer } from './tokenizer';
+export interface ExpressionMatch {
+    fullMatch: string;
+    expression: string;
+    start: number;
+    end: number;
+    isRaw: boolean;
+}
 /**
  * Find all template expressions in source ({{ }} and {!! !!})
  */
 export declare function findExpressions(source: string): ExpressionMatch[];
+export interface FilterCall {
+    name: string;
+    args: string[];
+}
+export interface ParsedExpression {
+    baseExpression: string;
+    filters: FilterCall[];
+}
 /**
  * Parse an expression with optional filter chain
  * e.g., "value | uppercase | truncate(10)" -> { baseExpression: "value", filters: [...] }
@@ -17,44 +40,19 @@ export declare function parseArguments(argsString: string): string[];
  * e.g., "@foreach($items as $item)" -> "$items as $item"
  */
 export declare function extractDirectiveParams(source: string, directiveEnd: number): {
-  params: string
-  endPos: number
+    params: string;
+    endPos: number;
 } | null;
+export interface ScriptDeclaration {
+    type: 'variable' | 'function';
+    name: string;
+    value: string;
+    exported: boolean;
+    start: number;
+    end: number;
+}
 /**
  * Parse script content and extract declarations
  */
 export declare function parseScriptDeclarations(scriptContent: string): ScriptDeclaration[];
-// =============================================================================
-// Expression Extraction
-// =============================================================================
-export declare interface ExpressionMatch {
-  fullMatch: string
-  expression: string
-  start: number
-  end: number
-  isRaw: boolean
-}
-// =============================================================================
-// Filter Parsing
-// =============================================================================
-export declare interface FilterCall {
-  name: string
-  args: string[]
-}
-export declare interface ParsedExpression {
-  baseExpression: string
-  filters: FilterCall[]
-}
-// =============================================================================
-// Script Parsing Utilities
-// =============================================================================
-export declare interface ScriptDeclaration {
-  type: 'variable' | 'function'
-  name: string
-  value: string
-  exported: boolean
-  start: number
-  end: number
-}
-// Re-export tokenizer utilities
 export { extractBalancedExpression, findMatchingDelimiter, splitByPipe, Tokenizer };

package/dist/parser/index.d.ts

@@ -7,42 +7,7 @@
  *
  * @module parser
  */
-// Directive parser
-export {
-  type ConditionalBranch,
-  type DirectiveMatch,
-  extractParenthesizedExpression,
-  findDirectiveBlocks,
-  findIfBlocks,
-  findMatchingEndTag,
-  parseConditionalBlock,
-  type ParsedConditional,
-  type ParsedSwitch,
-  parseSwitchBlock,
-  type SwitchCase,
-} from './directive-parser';
-// Expression parser
-export {
-  type ExpressionMatch,
-  extractDirectiveParams,
-  type FilterCall,
-  findExpressions,
-  parseArguments,
-  type ParsedExpression,
-  parseExpressionWithFilters,
-  parseScriptDeclarations,
-  type ScriptDeclaration,
-} from './expression-parser';
-// Tokenizer
-export {
-  type Token,
-  Tokenizer,
-  type TokenizerState,
-  type TokenType,
-} from './tokenizer';
-// Expression parsing utilities
-export {
-  extractBalancedExpression,
-  findMatchingDelimiter,
-  splitByPipe,
-} from './tokenizer';
+export { type ConditionalBranch, type DirectiveMatch, extractParenthesizedExpression, findDirectiveBlocks, findIfBlocks, findMatchingEndTag, parseConditionalBlock, type ParsedConditional, type ParsedSwitch, parseSwitchBlock, type SwitchCase, } from './directive-parser';
+export { type ExpressionMatch, extractDirectiveParams, type FilterCall, findExpressions, parseArguments, type ParsedExpression, parseExpressionWithFilters, parseScriptDeclarations, type ScriptDeclaration, } from './expression-parser';
+export { type Token, Tokenizer, type TokenizerState, type TokenType, } from './tokenizer';
+export { extractBalancedExpression, findMatchingDelimiter, splitByPipe, } from './tokenizer';

package/dist/parser/tokenizer.d.ts

@@ -1,31 +1,3 @@
-/**
- * Find matching closing delimiter, respecting nesting and strings
- */
-export declare function findMatchingDelimiter(source: string, openChar: string, closeChar: string, startPos?: number): number;
-/**
- * Extract a balanced expression from source starting at position
- */
-export declare function extractBalancedExpression(source: string, startPos: number): {
-  expression: string
-  endPos: number
-};
-/**
- * Split expression by pipe (|) for filters, respecting nesting
- */
-export declare function splitByPipe(expression: string): string[];
-export declare interface Token {
-  type: TokenType
-  value: string
-  start: number
-  end: number
-  line: number
-  column: number
-}
-export declare interface TokenizerState {
-  pos: number
-  line: number
-  column: number
-}
 /**
  * Tokenizer for Template Expressions
  *
@@ -37,29 +9,69 @@ export declare interface TokenizerState {
  *
  * @module parser/tokenizer
  */
-// =============================================================================
-// Token Types
-// =============================================================================
-export type TokenType = | 'STRING' // 'string' or "string"
-  | 'TEMPLATE_STRING' // `template ${expr} string`
-  | 'NUMBER'
-  | 'IDENTIFIER'
-  | 'OPERATOR'
-  | 'PUNCTUATION' // ( ) [ ] { } , ; :
-  | 'WHITESPACE'
-  | 'COMMENT'
-  | 'EXPRESSION_START' // {{
-  | 'EXPRESSION_END' // }}
-  | 'RAW_START' // {!!
-  | 'RAW_END' // !!}
-  | 'DIRECTIVE' // @name
-  | 'EOF';
+export type TokenType = 'STRING' | 'TEMPLATE_STRING' | 'NUMBER' | 'IDENTIFIER' | 'OPERATOR' | 'PUNCTUATION' | 'WHITESPACE' | 'COMMENT' | 'EXPRESSION_START' | 'EXPRESSION_END' | 'RAW_START' | 'RAW_END' | 'DIRECTIVE' | 'EOF';
+export interface Token {
+    type: TokenType;
+    value: string;
+    start: number;
+    end: number;
+    line: number;
+    column: number;
+}
+export interface TokenizerState {
+    pos: number;
+    line: number;
+    column: number;
+}
 /**
  * Tokenizer for template expressions
  */
 export declare class Tokenizer {
-  constructor(source: string);
-  tokenize(): Token[];
-  saveState(): TokenizerState;
-  restoreState(state: TokenizerState): void;
+    private source;
+    private pos;
+    private line;
+    private column;
+    private tokens;
+    constructor(source: string);
+    /**
+     * Tokenize the entire source
+     */
+    tokenize(): Token[];
+    /**
+     * Get the next token
+     */
+    private nextToken;
+    private readWhitespace;
+    private readLineComment;
+    private readBlockComment;
+    private readString;
+    private readTemplateString;
+    private readNumber;
+    private readIdentifier;
+    private readDirective;
+    private advance;
+    private peek;
+    /**
+     * Save current state for backtracking
+     */
+    saveState(): TokenizerState;
+    /**
+     * Restore state for backtracking
+     */
+    restoreState(state: TokenizerState): void;
 }
+/**
+ * Find matching closing delimiter, respecting nesting and strings
+ */
+export declare function findMatchingDelimiter(source: string, openChar: string, closeChar: string, startPos?: number): number;
+/**
+ * Extract a balanced expression from source starting at position
+ */
+export declare function extractBalancedExpression(source: string, startPos: number): {
+    expression: string;
+    endPos: number;
+};
+/**
+ * Split expression by pipe (|) for filters, respecting nesting
+ */
+export declare function splitByPipe(expression: string): string[];

package/dist/partial-hydration.d.ts

@@ -1,3 +1,73 @@
+/**
+ * Partial Hydration Module (Islands Architecture)
+ *
+ * Enables selective hydration of interactive components, leaving static
+ * content as plain HTML. This dramatically reduces JavaScript bundle size
+ * and improves page load performance.
+ *
+ * Hydration Strategies:
+ * - @client:load - Hydrate immediately on page load
+ * - @client:idle - Hydrate when browser is idle (requestIdleCallback)
+ * - @client:visible - Hydrate when component enters viewport (IntersectionObserver)
+ * - @client:media - Hydrate when media query matches
+ * - @client:only - Only render on client (no SSR)
+ * - @client:hover - Hydrate on first hover/focus
+ * - @client:event - Hydrate on custom event
+ *
+ * @example
+ * ```html
+ * @client:visible(rootMargin: '100px')
+ *   <InteractiveCarousel :items="items" />
+ * @endclient
+ * ```
+ */
+export type HydrationStrategy = 'load' | 'idle' | 'visible' | 'media' | 'only' | 'hover' | 'event';
+export interface HydrationOptions {
+    /** Strategy for when to hydrate */
+    strategy: HydrationStrategy;
+    /** Priority for idle hydration (default: 'low') */
+    priority?: 'high' | 'low';
+    /** Root margin for intersection observer (visible strategy) */
+    rootMargin?: string;
+    /** Threshold for intersection observer */
+    threshold?: number | number[];
+    /** Media query string (media strategy) */
+    media?: string;
+    /** Event name to listen for (event strategy) */
+    event?: string;
+    /** Timeout in ms before forcing hydration */
+    timeout?: number;
+    /** Placeholder content while loading */
+    placeholder?: string;
+    /** Whether to preserve server HTML until hydration */
+    preserveServerHTML?: boolean;
+}
+export interface IslandComponent {
+    /** Unique identifier for the island */
+    id: string;
+    /** Component name or path */
+    component: string;
+    /** Props to pass to the component */
+    props: Record<string, unknown>;
+    /** Hydration options */
+    options: HydrationOptions;
+    /** Server-rendered HTML */
+    serverHTML: string;
+    /** Whether the island has been hydrated */
+    hydrated: boolean;
+}
+export interface IslandRegistry {
+    /** All registered islands */
+    islands: Map<string, IslandComponent>;
+    /** Register an island */
+    register: (island: IslandComponent) => void;
+    /** Get an island by ID */
+    get: (id: string) => IslandComponent | undefined;
+    /** Hydrate an island */
+    hydrate: (id: string) => Promise<void>;
+    /** Hydrate all islands */
+    hydrateAll: () => Promise<void>;
+}
 /**
  * Create a registry for managing island components
  */
@@ -38,54 +108,16 @@ export declare function processStaticDirectives(template: string): string;
  * Generate island manifest for client
  */
 export declare function generateIslandManifest(islands: IslandComponent[]): string;
-export declare interface HydrationOptions {
-  strategy: HydrationStrategy
-  priority?: 'high' | 'low'
-  rootMargin?: string
-  threshold?: number | number[]
-  media?: string
-  event?: string
-  timeout?: number
-  placeholder?: string
-  preserveServerHTML?: boolean
-}
-export declare interface IslandComponent {
-  id: string
-  component: string
-  props: Record<string, unknown>
-  options: HydrationOptions
-  serverHTML: string
-  hydrated: boolean
-}
-export declare interface IslandRegistry {
-  islands: Map<string, IslandComponent>
-  register: (island: IslandComponent) => void
-  get: (id: string) => IslandComponent | undefined
-  hydrate: (id: string) => Promise<void>
-  hydrateAll: () => Promise<void>
-}
-// ============================================================================
-// Types
-// ============================================================================
-export type HydrationStrategy = | 'load'
-  | 'idle'
-  | 'visible'
-  | 'media'
-  | 'only'
-  | 'hover'
-  | 'event';
-// ============================================================================
-// Exports
-// ============================================================================
-export default {
-  processPartialHydrationDirectives,
-  processStaticDirectives,
-  generatePartialHydrationCSS,
-  generateIslandManifest,
-  createIslandRegistry,
-  hydrateIsland,
-  hydrateByStrategy,
-  hydrateAll,
-  isHydrated,
-  onHydrated,
+declare const _default: {
+    processPartialHydrationDirectives: typeof processPartialHydrationDirectives;
+    processStaticDirectives: typeof processStaticDirectives;
+    generatePartialHydrationCSS: typeof generatePartialHydrationCSS;
+    generateIslandManifest: typeof generateIslandManifest;
+    createIslandRegistry: typeof createIslandRegistry;
+    hydrateIsland: typeof hydrateIsland;
+    hydrateByStrategy: typeof hydrateByStrategy;
+    hydrateAll: typeof hydrateAll;
+    isHydrated: typeof isHydrated;
+    onHydrated: typeof onHydrated;
 };
+export default _default;