feat: Complete fleet — 94 skills across 10+ domains
Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
165
skills/vueuse-functions/references/until.md
Normal file
165
skills/vueuse-functions/references/until.md
Normal file
@@ -0,0 +1,165 @@
|
||||
---
|
||||
category: Watch
|
||||
---
|
||||
|
||||
# until
|
||||
|
||||
Promised one-time watch for changes
|
||||
|
||||
## Usage
|
||||
|
||||
#### Wait for some async data to be ready
|
||||
|
||||
```ts
|
||||
import { until, useAsyncState } from '@vueuse/core'
|
||||
|
||||
const { state, isReady } = useAsyncState(
|
||||
fetch('https://jsonplaceholder.typicode.com/todos/1').then(t => t.json()),
|
||||
{},
|
||||
)
|
||||
|
||||
;(async () => {
|
||||
await until(isReady).toBe(true)
|
||||
|
||||
console.log(state) // state is now ready!
|
||||
})()
|
||||
```
|
||||
|
||||
#### Wait for custom conditions
|
||||
|
||||
> You can use `invoke` to call the async function.
|
||||
|
||||
```ts
|
||||
import { invoke, until, useCounter } from '@vueuse/core'
|
||||
|
||||
const { count } = useCounter()
|
||||
|
||||
invoke(async () => {
|
||||
await until(count).toMatch(v => v > 7)
|
||||
|
||||
alert('Counter is now larger than 7!')
|
||||
})
|
||||
```
|
||||
|
||||
#### Timeout
|
||||
|
||||
```ts
|
||||
import { until } from '@vueuse/core'
|
||||
// ---cut---
|
||||
// will be resolve until ref.value === true or 1000ms passed
|
||||
await until(ref).toBe(true, { timeout: 1000 })
|
||||
|
||||
// will throw if timeout
|
||||
try {
|
||||
await until(ref).toBe(true, { timeout: 1000, throwOnTimeout: true })
|
||||
// ref.value === true
|
||||
}
|
||||
catch (e) {
|
||||
// timeout
|
||||
}
|
||||
```
|
||||
|
||||
#### More Examples
|
||||
|
||||
```ts
|
||||
import { until } from '@vueuse/core'
|
||||
// ---cut---
|
||||
await until(ref).toBe(true)
|
||||
await until(ref).toMatch(v => v > 10 && v < 100)
|
||||
await until(ref).changed()
|
||||
await until(ref).changedTimes(10)
|
||||
await until(ref).toBeTruthy()
|
||||
await until(ref).toBeNull()
|
||||
|
||||
await until(ref).not.toBeNull()
|
||||
await until(ref).not.toBeTruthy()
|
||||
```
|
||||
|
||||
## Type Declarations
|
||||
|
||||
```ts
|
||||
export interface UntilToMatchOptions {
|
||||
/**
|
||||
* Milliseconds timeout for promise to resolve/reject if the when condition does not meet.
|
||||
* 0 for never timed out
|
||||
*
|
||||
* @default 0
|
||||
*/
|
||||
timeout?: number
|
||||
/**
|
||||
* Reject the promise when timeout
|
||||
*
|
||||
* @default false
|
||||
*/
|
||||
throwOnTimeout?: boolean
|
||||
/**
|
||||
* `flush` option for internal watch
|
||||
*
|
||||
* @default 'sync'
|
||||
*/
|
||||
flush?: WatchOptionFlush
|
||||
/**
|
||||
* `deep` option for internal watch
|
||||
*
|
||||
* @default 'false'
|
||||
*/
|
||||
deep?: WatchOptions["deep"]
|
||||
}
|
||||
export interface UntilBaseInstance<T, Not extends boolean = false> {
|
||||
toMatch: (<U extends T = T>(
|
||||
condition: (v: T) => v is U,
|
||||
options?: UntilToMatchOptions,
|
||||
) => Not extends true ? Promise<Exclude<T, U>> : Promise<U>) &
|
||||
((
|
||||
condition: (v: T) => boolean,
|
||||
options?: UntilToMatchOptions,
|
||||
) => Promise<T>)
|
||||
changed: (options?: UntilToMatchOptions) => Promise<T>
|
||||
changedTimes: (n?: number, options?: UntilToMatchOptions) => Promise<T>
|
||||
}
|
||||
type Falsy = false | void | null | undefined | 0 | 0n | ""
|
||||
export interface UntilValueInstance<T, Not extends boolean = false>
|
||||
extends UntilBaseInstance<T, Not> {
|
||||
readonly not: UntilValueInstance<T, Not extends true ? false : true>
|
||||
toBe: <P = T>(
|
||||
value: MaybeRefOrGetter<P>,
|
||||
options?: UntilToMatchOptions,
|
||||
) => Not extends true ? Promise<T> : Promise<P>
|
||||
toBeTruthy: (
|
||||
options?: UntilToMatchOptions,
|
||||
) => Not extends true ? Promise<T & Falsy> : Promise<Exclude<T, Falsy>>
|
||||
toBeNull: (
|
||||
options?: UntilToMatchOptions,
|
||||
) => Not extends true ? Promise<Exclude<T, null>> : Promise<null>
|
||||
toBeUndefined: (
|
||||
options?: UntilToMatchOptions,
|
||||
) => Not extends true ? Promise<Exclude<T, undefined>> : Promise<undefined>
|
||||
toBeNaN: (options?: UntilToMatchOptions) => Promise<T>
|
||||
}
|
||||
export interface UntilArrayInstance<T> extends UntilBaseInstance<T> {
|
||||
readonly not: UntilArrayInstance<T>
|
||||
toContains: (
|
||||
value: MaybeRefOrGetter<ElementOf<ShallowUnwrapRef<T>>>,
|
||||
options?: UntilToMatchOptions,
|
||||
) => Promise<T>
|
||||
}
|
||||
/**
|
||||
* Promised one-time watch for changes
|
||||
*
|
||||
* @see https://vueuse.org/until
|
||||
* @example
|
||||
* ```
|
||||
* const { count } = useCounter()
|
||||
*
|
||||
* await until(count).toMatch(v => v > 7)
|
||||
*
|
||||
* alert('Counter is now larger than 7!')
|
||||
* ```
|
||||
*/
|
||||
export declare function until<T extends unknown[]>(
|
||||
r: WatchSource<T> | MaybeRefOrGetter<T>,
|
||||
): UntilArrayInstance<T>
|
||||
export declare function until<T>(
|
||||
r: WatchSource<T> | MaybeRefOrGetter<T>,
|
||||
): UntilValueInstance<T>
|
||||
```
|
||||
Reference in New Issue
Block a user