refactor: configure stx for Stacks resources/ structure

- stx.config.ts: add root, pagesDir, componentsDir, layoutsDir, partialsDir
  pointing to resources/ subdirectories
- stx.d.ts: add runtime type declarations for stx globals
- counter.ts: remove manual declare, use stx signal API properly
- dark.ts: fix to use available stx composables (remove usePreferredDark)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: glennmichael123

resources/functions/counter.ts

@@ -1,10 +1,14 @@
-declare const state: any
-declare function now(): string
-// reactive state
+// Reactive counter — uses stx signals (globals from stx.d.ts)
 export const count = state(0)
 
-// functions that mutate state and trigger updates
 export function increment() {
-  console.log('increment() was last run:', now())
-  count.value++
+  count.update((n: number) => n + 1)
+}
+
+export function decrement() {
+  count.update((n: number) => n - 1)
+}
+
+export function reset() {
+  count.set(0)
 }

resources/functions/dark.ts

@@ -1,4 +1,5 @@
-// read the documentation for all the auto-imported APIs
+// Dark mode toggle — uses stx composables (globals from stx.d.ts)
 export const isDark = useDark()
-export const toggleDark = useToggle(isDark)
-export const preferredDark = usePreferredDark()
+export function toggleDark() {
+  isDark.set(!isDark())
+}

stx.d.ts

@@ -0,0 +1,43 @@
+/**
+ * STX Runtime Globals
+ *
+ * These functions are injected by the stx runtime into <script client> blocks.
+ * This declaration file provides TypeScript types for them.
+ */
+
+// Signals
+declare function state<T>(initial: T): {
+  (): T
+  set(value: T): void
+  update(fn: (current: T) => T): void
+  subscribe(cb: (value: T) => void): () => void
+  _isSignal: true
+}
+declare function derived<T>(compute: () => T): { (): T, _isSignal: true }
+declare function effect(fn: () => void | (() => void)): () => void
+declare function batch(fn: () => void): void
+
+// Lifecycle
+declare function onMount(fn: () => void | (() => void)): void
+declare function onDestroy(fn: () => void): void
+
+// Stores
+declare function defineStore<T>(id: string, setup: () => T, options?: { persist?: boolean | { pick?: string[], storage?: string, key?: string } }): () => T
+declare function useStore<T = any>(id: string): T
+
+// Composables
+declare function useRef<T = HTMLElement>(name: string): { current: T | null }
+declare function useLocalStorage<T>(key: string, defaultValue: T): { (): T, set(value: T): void }
+declare function useWebSocket(url: string, options?: any): any
+declare function useQuery<T>(url: string, options?: any): { data: any, loading: any, error: any, refetch: () => void }
+declare function useMutation<T>(url: string, options?: any): { data: any, loading: any, error: any, mutate: (body: any) => Promise<T> }
+declare function navigate(url: string): void
+declare function useRoute(): { path: string, params: Record<string, string> }
+
+// Vue compat
+declare function ref<T>(value: T): { value: T }
+declare function computed<T>(getter: () => T): { value: T }
+declare function watch(source: any, callback: any): void
+
+// Globals
+declare const stx: { helpers: Record<string, any>, [key: string]: any }