@hyperfixi/core 3.3.0 → 4.0.1

package/dist/lsp-metadata.cjs

@@ -18,22 +18,17 @@ const COMMAND_KEYWORDS = [
     'swap',
     'morph',
     'append',
-    'prepend',
     'take',
     'render',
     'scroll',
-    'process',
     'wait',
     'fetch',
     'settle',
     'send',
     'trigger',
     'go',
-    'push',
-    'replace',
     'if',
     'else',
-    'unless',
     'repeat',
     'for',
     'while',
@@ -48,10 +43,11 @@ const COMMAND_KEYWORDS = [
     'blur',
     'log',
     'tell',
-    'copy',
     'pick',
-    'beep',
+    'beep!',
     'breakpoint',
+    'ask',
+    'answer',
     'js',
     'transition',
     'measure',
@@ -60,7 +56,6 @@ const COMMAND_KEYWORDS = [
     'decrement',
     'default',
     'clear',
-    'install',
 ];
 const REFERENCE_KEYWORDS = [
     'me',
@@ -79,6 +74,10 @@ const FEATURE_KEYWORDS = [
     'behavior',
     'def',
     'init',
+    'install',
+    'when',
+    'live',
+    'bind',
     'worker',
     'socket',
     'eventsource',
@@ -108,7 +107,6 @@ const LOGICAL_KEYWORDS = [
     'matches',
     'contains',
     'includes',
-    'has',
     'no',
     'true',
     'false',
@@ -166,8 +164,8 @@ const HOVER_DOCS = {
     },
     put: {
         title: 'put',
-        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',
+        description: 'Puts a value into, before, after, or at the start or end of an element or variable.',
+        example: 'put "Hello" into #message\nput response at end of #results',
         category: 'command',
     },
     set: {
@@ -236,12 +234,6 @@ const HOVER_DOCS = {
         example: 'append "<li>Item</li>" to #list',
         category: 'command',
     },
-    prepend: {
-        title: 'prepend',
-        description: 'Prepends content to an element (hyperfixi extension).',
-        example: 'prepend "<li>Item</li>" to #list',
-        category: 'command',
-    },
     take: {
         title: 'take',
         description: 'Takes/claims a class from sibling elements.',
@@ -251,7 +243,7 @@ const HOVER_DOCS = {
     render: {
         title: 'render',
         description: 'Renders a template with data.',
-        example: 'render #template with {name: "World"}',
+        example: 'render #template with name: "World"',
         category: 'command',
     },
     scroll: {
@@ -260,12 +252,6 @@ const HOVER_DOCS = {
         example: 'scroll to #section\nscroll to the top of me\nscroll down by 200',
         category: 'command',
     },
-    process: {
-        title: 'process',
-        description: 'Processes hyperscript/partials in freshly-inserted content.',
-        example: 'process partials in result',
-        category: 'command',
-    },
     wait: {
         title: 'wait',
         description: 'Pauses execution for a duration or until an event.',
@@ -302,18 +288,6 @@ const HOVER_DOCS = {
         example: 'go to url /home\ngo to #section\ngo back',
         category: 'command',
     },
-    push: {
-        title: 'push',
-        description: 'Pushes a URL onto the browser history stack.',
-        example: 'push url "/page/2"',
-        category: 'command',
-    },
-    replace: {
-        title: 'replace',
-        description: 'Replaces the current browser history entry.',
-        example: 'replace url "/page/2"',
-        category: 'command',
-    },
     if: {
         title: 'if',
         description: 'Conditional execution.',
@@ -326,12 +300,6 @@ const HOVER_DOCS = {
         example: 'if .active remove .active else add .active',
         category: 'block',
     },
-    unless: {
-        title: 'unless',
-        description: 'Inverse conditional (if not).',
-        example: 'unless .disabled add .clicked',
-        category: 'command',
-    },
     repeat: {
         title: 'repeat',
         description: 'Loops a specified number of times or over items.',
@@ -365,19 +333,19 @@ const HOVER_DOCS = {
     call: {
         title: 'call',
         description: 'Calls a function or method.',
-        example: 'call myFunction()\ncall element.focus()',
+        example: 'call myFunction()\ncall me.focus()',
         category: 'command',
     },
     focus: {
         title: 'focus',
         description: 'Focuses an element (calls HTMLElement.focus()).',
-        example: 'focus #search\nfocus on <input/>',
+        example: 'focus #search\nfocus the first <input/>',
         category: 'command',
     },
     blur: {
         title: 'blur',
         description: 'Removes focus from an element (calls HTMLElement.blur()).',
-        example: 'blur #search\nblur on <input/>',
+        example: 'blur #search\nblur me',
         category: 'command',
     },
     return: {
@@ -412,32 +380,38 @@ const HOVER_DOCS = {
     },
     tell: {
         title: 'tell',
-        description: 'Sets context for subsequent commands.',
-        example: 'tell #modal to show',
-        category: 'command',
-    },
-    copy: {
-        title: 'copy',
-        description: 'Copies text to clipboard.',
-        example: 'copy "Hello" to clipboard\ncopy the value of #input',
+        description: 'Runs commands with another element as `you` (and the implicit target).',
+        example: 'tell #modal show end',
         category: 'command',
     },
     pick: {
         title: 'pick',
-        description: 'Opens a file picker dialog.',
-        example: 'pick file then log it',
+        description: 'Picks a range of items or characters, or a regex match, out of a value.',
+        example: 'pick items 0 to 2 from :list\npick characters 0 to 3 from "hello"',
+        category: 'command',
+    },
+    'beep!': {
+        title: 'beep!',
+        description: 'Logs values to the console with their types, for debugging. Also an expression: `get beep! x` logs x and passes it on.',
+        example: 'beep! me\nbeep! :count, result',
+        category: 'command',
+    },
+    ask: {
+        title: 'ask',
+        description: 'Asks the user for text (`window.prompt`); the answer is in `it`.',
+        example: 'ask "Your name?" then put it into #name',
         category: 'command',
     },
-    beep: {
-        title: 'beep',
-        description: 'Highlights element for debugging.',
-        example: 'beep! me\nbeep! #target',
+    answer: {
+        title: 'answer',
+        description: 'Shows a message (`window.alert`), or with `with a or b` asks to confirm and puts the chosen value in `it`.',
+        example: 'answer "Saved"\nanswer "Delete it?" with "yes" or "no"',
         category: 'command',
     },
     breakpoint: {
         title: 'breakpoint',
         description: 'Emits a `debugger;` statement \u2014 pauses in DevTools when attached.',
-        example: 'breakpoint\non click breakpoint',
+        example: 'breakpoint\nlog "after"',
         category: 'command',
     },
     js: {
@@ -486,7 +460,7 @@ const HOVER_DOCS = {
         title: 'install',
         description: 'Installs a behavior on an element.',
         example: 'install Draggable',
-        category: 'command',
+        category: 'feature',
     },
     me: {
         title: 'me',
@@ -560,6 +534,42 @@ const HOVER_DOCS = {
         example: 'init\n  set :count to 0\nend',
         category: 'feature',
     },
+    when: {
+        title: 'when',
+        description: 'Runs commands whenever the value of an expression changes; the new value is in `it`.',
+        example: 'when $count changes\n  put it into me\nend',
+        category: 'feature',
+    },
+    live: {
+        title: 'live',
+        description: 'Runs commands now, and again whenever anything they read changes.',
+        example: 'live\n  put $count into me\nend',
+        category: 'feature',
+    },
+    worker: {
+        title: 'worker',
+        description: 'Defines functions that run in a Web Worker (upstream extension `ext/worker.js`; not in @hyperfixi/engine).',
+        example: 'worker Calculator\n  def add(a, b)\n    return a + b\n  end\nend',
+        category: 'feature',
+    },
+    socket: {
+        title: 'socket',
+        description: 'Opens a WebSocket and handles its messages (upstream extension `ext/socket.js`; not in @hyperfixi/engine).',
+        example: 'socket Chat ws://localhost:8080/chat\n  on message as json\n    log message\nend',
+        category: 'feature',
+    },
+    eventsource: {
+        title: 'eventsource',
+        description: 'Subscribes to server-sent events (upstream extension `ext/eventsource.js`; not in @hyperfixi/engine).',
+        example: 'eventsource Updates from /events\n  on update as json\n    log it\n  end\nend',
+        category: 'feature',
+    },
+    bind: {
+        title: 'bind',
+        description: 'Keeps two values in sync, in both directions.',
+        example: "bind $name and #input's value",
+        category: 'feature',
+    },
     then: {
         title: 'then',
         description: 'Chains commands sequentially.',
@@ -593,7 +603,7 @@ const HOVER_DOCS = {
     with: {
         title: 'with',
         description: 'Specifies accompanying options or data.',
-        example: 'show me with *opacity\nrender #template with {name: "World"}',
+        example: 'show me with *opacity\nrender #template with name: "World"',
         category: 'block',
     },
     as: {
@@ -722,22 +732,16 @@ const HOVER_DOCS = {
         example: "if name is 'Alice' ignoring case\nif str starts with 'hi' ignoring case",
         category: 'logical',
     },
-    has: {
-        title: 'has',
-        description: 'Checks if element has a class/attribute.',
-        example: 'if me has .active',
-        category: 'logical',
-    },
     where: {
         title: 'where',
         description: 'Filter a collection by a per-element predicate. `it` is bound to each element during evaluation.',
-        example: 'set :actives to :items where it has .active\n:names where it starts with "A"',
+        example: 'set :actives to :items where it matches .active\n:names where it starts with "A"',
         category: 'logical',
     },
     'sorted by': {
         title: 'sorted by',
-        description: 'Sort a collection by a per-element key expression. Optional trailing `asc` / `desc` / `ascending` / `descending`; default is ascending.',
-        example: 'set :byName to :users sorted by it.name\n:scores sorted by it desc',
+        description: 'Sort a collection by a per-element key expression. Optional trailing `ascending` / `descending`; default is ascending.',
+        example: 'set :byName to :users sorted by it.name\n:scores sorted by it descending',
         category: 'logical',
     },
     'mapped to': {
@@ -755,7 +759,7 @@ const HOVER_DOCS = {
     'joined by': {
         title: 'joined by',
         description: 'Join an array into a string with a separator.',
-        example: 'set :csv to :parts joined by ","\n(:names sorted by it) joined by " and "',
+        example: 'set :csv to :parts joined by ","\n:names joined by " and "',
         category: 'logical',
     },
     '#if': {
@@ -810,7 +814,7 @@ const HOVER_DOCS = {
     '^': {
         title: '^var',
         description: 'Reactive prefix \u2014 `^name` reads from (or writes to) the nearest ancestor that has `name` set. `set ^name to value` writes through to the owner; if no owner is found, the write lands at the current `dom-scope` boundary. Tracked: any reactive effect that reads `^name` re-runs when it changes.',
-        example: 'set ^count to 0\nincrement ^count\nlog ^count\n-- target a specific element\nset ^user to attrs.data on closest .root',
+        example: 'set ^count to 0\nincrement ^count\nlog ^count',
         category: 'reactive',
         since: '2.0',
     },

package/dist/lsp-metadata.d.ts

@@ -1,13 +1,13 @@
-export declare const COMMAND_KEYWORDS: readonly ["toggle", "add", "remove", "show", "hide", "put", "set", "get", "make", "empty", "open", "close", "select", "reset", "swap", "morph", "append", "prepend", "take", "render", "scroll", "process", "wait", "fetch", "settle", "send", "trigger", "go", "push", "replace", "if", "else", "unless", "repeat", "for", "while", "break", "continue", "call", "return", "throw", "halt", "exit", "focus", "blur", "log", "tell", "copy", "pick", "beep", "breakpoint", "js", "transition", "measure", "start", "increment", "decrement", "default", "clear", "install"];
+export declare const COMMAND_KEYWORDS: readonly ["toggle", "add", "remove", "show", "hide", "put", "set", "get", "make", "empty", "open", "close", "select", "reset", "swap", "morph", "append", "take", "render", "scroll", "wait", "fetch", "settle", "send", "trigger", "go", "if", "else", "repeat", "for", "while", "break", "continue", "call", "return", "throw", "halt", "exit", "focus", "blur", "log", "tell", "pick", "beep!", "breakpoint", "ask", "answer", "js", "transition", "measure", "start", "increment", "decrement", "default", "clear"];
 export declare const REFERENCE_KEYWORDS: readonly ["me", "you", "it", "result", "event", "target", "detail", "body", "window", "document"];
-export declare const FEATURE_KEYWORDS: readonly ["on", "behavior", "def", "init", "worker", "socket", "eventsource"];
+export declare const FEATURE_KEYWORDS: readonly ["on", "behavior", "def", "init", "install", "when", "live", "bind", "worker", "socket", "eventsource"];
 export declare const BLOCK_KEYWORDS: readonly ["then", "end", "from", "to", "into", "with", "as", "in"];
 export declare const DIRECTIVE_KEYWORDS: readonly ["#if", "#else", "#end", "#for", "#continue"];
 export declare const COMPONENT_KEYWORDS: readonly ["attrs", "dom-scope"];
 export declare const REACTIVE_SIGILS: readonly ["^"];
 export declare const POSITIONAL_KEYWORDS: readonly ["first", "last", "next", "previous", "closest", "parent", "children", "random"];
-export declare const LOGICAL_KEYWORDS: readonly ["and", "or", "not", "is", "are", "exists", "empty", "matches", "contains", "includes", "has", "no", "true", "false", "null", "starts with", "ends with", "between", "ignoring case", "where", "sorted by", "mapped to", "split by", "joined by"];
-export declare const ALL_KEYWORDS: readonly ["toggle", "add", "remove", "show", "hide", "put", "set", "get", "make", "empty", "open", "close", "select", "reset", "swap", "morph", "append", "prepend", "take", "render", "scroll", "process", "wait", "fetch", "settle", "send", "trigger", "go", "push", "replace", "if", "else", "unless", "repeat", "for", "while", "break", "continue", "call", "return", "throw", "halt", "exit", "focus", "blur", "log", "tell", "copy", "pick", "beep", "breakpoint", "js", "transition", "measure", "start", "increment", "decrement", "default", "clear", "install", "me", "you", "it", "result", "event", "target", "detail", "body", "window", "document", "on", "behavior", "def", "init", "worker", "socket", "eventsource", "then", "end", "from", "to", "into", "with", "as", "in", "first", "last", "next", "previous", "closest", "parent", "children", "random", "and", "or", "not", "is", "are", "exists", "empty", "matches", "contains", "includes", "has", "no", "true", "false", "null", "starts with", "ends with", "between", "ignoring case", "where", "sorted by", "mapped to", "split by", "joined by", "#if", "#else", "#end", "#for", "#continue", "attrs", "dom-scope"];
+export declare const LOGICAL_KEYWORDS: readonly ["and", "or", "not", "is", "are", "exists", "empty", "matches", "contains", "includes", "no", "true", "false", "null", "starts with", "ends with", "between", "ignoring case", "where", "sorted by", "mapped to", "split by", "joined by"];
+export declare const ALL_KEYWORDS: readonly ["toggle", "add", "remove", "show", "hide", "put", "set", "get", "make", "empty", "open", "close", "select", "reset", "swap", "morph", "append", "take", "render", "scroll", "wait", "fetch", "settle", "send", "trigger", "go", "if", "else", "repeat", "for", "while", "break", "continue", "call", "return", "throw", "halt", "exit", "focus", "blur", "log", "tell", "pick", "beep!", "breakpoint", "ask", "answer", "js", "transition", "measure", "start", "increment", "decrement", "default", "clear", "me", "you", "it", "result", "event", "target", "detail", "body", "window", "document", "on", "behavior", "def", "init", "install", "when", "live", "bind", "worker", "socket", "eventsource", "then", "end", "from", "to", "into", "with", "as", "in", "first", "last", "next", "previous", "closest", "parent", "children", "random", "and", "or", "not", "is", "are", "exists", "empty", "matches", "contains", "includes", "no", "true", "false", "null", "starts with", "ends with", "between", "ignoring case", "where", "sorted by", "mapped to", "split by", "joined by", "#if", "#else", "#end", "#for", "#continue", "attrs", "dom-scope"];
 export interface HoverDoc {
     title: string;
     description: string;

package/dist/lsp-metadata.mjs

@@ -16,22 +16,17 @@ const COMMAND_KEYWORDS = [
     'swap',
     'morph',
     'append',
-    'prepend',
     'take',
     'render',
     'scroll',
-    'process',
     'wait',
     'fetch',
     'settle',
     'send',
     'trigger',
     'go',
-    'push',
-    'replace',
     'if',
     'else',
-    'unless',
     'repeat',
     'for',
     'while',
@@ -46,10 +41,11 @@ const COMMAND_KEYWORDS = [
     'blur',
     'log',
     'tell',
-    'copy',
     'pick',
-    'beep',
+    'beep!',
     'breakpoint',
+    'ask',
+    'answer',
     'js',
     'transition',
     'measure',
@@ -58,7 +54,6 @@ const COMMAND_KEYWORDS = [
     'decrement',
     'default',
     'clear',
-    'install',
 ];
 const REFERENCE_KEYWORDS = [
     'me',
@@ -77,6 +72,10 @@ const FEATURE_KEYWORDS = [
     'behavior',
     'def',
     'init',
+    'install',
+    'when',
+    'live',
+    'bind',
     'worker',
     'socket',
     'eventsource',
@@ -106,7 +105,6 @@ const LOGICAL_KEYWORDS = [
     'matches',
     'contains',
     'includes',
-    'has',
     'no',
     'true',
     'false',
@@ -164,8 +162,8 @@ const HOVER_DOCS = {
     },
     put: {
         title: 'put',
-        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',
+        description: 'Puts a value into, before, after, or at the start or end of an element or variable.',
+        example: 'put "Hello" into #message\nput response at end of #results',
         category: 'command',
     },
     set: {
@@ -234,12 +232,6 @@ const HOVER_DOCS = {
         example: 'append "<li>Item</li>" to #list',
         category: 'command',
     },
-    prepend: {
-        title: 'prepend',
-        description: 'Prepends content to an element (hyperfixi extension).',
-        example: 'prepend "<li>Item</li>" to #list',
-        category: 'command',
-    },
     take: {
         title: 'take',
         description: 'Takes/claims a class from sibling elements.',
@@ -249,7 +241,7 @@ const HOVER_DOCS = {
     render: {
         title: 'render',
         description: 'Renders a template with data.',
-        example: 'render #template with {name: "World"}',
+        example: 'render #template with name: "World"',
         category: 'command',
     },
     scroll: {
@@ -258,12 +250,6 @@ const HOVER_DOCS = {
         example: 'scroll to #section\nscroll to the top of me\nscroll down by 200',
         category: 'command',
     },
-    process: {
-        title: 'process',
-        description: 'Processes hyperscript/partials in freshly-inserted content.',
-        example: 'process partials in result',
-        category: 'command',
-    },
     wait: {
         title: 'wait',
         description: 'Pauses execution for a duration or until an event.',
@@ -300,18 +286,6 @@ const HOVER_DOCS = {
         example: 'go to url /home\ngo to #section\ngo back',
         category: 'command',
     },
-    push: {
-        title: 'push',
-        description: 'Pushes a URL onto the browser history stack.',
-        example: 'push url "/page/2"',
-        category: 'command',
-    },
-    replace: {
-        title: 'replace',
-        description: 'Replaces the current browser history entry.',
-        example: 'replace url "/page/2"',
-        category: 'command',
-    },
     if: {
         title: 'if',
         description: 'Conditional execution.',
@@ -324,12 +298,6 @@ const HOVER_DOCS = {
         example: 'if .active remove .active else add .active',
         category: 'block',
     },
-    unless: {
-        title: 'unless',
-        description: 'Inverse conditional (if not).',
-        example: 'unless .disabled add .clicked',
-        category: 'command',
-    },
     repeat: {
         title: 'repeat',
         description: 'Loops a specified number of times or over items.',
@@ -363,19 +331,19 @@ const HOVER_DOCS = {
     call: {
         title: 'call',
         description: 'Calls a function or method.',
-        example: 'call myFunction()\ncall element.focus()',
+        example: 'call myFunction()\ncall me.focus()',
         category: 'command',
     },
     focus: {
         title: 'focus',
         description: 'Focuses an element (calls HTMLElement.focus()).',
-        example: 'focus #search\nfocus on <input/>',
+        example: 'focus #search\nfocus the first <input/>',
         category: 'command',
     },
     blur: {
         title: 'blur',
         description: 'Removes focus from an element (calls HTMLElement.blur()).',
-        example: 'blur #search\nblur on <input/>',
+        example: 'blur #search\nblur me',
         category: 'command',
     },
     return: {
@@ -410,32 +378,38 @@ const HOVER_DOCS = {
     },
     tell: {
         title: 'tell',
-        description: 'Sets context for subsequent commands.',
-        example: 'tell #modal to show',
-        category: 'command',
-    },
-    copy: {
-        title: 'copy',
-        description: 'Copies text to clipboard.',
-        example: 'copy "Hello" to clipboard\ncopy the value of #input',
+        description: 'Runs commands with another element as `you` (and the implicit target).',
+        example: 'tell #modal show end',
         category: 'command',
     },
     pick: {
         title: 'pick',
-        description: 'Opens a file picker dialog.',
-        example: 'pick file then log it',
+        description: 'Picks a range of items or characters, or a regex match, out of a value.',
+        example: 'pick items 0 to 2 from :list\npick characters 0 to 3 from "hello"',
+        category: 'command',
+    },
+    'beep!': {
+        title: 'beep!',
+        description: 'Logs values to the console with their types, for debugging. Also an expression: `get beep! x` logs x and passes it on.',
+        example: 'beep! me\nbeep! :count, result',
+        category: 'command',
+    },
+    ask: {
+        title: 'ask',
+        description: 'Asks the user for text (`window.prompt`); the answer is in `it`.',
+        example: 'ask "Your name?" then put it into #name',
         category: 'command',
     },
-    beep: {
-        title: 'beep',
-        description: 'Highlights element for debugging.',
-        example: 'beep! me\nbeep! #target',
+    answer: {
+        title: 'answer',
+        description: 'Shows a message (`window.alert`), or with `with a or b` asks to confirm and puts the chosen value in `it`.',
+        example: 'answer "Saved"\nanswer "Delete it?" with "yes" or "no"',
         category: 'command',
     },
     breakpoint: {
         title: 'breakpoint',
         description: 'Emits a `debugger;` statement \u2014 pauses in DevTools when attached.',
-        example: 'breakpoint\non click breakpoint',
+        example: 'breakpoint\nlog "after"',
         category: 'command',
     },
     js: {
@@ -484,7 +458,7 @@ const HOVER_DOCS = {
         title: 'install',
         description: 'Installs a behavior on an element.',
         example: 'install Draggable',
-        category: 'command',
+        category: 'feature',
     },
     me: {
         title: 'me',
@@ -558,6 +532,42 @@ const HOVER_DOCS = {
         example: 'init\n  set :count to 0\nend',
         category: 'feature',
     },
+    when: {
+        title: 'when',
+        description: 'Runs commands whenever the value of an expression changes; the new value is in `it`.',
+        example: 'when $count changes\n  put it into me\nend',
+        category: 'feature',
+    },
+    live: {
+        title: 'live',
+        description: 'Runs commands now, and again whenever anything they read changes.',
+        example: 'live\n  put $count into me\nend',
+        category: 'feature',
+    },
+    worker: {
+        title: 'worker',
+        description: 'Defines functions that run in a Web Worker (upstream extension `ext/worker.js`; not in @hyperfixi/engine).',
+        example: 'worker Calculator\n  def add(a, b)\n    return a + b\n  end\nend',
+        category: 'feature',
+    },
+    socket: {
+        title: 'socket',
+        description: 'Opens a WebSocket and handles its messages (upstream extension `ext/socket.js`; not in @hyperfixi/engine).',
+        example: 'socket Chat ws://localhost:8080/chat\n  on message as json\n    log message\nend',
+        category: 'feature',
+    },
+    eventsource: {
+        title: 'eventsource',
+        description: 'Subscribes to server-sent events (upstream extension `ext/eventsource.js`; not in @hyperfixi/engine).',
+        example: 'eventsource Updates from /events\n  on update as json\n    log it\n  end\nend',
+        category: 'feature',
+    },
+    bind: {
+        title: 'bind',
+        description: 'Keeps two values in sync, in both directions.',
+        example: "bind $name and #input's value",
+        category: 'feature',
+    },
     then: {
         title: 'then',
         description: 'Chains commands sequentially.',
@@ -591,7 +601,7 @@ const HOVER_DOCS = {
     with: {
         title: 'with',
         description: 'Specifies accompanying options or data.',
-        example: 'show me with *opacity\nrender #template with {name: "World"}',
+        example: 'show me with *opacity\nrender #template with name: "World"',
         category: 'block',
     },
     as: {
@@ -720,22 +730,16 @@ const HOVER_DOCS = {
         example: "if name is 'Alice' ignoring case\nif str starts with 'hi' ignoring case",
         category: 'logical',
     },
-    has: {
-        title: 'has',
-        description: 'Checks if element has a class/attribute.',
-        example: 'if me has .active',
-        category: 'logical',
-    },
     where: {
         title: 'where',
         description: 'Filter a collection by a per-element predicate. `it` is bound to each element during evaluation.',
-        example: 'set :actives to :items where it has .active\n:names where it starts with "A"',
+        example: 'set :actives to :items where it matches .active\n:names where it starts with "A"',
         category: 'logical',
     },
     'sorted by': {
         title: 'sorted by',
-        description: 'Sort a collection by a per-element key expression. Optional trailing `asc` / `desc` / `ascending` / `descending`; default is ascending.',
-        example: 'set :byName to :users sorted by it.name\n:scores sorted by it desc',
+        description: 'Sort a collection by a per-element key expression. Optional trailing `ascending` / `descending`; default is ascending.',
+        example: 'set :byName to :users sorted by it.name\n:scores sorted by it descending',
         category: 'logical',
     },
     'mapped to': {
@@ -753,7 +757,7 @@ const HOVER_DOCS = {
     'joined by': {
         title: 'joined by',
         description: 'Join an array into a string with a separator.',
-        example: 'set :csv to :parts joined by ","\n(:names sorted by it) joined by " and "',
+        example: 'set :csv to :parts joined by ","\n:names joined by " and "',
         category: 'logical',
     },
     '#if': {
@@ -808,7 +812,7 @@ const HOVER_DOCS = {
     '^': {
         title: '^var',
         description: 'Reactive prefix \u2014 `^name` reads from (or writes to) the nearest ancestor that has `name` set. `set ^name to value` writes through to the owner; if no owner is found, the write lands at the current `dom-scope` boundary. Tracked: any reactive effect that reads `^name` re-runs when it changes.',
-        example: 'set ^count to 0\nincrement ^count\nlog ^count\n-- target a specific element\nset ^user to attrs.data on closest .root',
+        example: 'set ^count to 0\nincrement ^count\nlog ^count',
         category: 'reactive',
         since: '2.0',
     },