@hyperfixi/core 2.9.4 → 2.10.0

package/dist/parser/command-parsers/dom-commands.d.ts

@@ -3,6 +3,7 @@ import type { Token } from '../../types/core';
 export declare function parseRemoveCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode;
 export declare function parseToggleCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode;
 export declare function parseTakeCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode;
+export declare function parseProcessCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode | null;
 export declare function parseAddCommand(ctx: ParserContext, commandToken: Token): import("../..").CommandNode;
 export declare function parsePutCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode | null;
 export declare function parseSwapCommand(ctx: ParserContext, identifierNode: IdentifierNode): import("../..").CommandNode;

package/dist/parser/full-parser.js

@@ -3820,6 +3820,40 @@ function parseTakeCommand(ctx, identifierNode) {
         .endingAt(ctx.getPosition())
         .build();
 }
+function consumeViewTransitionTail(ctx, args) {
+    if (!ctx.check('using')) {
+        return false;
+    }
+    ctx.advance();
+    if (!ctx.match('view')) {
+        throw new Error("expected 'view transition' after 'using'");
+    }
+    if (!ctx.match('transition')) {
+        throw new Error("expected 'transition' after 'using view'");
+    }
+    args.push(ctx.createIdentifier('using'));
+    args.push(ctx.createIdentifier('view'));
+    args.push(ctx.createIdentifier('transition'));
+    return true;
+}
+function parseProcessCommand(ctx, identifierNode) {
+    if (!ctx.check('partials')) {
+        return null;
+    }
+    const args = [];
+    consumeKeywordToArgs(ctx, 'partials', args);
+    if (consumeKeywordToArgs(ctx, KEYWORDS.IN, args)) {
+        const contentArg = parseOneArgument(ctx, ['using']);
+        if (contentArg) {
+            args.push(contentArg);
+        }
+    }
+    consumeViewTransitionTail(ctx, args);
+    return CommandNodeBuilder.fromIdentifier(identifierNode)
+        .withArgs(...args)
+        .endingAt(ctx.getPosition())
+        .build();
+}
 function parseAddCommand(ctx, commandToken) {
     const args = [];
     if (ctx.match('{')) {
@@ -3941,6 +3975,7 @@ function parseSwapCommand(ctx, identifierNode) {
             args.push(contentExpr);
         }
     }
+    consumeViewTransitionTail(ctx, args);
     return CommandNodeBuilder.fromIdentifier(identifierNode)
         .withArgs(...args)
         .endingAt(ctx.getPosition())
@@ -4454,6 +4489,9 @@ function parseCompoundCommand(ctx, identifierNode) {
         case 'swap':
         case 'morph':
             return parseSwapCommand(ctx, identifierNode);
+        case 'process':
+            return (parseProcessCommand(ctx, identifierNode) ??
+                parseRegularCommand(ctx, identifierNode));
         default:
             return parseRegularCommand(ctx, identifierNode);
     }
@@ -4785,6 +4823,9 @@ function parseTellCommand(ctx, identifierNode) {
     if (!target) {
         throw new Error('tell command requires a target expression');
     }
+    if (ctx.check(KEYWORDS.TO)) {
+        ctx.advance();
+    }
     const commands = [];
     while (!ctx.isAtEnd()) {
         if (ctx.checkIsCommand()) {
@@ -4804,7 +4845,11 @@ function parseTellCommand(ctx, identifierNode) {
             if (ctx.match(KEYWORDS.AND) || ctx.match(KEYWORDS.THEN)) {
                 continue;
             }
-            if (ctx.check(KEYWORDS.ELSE) || ctx.check(KEYWORDS.END)) {
+            if (ctx.check(KEYWORDS.ELSE)) {
+                break;
+            }
+            if (ctx.check(KEYWORDS.END)) {
+                ctx.advance();
                 break;
             }
             if (ctx.checkIsCommand()) {
@@ -7142,6 +7187,7 @@ class Parser {
             'js',
             'tell',
             'fetch',
+            'process',
         ];
         if (this.semanticAdapter && !skipSemanticParsing.includes(commandName.toLowerCase())) {
             const remainingInput = this.getRemainingInput();

package/dist/parser/full-parser.mjs

@@ -3818,6 +3818,40 @@ function parseTakeCommand(ctx, identifierNode) {
         .endingAt(ctx.getPosition())
         .build();
 }
+function consumeViewTransitionTail(ctx, args) {
+    if (!ctx.check('using')) {
+        return false;
+    }
+    ctx.advance();
+    if (!ctx.match('view')) {
+        throw new Error("expected 'view transition' after 'using'");
+    }
+    if (!ctx.match('transition')) {
+        throw new Error("expected 'transition' after 'using view'");
+    }
+    args.push(ctx.createIdentifier('using'));
+    args.push(ctx.createIdentifier('view'));
+    args.push(ctx.createIdentifier('transition'));
+    return true;
+}
+function parseProcessCommand(ctx, identifierNode) {
+    if (!ctx.check('partials')) {
+        return null;
+    }
+    const args = [];
+    consumeKeywordToArgs(ctx, 'partials', args);
+    if (consumeKeywordToArgs(ctx, KEYWORDS.IN, args)) {
+        const contentArg = parseOneArgument(ctx, ['using']);
+        if (contentArg) {
+            args.push(contentArg);
+        }
+    }
+    consumeViewTransitionTail(ctx, args);
+    return CommandNodeBuilder.fromIdentifier(identifierNode)
+        .withArgs(...args)
+        .endingAt(ctx.getPosition())
+        .build();
+}
 function parseAddCommand(ctx, commandToken) {
     const args = [];
     if (ctx.match('{')) {
@@ -3939,6 +3973,7 @@ function parseSwapCommand(ctx, identifierNode) {
             args.push(contentExpr);
         }
     }
+    consumeViewTransitionTail(ctx, args);
     return CommandNodeBuilder.fromIdentifier(identifierNode)
         .withArgs(...args)
         .endingAt(ctx.getPosition())
@@ -4452,6 +4487,9 @@ function parseCompoundCommand(ctx, identifierNode) {
         case 'swap':
         case 'morph':
             return parseSwapCommand(ctx, identifierNode);
+        case 'process':
+            return (parseProcessCommand(ctx, identifierNode) ??
+                parseRegularCommand(ctx, identifierNode));
         default:
             return parseRegularCommand(ctx, identifierNode);
     }
@@ -4783,6 +4821,9 @@ function parseTellCommand(ctx, identifierNode) {
     if (!target) {
         throw new Error('tell command requires a target expression');
     }
+    if (ctx.check(KEYWORDS.TO)) {
+        ctx.advance();
+    }
     const commands = [];
     while (!ctx.isAtEnd()) {
         if (ctx.checkIsCommand()) {
@@ -4802,7 +4843,11 @@ function parseTellCommand(ctx, identifierNode) {
             if (ctx.match(KEYWORDS.AND) || ctx.match(KEYWORDS.THEN)) {
                 continue;
             }
-            if (ctx.check(KEYWORDS.ELSE) || ctx.check(KEYWORDS.END)) {
+            if (ctx.check(KEYWORDS.ELSE)) {
+                break;
+            }
+            if (ctx.check(KEYWORDS.END)) {
+                ctx.advance();
                 break;
             }
             if (ctx.checkIsCommand()) {
@@ -7140,6 +7185,7 @@ class Parser {
             'js',
             'tell',
             'fetch',
+            'process',
         ];
         if (this.semanticAdapter && !skipSemanticParsing.includes(commandName.toLowerCase())) {
             const remainingInput = this.getRemainingInput();

package/dist/reference/index.js

@@ -150,14 +150,15 @@ const commands = {
         examples: ['morph result into #content', 'morph "<div>New</div>" into me'],
     },
     processPartials: {
-        name: 'processPartials',
-        description: 'Process partial templates in HTML content',
-        syntax: 'processPartials content [into target]',
+        name: 'process partials',
+        description: 'Process <hx-partial> elements for multi-target swaps',
+        syntax: 'process partials in <content> [using view transition]',
         category: 'dom',
         availability: 'full',
         examples: [
-            'processPartials result into #container',
-            'processPartials "<partial name=\"header\">...</partial>"',
+            'process partials in it',
+            'process partials in fetchedHtml',
+            'process partials in it using view transition',
         ],
     },
     wait: {

package/dist/reference/index.mjs

@@ -148,14 +148,15 @@ const commands = {
         examples: ['morph result into #content', 'morph "<div>New</div>" into me'],
     },
     processPartials: {
-        name: 'processPartials',
-        description: 'Process partial templates in HTML content',
-        syntax: 'processPartials content [into target]',
+        name: 'process partials',
+        description: 'Process <hx-partial> elements for multi-target swaps',
+        syntax: 'process partials in <content> [using view transition]',
         category: 'dom',
         availability: 'full',
         examples: [
-            'processPartials result into #container',
-            'processPartials "<partial name=\"header\">...</partial>"',
+            'process partials in it',
+            'process partials in fetchedHtml',
+            'process partials in it using view transition',
         ],
     },
     wait: {

package/dist/registry/index.js

@@ -5512,6 +5512,40 @@ function parseTakeCommand(ctx, identifierNode) {
         .endingAt(ctx.getPosition())
         .build();
 }
+function consumeViewTransitionTail(ctx, args) {
+    if (!ctx.check('using')) {
+        return false;
+    }
+    ctx.advance();
+    if (!ctx.match('view')) {
+        throw new Error("expected 'view transition' after 'using'");
+    }
+    if (!ctx.match('transition')) {
+        throw new Error("expected 'transition' after 'using view'");
+    }
+    args.push(ctx.createIdentifier('using'));
+    args.push(ctx.createIdentifier('view'));
+    args.push(ctx.createIdentifier('transition'));
+    return true;
+}
+function parseProcessCommand(ctx, identifierNode) {
+    if (!ctx.check('partials')) {
+        return null;
+    }
+    const args = [];
+    consumeKeywordToArgs(ctx, 'partials', args);
+    if (consumeKeywordToArgs(ctx, KEYWORDS.IN, args)) {
+        const contentArg = parseOneArgument(ctx, ['using']);
+        if (contentArg) {
+            args.push(contentArg);
+        }
+    }
+    consumeViewTransitionTail(ctx, args);
+    return CommandNodeBuilder.fromIdentifier(identifierNode)
+        .withArgs(...args)
+        .endingAt(ctx.getPosition())
+        .build();
+}
 function parseAddCommand(ctx, commandToken) {
     const args = [];
     if (ctx.match('{')) {
@@ -5633,6 +5667,7 @@ function parseSwapCommand(ctx, identifierNode) {
             args.push(contentExpr);
         }
     }
+    consumeViewTransitionTail(ctx, args);
     return CommandNodeBuilder.fromIdentifier(identifierNode)
         .withArgs(...args)
         .endingAt(ctx.getPosition())
@@ -6146,6 +6181,9 @@ function parseCompoundCommand(ctx, identifierNode) {
         case 'swap':
         case 'morph':
             return parseSwapCommand(ctx, identifierNode);
+        case 'process':
+            return (parseProcessCommand(ctx, identifierNode) ??
+                parseRegularCommand(ctx, identifierNode));
         default:
             return parseRegularCommand(ctx, identifierNode);
     }
@@ -6477,6 +6515,9 @@ function parseTellCommand(ctx, identifierNode) {
     if (!target) {
         throw new Error('tell command requires a target expression');
     }
+    if (ctx.check(KEYWORDS.TO)) {
+        ctx.advance();
+    }
     const commands = [];
     while (!ctx.isAtEnd()) {
         if (ctx.checkIsCommand()) {
@@ -6496,7 +6537,11 @@ function parseTellCommand(ctx, identifierNode) {
             if (ctx.match(KEYWORDS.AND) || ctx.match(KEYWORDS.THEN)) {
                 continue;
             }
-            if (ctx.check(KEYWORDS.ELSE) || ctx.check(KEYWORDS.END)) {
+            if (ctx.check(KEYWORDS.ELSE)) {
+                break;
+            }
+            if (ctx.check(KEYWORDS.END)) {
+                ctx.advance();
                 break;
             }
             if (ctx.checkIsCommand()) {
@@ -8834,6 +8879,7 @@ class Parser {
             'js',
             'tell',
             'fetch',
+            'process',
         ];
         if (this.semanticAdapter && !skipSemanticParsing.includes(commandName.toLowerCase())) {
             const remainingInput = this.getRemainingInput();
@@ -10870,7 +10916,7 @@ class CommandAdapterV2 {
         return {
             description: this.impl.metadata?.description || '',
             examples: this.impl.metadata?.examples || [],
-            syntax: Array.isArray(syntax) ? syntax.join(' | ') : syntax || '',
+            syntax: typeof syntax === 'string' ? syntax : syntax ? syntax.join(' | ') : '',
         };
     }
     async execute(context, ...args) {
@@ -10946,10 +10992,8 @@ class CommandAdapterV2 {
         }
     }
     validate(input) {
-        if (this.impl.validate) {
-            return this.impl.validate(input);
-        }
-        return { isValid: true, errors: [], suggestions: [] };
+        const isValid = this.impl.validate ? this.impl.validate(input) : true;
+        return { isValid, errors: [], suggestions: [] };
     }
 }
 class CommandRegistryV2 {

package/dist/registry/index.mjs

@@ -5510,6 +5510,40 @@ function parseTakeCommand(ctx, identifierNode) {
         .endingAt(ctx.getPosition())
         .build();
 }
+function consumeViewTransitionTail(ctx, args) {
+    if (!ctx.check('using')) {
+        return false;
+    }
+    ctx.advance();
+    if (!ctx.match('view')) {
+        throw new Error("expected 'view transition' after 'using'");
+    }
+    if (!ctx.match('transition')) {
+        throw new Error("expected 'transition' after 'using view'");
+    }
+    args.push(ctx.createIdentifier('using'));
+    args.push(ctx.createIdentifier('view'));
+    args.push(ctx.createIdentifier('transition'));
+    return true;
+}
+function parseProcessCommand(ctx, identifierNode) {
+    if (!ctx.check('partials')) {
+        return null;
+    }
+    const args = [];
+    consumeKeywordToArgs(ctx, 'partials', args);
+    if (consumeKeywordToArgs(ctx, KEYWORDS.IN, args)) {
+        const contentArg = parseOneArgument(ctx, ['using']);
+        if (contentArg) {
+            args.push(contentArg);
+        }
+    }
+    consumeViewTransitionTail(ctx, args);
+    return CommandNodeBuilder.fromIdentifier(identifierNode)
+        .withArgs(...args)
+        .endingAt(ctx.getPosition())
+        .build();
+}
 function parseAddCommand(ctx, commandToken) {
     const args = [];
     if (ctx.match('{')) {
@@ -5631,6 +5665,7 @@ function parseSwapCommand(ctx, identifierNode) {
             args.push(contentExpr);
         }
     }
+    consumeViewTransitionTail(ctx, args);
     return CommandNodeBuilder.fromIdentifier(identifierNode)
         .withArgs(...args)
         .endingAt(ctx.getPosition())
@@ -6144,6 +6179,9 @@ function parseCompoundCommand(ctx, identifierNode) {
         case 'swap':
         case 'morph':
             return parseSwapCommand(ctx, identifierNode);
+        case 'process':
+            return (parseProcessCommand(ctx, identifierNode) ??
+                parseRegularCommand(ctx, identifierNode));
         default:
             return parseRegularCommand(ctx, identifierNode);
     }
@@ -6475,6 +6513,9 @@ function parseTellCommand(ctx, identifierNode) {
     if (!target) {
         throw new Error('tell command requires a target expression');
     }
+    if (ctx.check(KEYWORDS.TO)) {
+        ctx.advance();
+    }
     const commands = [];
     while (!ctx.isAtEnd()) {
         if (ctx.checkIsCommand()) {
@@ -6494,7 +6535,11 @@ function parseTellCommand(ctx, identifierNode) {
             if (ctx.match(KEYWORDS.AND) || ctx.match(KEYWORDS.THEN)) {
                 continue;
             }
-            if (ctx.check(KEYWORDS.ELSE) || ctx.check(KEYWORDS.END)) {
+            if (ctx.check(KEYWORDS.ELSE)) {
+                break;
+            }
+            if (ctx.check(KEYWORDS.END)) {
+                ctx.advance();
                 break;
             }
             if (ctx.checkIsCommand()) {
@@ -8832,6 +8877,7 @@ class Parser {
             'js',
             'tell',
             'fetch',
+            'process',
         ];
         if (this.semanticAdapter && !skipSemanticParsing.includes(commandName.toLowerCase())) {
             const remainingInput = this.getRemainingInput();
@@ -10868,7 +10914,7 @@ class CommandAdapterV2 {
         return {
             description: this.impl.metadata?.description || '',
             examples: this.impl.metadata?.examples || [],
-            syntax: Array.isArray(syntax) ? syntax.join(' | ') : syntax || '',
+            syntax: typeof syntax === 'string' ? syntax : syntax ? syntax.join(' | ') : '',
         };
     }
     async execute(context, ...args) {
@@ -10944,10 +10990,8 @@ class CommandAdapterV2 {
         }
     }
     validate(input) {
-        if (this.impl.validate) {
-            return this.impl.validate(input);
-        }
-        return { isValid: true, errors: [], suggestions: [] };
+        const isValid = this.impl.validate ? this.impl.validate(input) : true;
+        return { isValid, errors: [], suggestions: [] };
     }
 }
 class CommandRegistryV2 {

package/dist/runtime/command-adapter.d.ts

@@ -7,15 +7,15 @@ export interface RuntimeCommand {
     validate?(input: unknown): ValidationResult<unknown>;
     metadata?: {
         description: string;
-        examples: string[];
+        examples: readonly string[];
         syntax: string;
     };
 }
 export interface CommandMetadata {
     description?: string;
-    examples?: string[];
-    syntax?: string | string[];
-    aliases?: string[];
+    examples?: readonly string[];
+    syntax?: string | readonly string[];
+    aliases?: readonly string[];
     [extra: string]: unknown;
 }
 export interface CommandRawInput {
@@ -28,8 +28,8 @@ export interface CommandWithParseInput {
     parseInput?(raw: CommandRawInput, evaluator: {
         evaluate(node: ASTNode, context: ExecutionContext): Promise<unknown>;
     }, context: ExecutionContext): Promise<unknown>;
-    execute(input: unknown, context: TypedExecutionContext): Promise<unknown>;
-    validate?(input: unknown): ValidationResult<unknown>;
+    execute(input: unknown, context: TypedExecutionContext): unknown;
+    validate?(input: unknown): boolean;
     metadata?: CommandMetadata;
 }
 export declare class ContextBridge {
@@ -45,7 +45,7 @@ export declare class CommandAdapterV2 implements RuntimeCommand {
     get name(): string;
     get metadata(): {
         description: string;
-        examples: string[];
+        examples: readonly string[];
         syntax: string;
     };
     execute(context: ExecutionContext, ...args: unknown[]): Promise<unknown>;
@@ -58,7 +58,7 @@ export declare class CommandRegistryV2 {
     constructor(_legacySharedEvaluator?: unknown, hookRegistry?: HookRegistry);
     setHookRegistry(registry: HookRegistry): void;
     getHookRegistry(): HookRegistry | undefined;
-    register(impl: any): void;
+    register(impl: CommandWithParseInput): void;
     getAdapter(name: string): CommandAdapterV2 | undefined;
     has(name: string): boolean;
     getCommandNames(): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/core",
-  "version": "2.9.4",
+  "version": "2.10.0",
   "description": "Multilingual, tree-shakeable hyperscript",
   "type": "module",
   "main": "dist/index.js",
@@ -284,14 +284,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@lokascript/intent": "^2.9.4",
-    "@lokascript/semantic": "^2.9.4",
+    "@lokascript/intent": "^2.10.0",
+    "@lokascript/semantic": "^2.10.0",
     "morphlex": "^1.4.0",
     "tslib": "^2.8.1"
   },
   "peerDependencies": {
-    "@hyperfixi/patterns-reference": "^2.9.4",
-    "@lokascript/framework": "^2.9.4"
+    "@hyperfixi/patterns-reference": "^2.10.0",
+    "@lokascript/framework": "^2.10.0"
   },
   "peerDependenciesMeta": {
     "@hyperfixi/patterns-reference": {