docs(vue): add interactive demo for every composable

A beautiful, SSR-safe demo.vue next to each composable, auto-discovered by the docs extractor and rendered client-only on each composable's page.
2026-06-08 15:51:16 +07:00
parent 59e995d0b5
commit e83f10fe32
214 changed files with 19584 additions and 74 deletions
@@ -0,0 +1,69 @@
+<script setup lang="ts">
+import { ref } from 'vue';
+import { refDefault } from './index';
+
+// Source may legitimately hold null (e.g. "not set yet").
+const raw = ref<string | null>(null);
+
+// Reactive fallback — `name` reads as `fallback` whenever `raw` is null/undefined.
+const fallback = ref('Anonymous');
+const name = refDefault(raw, fallback);
+</script>
+
+<template>
+  <div class="flex w-full max-w-sm flex-col gap-4">
+    <div class="space-y-3 rounded-xl border border-(--border) bg-(--bg-elevated) p-4">
+      <p class="text-xs font-medium uppercase tracking-wide text-(--fg-subtle)">
+        Resolved value
+      </p>
+      <div class="flex items-center justify-between rounded-lg border border-(--border) bg-(--bg-inset) p-3">
+        <span class="font-mono text-lg font-semibold text-(--fg)">{{ name }}</span>
+        <span
+          class="inline-flex items-center gap-1.5 rounded-md border px-2 py-0.5 text-xs font-medium"
+          :class="raw == null
+            ? 'border-amber-500/30 bg-amber-500/10 text-amber-600 dark:text-amber-400'
+            : 'border-(--border) bg-(--bg-elevated) text-(--fg-muted)'"
+        >
+          {{ raw == null ? 'using default' : 'from source' }}
+        </span>
+      </div>
+    </div>
+
+    <label class="flex flex-col gap-1.5">
+      <span class="text-xs font-medium uppercase tracking-wide text-(--fg-subtle)">
+        Source ref (writes pass through)
+      </span>
+      <div class="flex gap-2">
+        <input
+          v-model="name"
+          placeholder="Type a name…"
+          class="w-full rounded-lg border border-(--border) bg-(--bg) px-3 py-2 text-sm text-(--fg) placeholder:text-(--fg-subtle) transition focus:border-(--accent) focus:outline-none focus:ring-2 focus:ring-(--ring)"
+        >
+        <button
+          type="button"
+          class="inline-flex shrink-0 items-center justify-center gap-1.5 rounded-lg border border-(--border) bg-(--bg-elevated) px-3 py-1.5 text-sm font-medium text-(--fg) transition hover:bg-(--bg-inset) hover:border-(--border-strong) active:scale-[0.98] cursor-pointer disabled:cursor-not-allowed disabled:opacity-40 disabled:active:scale-100"
+          :disabled="raw == null"
+          @click="raw = null"
+        >
+          Clear
+        </button>
+      </div>
+      <span class="font-mono text-xs text-(--fg-subtle)">
+        raw.value = {{ raw === null ? 'null' : `"${raw}"` }}
+      </span>
+    </label>
+
+    <label class="flex flex-col gap-1.5 rounded-xl border border-(--border) bg-(--bg-elevated) p-4">
+      <span class="text-xs font-medium uppercase tracking-wide text-(--fg-subtle)">
+        Reactive fallback
+      </span>
+      <input
+        v-model="fallback"
+        class="w-full rounded-lg border border-(--border) bg-(--bg) px-3 py-2 text-sm text-(--fg) placeholder:text-(--fg-subtle) transition focus:border-(--accent) focus:outline-none focus:ring-2 focus:ring-(--ring)"
+      >
+      <span class="text-xs text-(--fg-subtle)">
+        Changes here update the resolved value while the source is empty.
+      </span>
+    </label>
+  </div>
+</template>