@stacksjs/stx-vscode 0.2.574 → 0.2.575

package/dist/typescript-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksjs/stx-typescript-plugin",
-  "version": "0.2.574",
+  "version": "0.2.575",
   "private": true,
   "main": "index.js"
 }

package/dist/typescript-plugin/types/stx-module.d.ts

@@ -71,6 +71,7 @@ declare module 'stx' {
   export const setResponseHeader: (name: string, value: string) => void // <script server> only
   export const setResponseStatus: (status: number) => void // <script server> only
   export const setRouteParams: typeof globalThis.setRouteParams
+  export const sharedRequest: typeof globalThis.sharedRequest
   export const state: typeof globalThis.state
   export const untrack: typeof globalThis.untrack
   export const useAsync: typeof globalThis.useAsync
@@ -113,6 +114,7 @@ declare module 'stx' {
   export const useServerRuntimeConfig: () => Readonly<{ public: Record<string, any>, private: Record<string, any> }> // <script server> only
   export const useSessionStorage: typeof globalThis.useSessionStorage
   export const keptState: typeof globalThis.keptState
+  export const memo: typeof globalThis.memo
   export const forgetKeptState: typeof globalThis.forgetKeptState
   export const setKeptScope: typeof globalThis.setKeptScope
   export const flushKeptState: typeof globalThis.flushKeptState

package/dist/typescript-plugin/types/stx.d.ts

@@ -68,9 +68,18 @@ type StxCleanup = () => void
 // ============================================================================
 
 declare function state<T>(_initial: T): StxSignal<T>
-declare function derived<T>(_compute: () => T): StxDerivedSignal<T>
+/**
+ * A computed value. With `equals`, a change upstream recomputes it at once
+ * (while anything reads it) and reaches its readers only when
+ * `equals(previous, next)` is false; without it, it is lazy and every upstream
+ * change reaches them.
+ */
+declare function derived<T>(_compute: () => T, _options?: { equals?: (_previous: T, _next: T) => boolean }): StxDerivedSignal<T>
+/** A derived value that reaches its readers only when it changes (`Object.is`, or `equals`). */
+declare function memo<T>(_compute: () => T, _equals?: (_previous: T, _next: T) => boolean): StxDerivedSignal<T>
 declare function effect(_fn: () => void | StxCleanup): StxCleanup
 declare function batch(_fn: () => void): void
+/** Read a signal without subscribing the running effect to it; anything else is returned as it is. */
 declare function untrack<T>(_value: T | StxSignal<T> | StxDerivedSignal<T>): T
 declare function peek<T>(_fn: () => T): T
 declare function isSignal(value: unknown): value is StxSignal<unknown>
@@ -536,6 +545,19 @@ interface StxCachedQuery<T> {
 /** Data kept per account, shown at once from last time and refreshed behind. Same key, same query. */
 declare function cachedQuery<T = any>(_key: string, _options?: StxCachedQueryOptions<T>): StxCachedQuery<T>
 
+/** One request for every caller that wants the same answer: see shared-request.ts. */
+interface StxSharedRequest<K, T> {
+  /** Join a request in flight whose key covers `key` (or a waiting fresh rerun), or start one. */
+  run: (_key: K, _start: () => Promise<T>) => Promise<T>
+  /** Never joins: waits out a request in flight for `key`, then starts once more (one rerun for every caller meanwhile). */
+  fresh: (_key: K, _start: () => Promise<T>) => Promise<T>
+  /** A checker that stays true until latest() is called again. */
+  latest: () => () => boolean
+  /** True while a request is out or a fresh rerun is waiting. */
+  readonly busy: boolean
+}
+declare function sharedRequest<K = string, T = any>(_options?: { covers?: (_running: K, _wanted: K) => boolean }): StxSharedRequest<K, T>
+
 /**
  * Options accepted by the auto-imported `useCookie` global.
  *
@@ -698,10 +720,36 @@ declare function definePageMeta(_meta: Record<string, unknown>): void
 declare function ref<T>(_value: T): StxRef<T>
 declare function reactive<T extends object>(_target: T): T
 declare function computed<T>(_getter: () => T): StxRef<T>
+type StxWatchSource<T> = (() => T) | StxRef<T> | StxSignal<T> | StxDerivedSignal<T>
+interface StxWatchOptions {
+  /** Call back at once with the current value (and no previous one). */
+  immediate?: boolean
+  /** Compare structurally rather than with Object.is (a reactive object source is deep by default). */
+  deep?: boolean
+  /** When to call back: after the next render ('post', the default), on a microtask ('pre') or inside the change ('sync'). */
+  flush?: 'post' | 'pre' | 'sync'
+  /** Stop after the first call. */
+  once?: boolean
+}
+/**
+ * Call back with (next, previous) when the source's value changes - not at
+ * creation unless `immediate`. The source is a signal, derived, getter,
+ * reactive object, or an array of those. Returns a stop function.
+ */
+declare function watch<const S extends readonly StxWatchSource<unknown>[]>(
+  _source: S,
+  _callback: (_value: { [K in keyof S]: S[K] extends StxWatchSource<infer V> ? V : never }, _oldValue: { [K in keyof S]: S[K] extends StxWatchSource<infer V> ? V : never } | undefined, _onCleanup: (_fn: () => void) => void) => void,
+  _options?: StxWatchOptions,
+): StxCleanup
 declare function watch<T>(
-  _source: (() => T) | StxRef<T> | StxSignal<T>,
-  _callback: (value: T, oldValue: T) => void,
-  _options?: { immediate?: boolean, deep?: boolean },
+  _source: StxWatchSource<T>,
+  _callback: (_value: T, _oldValue: T | undefined, _onCleanup: (_fn: () => void) => void) => void,
+  _options?: StxWatchOptions,
+): StxCleanup
+declare function watch<T extends object>(
+  _source: T,
+  _callback: (_value: T, _oldValue: T | undefined, _onCleanup: (_fn: () => void) => void) => void,
+  _options?: StxWatchOptions,
 ): StxCleanup
 declare function watchEffect(_fn: () => void): StxCleanup
 declare function watchMultiple(
@@ -909,6 +957,7 @@ interface StxRuntimeRegistry {
   // Signals
   state: typeof state
   derived: typeof derived
+  memo: typeof memo
   effect: typeof effect
   batch: typeof batch
   untrack: typeof untrack
@@ -980,6 +1029,7 @@ interface StxRuntimeRegistry {
   setKeptScope: typeof setKeptScope
   flushKeptState: typeof flushKeptState
   cachedQuery: typeof cachedQuery
+  sharedRequest: typeof sharedRequest
   useEventListener: typeof useEventListener
   useScrollLock: typeof useScrollLock
   useWebSocket: typeof useWebSocket

package/dist/typescript-plugin/typescript-stx-plugin.js

@@ -7,7 +7,7 @@ var yt=Object.create;var{getPrototypeOf:wt,defineProperty:Ee,getOwnPropertyNames
 `?`
 `:" ",t++}s+=" ",t++,n=W,i="";continue}if(r==="/"&&$e(n,i)){let a=Te(e,t);if(a!==-1){s+=`/${" ".repeat(a-t-2)}/`,t=a,n=W,i="";continue}}if(r==="`"){s+=" ",t++;while(t<e.length&&e[t]!=="`"){if(e[t]==="\\"){s+="  ",t+=2;continue}if(e[t]==="$"&&e[t+1]==="{"){let a=t+2,c=_e(e,a);if(s+="  ",s+=L(e.slice(a,c)),c<e.length)s+=" ";t=c+1;continue}s+=e[t]===`
 `?`
-`:" ",t++}s+=" ",t++,n=W,i="";continue}if(s+=r,t++,/[\w$]/.test(r))i=/[\w$]/.test(n)?i+r:r,n=r;else if(!/\s/.test(r))n=r,i=""}return s}function Q(e){let s=new Uint16Array(e.length),t=0,n=!0;for(let i=0;i<e.length;i++){let o=e[i];if(o===")"||o==="]"||o==="}")if(t===0)n=!1;else t--;if(s[i]=t,o==="("||o==="["||o==="{")t++}return{depths:s,balanced:n&&t===0}}function Ce(e){let s=e.indexOf(" as ");if(s!==-1){let o=e.slice(0,s).trim(),r=e.slice(s+4).trim();return o&&r?{arrayExpr:o,itemVar:r}:null}let t=/^\s*(.+?)\s+in\s+([\s\S]+)$/.exec(e);if(!t)return null;let n=t[1].trim().replace(/^\(([\s\S]*)\)$/,"$1").trim(),i=t[2].trim();return n&&i?{arrayExpr:i,itemVar:n}:null}var G=["batch","cachedQuery","clearServerData","computed","configureFetch","defineEmits","defineExpose","definePageMeta","defineProps","defineSlots","defineStore","derived","effect","flushKeptState","forgetKeptState","goBack","goForward","inject","invalidateRoute","isDerived","isSignal","keptState","navigate","nextTick","onBeforeMount","onBeforeUnmount","onDestroy","onMount","onMounted","onUnmounted","peek","provide","reactive","ref","refDebounced","refresh","registerStoresClient","setKeptScope","setRouteParams","state","untrack","useAsync","useClickOutside","useColorMode","useCookie","useCounter","useDark","useDebounce","useDebounceFn","useDebouncedValue","useDocumentVisibility","useEventListener","useFetch","useFocus","useHead","useId","useInterval","useLocalStorage","useMediaQuery","useModel","useMutation","useOptimistic","usePreferredContrast","usePreferredDark","usePreferredLight","usePreferredReducedMotion","useQuery","useReactiveProp","useRef","useRoute","useRouteParam","useRouteParams","useScrollLock","useSearchParams","useSeoMeta","useSessionStorage","useSlots","useStore","useThrottle","useThrottleFn","useTimeout","useTimeoutFn","useToggle","useWebSocket","watch","watchEffect","watchMultiple","withDefaults"];var At=["defineEmits","defineExpose","definePageMeta","defineProps","defineSlots","withDefaults"];var Cn=G.filter((e)=>!At.includes(e));var Rt=["x-text","x-html","x-model","x-show","x-if","x-for","x-cloak","x-ref","x-data","x-bind","x-class","x-style","x-tooltip","x-tooltip-position"],Dt=["x-init","x-transition","x-effect","x-on"],kn=[...Rt,...Dt];var J=V(require("node:fs"),1),K=V(require("node:path"),1);function ke(e,s,t,n){let i=0;for(let o=s;o<e.length;o++)if(e[o]===t)i++;else if(e[o]===n&&!(n===">"&&e[o-1]==="=")){if(--i===0)return o}return-1}function Pt(e){let s=L(e),t=0,n=0,i=[];for(let o=0;o<s.length;o++)if("([{".includes(s[o]))t++;else if(")]}".includes(s[o]))t--;else if(s[o]===","&&t===0)i.push(e.slice(n,o).trim()),n=o+1;return i.push(e.slice(n).trim()),i}function ce(e,s){let t=L(e),n=new RegExp(`\\b(?:${s.map((i)=>i.replace(/[$]/g,"\\$&")).join("|")})\\s*(?=[<(])`,"g");for(let i of t.matchAll(n)){let o=i.index+i[0].length,r="";if(t[o]==="<"){let c=ke(t,o,"<",">");if(c<0)continue;r=e.slice(o+1,c),o=c+1;while(/\s/.test(t[o]||"")&&o<t.length)o++}if(t[o]!=="(")continue;let a=ke(t,o,"(",")");if(a>=0)return{type:r,args:Pt(e.slice(o+1,a))}}return null}var Ae=`
+`:" ",t++}s+=" ",t++,n=W,i="";continue}if(s+=r,t++,/[\w$]/.test(r))i=/[\w$]/.test(n)?i+r:r,n=r;else if(!/\s/.test(r))n=r,i=""}return s}function Q(e){let s=new Uint16Array(e.length),t=0,n=!0;for(let i=0;i<e.length;i++){let o=e[i];if(o===")"||o==="]"||o==="}")if(t===0)n=!1;else t--;if(s[i]=t,o==="("||o==="["||o==="{")t++}return{depths:s,balanced:n&&t===0}}function Ce(e){let s=e.indexOf(" as ");if(s!==-1){let o=e.slice(0,s).trim(),r=e.slice(s+4).trim();return o&&r?{arrayExpr:o,itemVar:r}:null}let t=/^\s*(.+?)\s+in\s+([\s\S]+)$/.exec(e);if(!t)return null;let n=t[1].trim().replace(/^\(([\s\S]*)\)$/,"$1").trim(),i=t[2].trim();return n&&i?{arrayExpr:i,itemVar:n}:null}var G=["batch","cachedQuery","clearServerData","computed","configureFetch","defineEmits","defineExpose","definePageMeta","defineProps","defineSlots","defineStore","derived","effect","flushKeptState","forgetKeptState","goBack","goForward","inject","invalidateRoute","isDerived","isSignal","keptState","memo","navigate","nextTick","onBeforeMount","onBeforeUnmount","onDestroy","onMount","onMounted","onUnmounted","peek","provide","reactive","ref","refDebounced","refresh","registerStoresClient","setKeptScope","setRouteParams","sharedRequest","state","untrack","useAsync","useClickOutside","useColorMode","useCookie","useCounter","useDark","useDebounce","useDebounceFn","useDebouncedValue","useDocumentVisibility","useEventListener","useFetch","useFocus","useHead","useId","useInterval","useLocalStorage","useMediaQuery","useModel","useMutation","useOptimistic","usePreferredContrast","usePreferredDark","usePreferredLight","usePreferredReducedMotion","useQuery","useReactiveProp","useRef","useRoute","useRouteParam","useRouteParams","useScrollLock","useSearchParams","useSeoMeta","useSessionStorage","useSlots","useStore","useThrottle","useThrottleFn","useTimeout","useTimeoutFn","useToggle","useWebSocket","watch","watchEffect","watchMultiple","withDefaults"];var At=["defineEmits","defineExpose","definePageMeta","defineProps","defineSlots","withDefaults"];var Cn=G.filter((e)=>!At.includes(e));var Rt=["x-text","x-html","x-model","x-show","x-if","x-for","x-cloak","x-ref","x-data","x-bind","x-class","x-style","x-tooltip","x-tooltip-position"],Dt=["x-init","x-transition","x-effect","x-on"],kn=[...Rt,...Dt];var J=V(require("node:fs"),1),K=V(require("node:path"),1);function ke(e,s,t,n){let i=0;for(let o=s;o<e.length;o++)if(e[o]===t)i++;else if(e[o]===n&&!(n===">"&&e[o-1]==="=")){if(--i===0)return o}return-1}function Pt(e){let s=L(e),t=0,n=0,i=[];for(let o=0;o<s.length;o++)if("([{".includes(s[o]))t++;else if(")]}".includes(s[o]))t--;else if(s[o]===","&&t===0)i.push(e.slice(n,o).trim()),n=o+1;return i.push(e.slice(n).trim()),i}function ce(e,s){let t=L(e),n=new RegExp(`\\b(?:${s.map((i)=>i.replace(/[$]/g,"\\$&")).join("|")})\\s*(?=[<(])`,"g");for(let i of t.matchAll(n)){let o=i.index+i[0].length,r="";if(t[o]==="<"){let c=ke(t,o,"<",">");if(c<0)continue;r=e.slice(o+1,c),o=c+1;while(/\s/.test(t[o]||"")&&o<t.length)o++}if(t[o]!=="(")continue;let a=ke(t,o,"(",")");if(a>=0)return{type:r,args:Pt(e.slice(o+1,a))}}return null}var Ae=`
 type __StxCtor<T> = T extends StringConstructor ? string : T extends NumberConstructor ? number : T extends BooleanConstructor ? boolean : T extends ArrayConstructor ? unknown[] : T extends ObjectConstructor ? object : T extends readonly unknown[] ? __StxCtor<T[number]> : T extends abstract new (...args: any[]) => infer V ? V : unknown;
 type __StxWiden<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T;
 type __StxOption<T> = T extends { type: infer C } ? __StxCtor<C> : T extends { default: infer D } ? D extends (...args: any[]) => infer V ? V : __StxWiden<D> : __StxCtor<T>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx-vscode",
   "type": "module",
-  "version": "0.2.574",
+  "version": "0.2.575",
   "description": "stx language support for VS Code extensions to embed: the hovers, completions, diagnostics, grammar, snippets, language configuration and TypeScript server plugin behind the stx extension.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",