@hyperfixi/core 2.9.4 → 2.11.0

package/dist/lsp-metadata.js

@@ -167,8 +167,8 @@ const HOVER_DOCS = {
     },
     put: {
         title: 'put',
-        description: 'Sets the content of an element.',
-        example: 'put "Hello" into #message\nput response into #results',
+        description: 'Sets the content of an element. An array of elements is moved in order (an in-place reorder when they are already children of the target).',
+        example: 'put "Hello" into #message\nput response into #results\nput <tr/> in me sorted by its @data-price as Number at end of me',
         category: 'command',
     },
     set: {

package/dist/lsp-metadata.mjs

@@ -165,8 +165,8 @@ const HOVER_DOCS = {
     },
     put: {
         title: 'put',
-        description: 'Sets the content of an element.',
-        example: 'put "Hello" into #message\nput response into #results',
+        description: 'Sets the content of an element. An array of elements is moved in order (an in-place reorder when they are already children of the target).',
+        example: 'put "Hello" into #message\nput response into #results\nput <tr/> in me sorted by its @data-price as Number at end of me',
         category: 'command',
     },
     set: {

package/dist/metadata.d.ts

@@ -1,6 +1,6 @@
 export declare const packageInfo: {
     readonly name: "@hyperfixi/core";
-    readonly version: "2.7.2";
+    readonly version: "2.10.0";
     readonly description: "Modern hyperscript engine with fixi/htmx integration";
     readonly compatibility: "~85% official _hyperscript";
     readonly languages: 24;

package/dist/metadata.js

@@ -62,10 +62,12 @@ const COMMAND_NAMES = [
     'wait',
 ];
 
+const VERSION = '2.10.0';
+
 const FULL_RUNTIME_COMMAND_COUNT = COMMAND_NAMES.length;
 const packageInfo = {
     name: '@hyperfixi/core',
-    version: '2.7.2',
+    version: VERSION,
     description: 'Modern hyperscript engine with fixi/htmx integration',
     compatibility: '~85% official _hyperscript',
     languages: 24,
@@ -146,8 +148,8 @@ const bundleInfo = [
         id: 'hybrid-hx-v4',
         name: 'Hybrid HX v4',
         filename: 'hyperfixi-hx-v4.js',
-        gzipSize: '320.9 KB',
-        rawSize: '1490 KB',
+        gzipSize: '322.4 KB',
+        rawSize: '1501 KB',
         commandCount: FULL_RUNTIME_COMMAND_COUNT,
         parser: 'full',
         hasBlocks: true,
@@ -163,8 +165,8 @@ const bundleInfo = [
         id: 'minimal',
         name: 'Minimal',
         filename: 'hyperfixi-minimal.js',
-        gzipSize: '71.5 KB',
-        rawSize: '289 KB',
+        gzipSize: '71.9 KB',
+        rawSize: '292 KB',
         commandCount: 10,
         parser: 'full',
         hasBlocks: true,
@@ -180,8 +182,8 @@ const bundleInfo = [
         id: 'standard',
         name: 'Standard',
         filename: 'hyperfixi-standard.js',
-        gzipSize: '78.3 KB',
-        rawSize: '317 KB',
+        gzipSize: '78.8 KB',
+        rawSize: '321 KB',
         commandCount: 25,
         parser: 'full',
         hasBlocks: true,
@@ -197,8 +199,8 @@ const bundleInfo = [
         id: 'browser',
         name: 'Full Browser',
         filename: 'hyperfixi.js',
-        gzipSize: '309.1 KB',
-        rawSize: '1453 KB',
+        gzipSize: '310.8 KB',
+        rawSize: '1464 KB',
         commandCount: FULL_RUNTIME_COMMAND_COUNT,
         parser: 'full',
         hasBlocks: true,
@@ -214,8 +216,8 @@ const bundleInfo = [
         id: 'multilingual',
         name: 'Multilingual',
         filename: 'hyperfixi-multilingual.js',
-        gzipSize: '93.4 KB',
-        rawSize: '380 KB',
+        gzipSize: '94.5 KB',
+        rawSize: '388 KB',
         commandCount: 52,
         parser: 'full',
         hasBlocks: true,

package/dist/metadata.mjs

@@ -60,10 +60,12 @@ const COMMAND_NAMES = [
     'wait',
 ];
 
+const VERSION = '2.10.0';
+
 const FULL_RUNTIME_COMMAND_COUNT = COMMAND_NAMES.length;
 const packageInfo = {
     name: '@hyperfixi/core',
-    version: '2.7.2',
+    version: VERSION,
     description: 'Modern hyperscript engine with fixi/htmx integration',
     compatibility: '~85% official _hyperscript',
     languages: 24,
@@ -144,8 +146,8 @@ const bundleInfo = [
         id: 'hybrid-hx-v4',
         name: 'Hybrid HX v4',
         filename: 'hyperfixi-hx-v4.js',
-        gzipSize: '320.9 KB',
-        rawSize: '1490 KB',
+        gzipSize: '322.4 KB',
+        rawSize: '1501 KB',
         commandCount: FULL_RUNTIME_COMMAND_COUNT,
         parser: 'full',
         hasBlocks: true,
@@ -161,8 +163,8 @@ const bundleInfo = [
         id: 'minimal',
         name: 'Minimal',
         filename: 'hyperfixi-minimal.js',
-        gzipSize: '71.5 KB',
-        rawSize: '289 KB',
+        gzipSize: '71.9 KB',
+        rawSize: '292 KB',
         commandCount: 10,
         parser: 'full',
         hasBlocks: true,
@@ -178,8 +180,8 @@ const bundleInfo = [
         id: 'standard',
         name: 'Standard',
         filename: 'hyperfixi-standard.js',
-        gzipSize: '78.3 KB',
-        rawSize: '317 KB',
+        gzipSize: '78.8 KB',
+        rawSize: '321 KB',
         commandCount: 25,
         parser: 'full',
         hasBlocks: true,
@@ -195,8 +197,8 @@ const bundleInfo = [
         id: 'browser',
         name: 'Full Browser',
         filename: 'hyperfixi.js',
-        gzipSize: '309.1 KB',
-        rawSize: '1453 KB',
+        gzipSize: '310.8 KB',
+        rawSize: '1464 KB',
         commandCount: FULL_RUNTIME_COMMAND_COUNT,
         parser: 'full',
         hasBlocks: true,
@@ -212,8 +214,8 @@ const bundleInfo = [
         id: 'multilingual',
         name: 'Multilingual',
         filename: 'hyperfixi-multilingual.js',
-        gzipSize: '93.4 KB',
-        rawSize: '380 KB',
+        gzipSize: '94.5 KB',
+        rawSize: '388 KB',
         commandCount: 52,
         parser: 'full',
         hasBlocks: true,

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

@@ -44,10 +44,15 @@ const commands = {
     put: {
         name: 'put',
         description: 'Set content or values',
-        syntax: 'put value into target',
+        syntax: 'put value into|before|after|at start of|at end of target',
         category: 'dom',
         availability: 'lite',
-        examples: ['put "Hello" into #output', 'put it into me', "put '<p>New</p>' into #container"],
+        examples: [
+            'put "Hello" into #output',
+            'put it into me',
+            "put '<p>New</p>' into #container",
+            'put <tr/> in me sorted by its @data-price as Number at end of me',
+        ],
     },
     make: {
         name: 'make',
@@ -150,14 +155,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

@@ -42,10 +42,15 @@ const commands = {
     put: {
         name: 'put',
         description: 'Set content or values',
-        syntax: 'put value into target',
+        syntax: 'put value into|before|after|at start of|at end of target',
         category: 'dom',
         availability: 'lite',
-        examples: ['put "Hello" into #output', 'put it into me', "put '<p>New</p>' into #container"],
+        examples: [
+            'put "Hello" into #output',
+            'put it into me',
+            "put '<p>New</p>' into #container",
+            'put <tr/> in me sorted by its @data-price as Number at end of me',
+        ],
     },
     make: {
         name: 'make',
@@ -148,14 +153,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();
@@ -9861,6 +9907,12 @@ function evaluateLiteral(node) {
 }
 async function evaluateIdentifier(node, context) {
     const name = node.name;
+    if (name.startsWith('$')) {
+        notifyGlobalRead(name.slice(1), context);
+    }
+    else if (node.scope === 'global') {
+        notifyGlobalRead(name, context);
+    }
     if (name === 'me' || name === 'my' || name === 'I') {
         return getExpr(context, 'me').evaluate(context);
     }
@@ -9880,7 +9932,6 @@ async function evaluateIdentifier(node, context) {
         return getExpr(context, 'document').evaluate(context);
     }
     if (node.scope === 'global' && context.globals?.has(name)) {
-        notifyGlobalRead(name, context);
         return context.globals.get(name);
     }
     if (node.scope === 'element') {
@@ -9891,12 +9942,9 @@ async function evaluateIdentifier(node, context) {
         return context.locals.get(name);
     }
     if (context.globals && context.globals.has(name)) {
-        if (name.startsWith('$'))
-            notifyGlobalRead(name.slice(1), context);
         return context.globals.get(name);
     }
     if (name.startsWith('$') && context.globals && context.globals.has(name.slice(1))) {
-        notifyGlobalRead(name.slice(1), context);
         return context.globals.get(name.slice(1));
     }
     if (context[name] !== undefined) {
@@ -10870,7 +10918,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 +10994,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 {