@stacksjs/defaults 0.70.229 → 0.70.231

package/app/Actions/Dashboard/Kanban/kanban-model.ts

@@ -0,0 +1,37 @@
+export interface KanbanModelRecord {
+  get: (key: string) => unknown
+}
+
+export interface RefreshableKanbanModelRecord extends KanbanModelRecord {
+  fresh: () => Promise<KanbanModelRecord | null>
+}
+
+export async function refreshModel(record: RefreshableKanbanModelRecord): Promise<KanbanModelRecord> {
+  return await record.fresh() ?? record
+}
+
+export function modelValue(record: KanbanModelRecord, camelKey: string, snakeKey = camelKey): unknown {
+  const camelValue = record.get(camelKey)
+  if (camelValue !== undefined)
+    return camelValue
+  return record.get(snakeKey)
+}
+
+export function modelNumber(record: KanbanModelRecord, camelKey: string, snakeKey = camelKey): number {
+  return Number(modelValue(record, camelKey, snakeKey))
+}
+
+export function modelString(record: KanbanModelRecord, camelKey: string, snakeKey = camelKey): string {
+  const value = modelValue(record, camelKey, snakeKey)
+  return value === undefined || value === null ? '' : String(value)
+}
+
+export function modelNullableString(record: KanbanModelRecord, camelKey: string, snakeKey = camelKey): string | null {
+  const value = modelValue(record, camelKey, snakeKey)
+  return value === undefined || value === null ? null : String(value)
+}
+
+export function modelBoolean(record: KanbanModelRecord, camelKey: string, snakeKey = camelKey): boolean {
+  const value = modelValue(record, camelKey, snakeKey)
+  return value === true || value === 1 || value === '1' || value === 'true'
+}

package/app/Actions/Dashboard/Kanban/kanban-response.ts

@@ -0,0 +1,5 @@
+import { response } from '@stacksjs/router'
+
+export function kanbanError(error: string, status: number): Response {
+  return response.json({ error }, status)
+}

package/app/Actions/Dashboard/Library/CreateComponent.ts

@@ -1,11 +1,28 @@
-import { Action } from '@stacksjs/actions'
+import type { RequestInstance } from '@stacksjs/types'
+import { existsSync } from 'node:fs'
+import { Action, createComponent as scaffoldComponent } from '@stacksjs/actions'
+import { userComponentsPath } from '@stacksjs/path'
+import { response } from '@stacksjs/router'
+import { componentSourceRows } from './library-source'
 
 export default new Action({
-  name: 'CreateFunction',
-  description: 'Creates a new function.',
-  apiResponse: true,
+  name: 'CreateComponent',
+  description: 'Creates a new STX component.',
+  method: 'POST',
 
-  async handle() {
-    //
+  async handle(request: RequestInstance) {
+    const name = String(request.get('name') || '').trim()
+
+    if (!/^[A-Z][A-Za-z0-9]*$/.test(name))
+      return response.json({ message: 'Use a PascalCase component name.' }, 422)
+
+    const destination = userComponentsPath(`${name}.stx`)
+    if (existsSync(destination))
+      return response.json({ message: 'A component with that name already exists.' }, 409)
+
+    await scaffoldComponent({ name })
+
+    const created = componentSourceRows().find(component => component.name === name)
+    return response.json({ component: created }, 201)
   },
 })

package/app/Actions/Dashboard/Library/CreateFunction.ts

@@ -1,11 +1,28 @@
-import { Action } from '@stacksjs/actions'
+import type { RequestInstance } from '@stacksjs/types'
+import { existsSync } from 'node:fs'
+import { Action, createFunction as scaffoldFunction } from '@stacksjs/actions'
+import { userFunctionsPath } from '@stacksjs/path'
+import { response } from '@stacksjs/router'
+import { functionSourceRows } from './library-source'
 
 export default new Action({
   name: 'CreateFunction',
   description: 'Creates a new function.',
-  apiResponse: true,
+  method: 'POST',
 
-  async handle() {
-    //
+  async handle(request: RequestInstance) {
+    const name = String(request.get('name') || '').trim().toLowerCase()
+
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(name))
+      return response.json({ message: 'Use a lowercase kebab-case function name.' }, 422)
+
+    const destination = userFunctionsPath(`${name}.ts`)
+    if (existsSync(destination))
+      return response.json({ message: 'A function with that name already exists.' }, 409)
+
+    await scaffoldFunction({ name })
+
+    const created = functionSourceRows().find(fn => fn.name === name)
+    return response.json({ function: created }, 201)
   },
 })

package/app/Actions/Dashboard/Library/DependencyIndexAction.ts

@@ -1,13 +1,14 @@
 import { Action } from '@stacksjs/actions'
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
 
 export default new Action({
   name: 'DependencyIndexAction',
   description: 'Returns dependency data for the dashboard.',
   method: 'GET',
   async handle() {
-    const { readFileSync } = await import('node:fs')
-    const { join } = await import('node:path')
     const projectRoot = process.cwd()
+    const lockPath = join(projectRoot, 'bun.lock')
 
     const declared: Array<Record<string, unknown>> = []
     const transitive: Array<Record<string, unknown>> = []
@@ -16,52 +17,67 @@ export default new Action({
     let transitiveCount = 0
     let totalCount = 0
 
-    try {
-      const declaredSet: Record<string, boolean> = {}
-      const lockPath = join(projectRoot, 'bun.lock')
-      const lockfile = Bun.JSONC.parse(readFileSync(lockPath, 'utf-8')) as {
-        workspaces?: Record<string, { dependencies?: Record<string, string>, devDependencies?: Record<string, string> }>
-        packages?: Record<string, [string, ...unknown[]]>
+    if (!existsSync(lockPath)) {
+      return {
+        available: false,
+        source: 'bun.lock',
+        declared,
+        thirdParty: [],
+        workspace: [],
+        transitive,
+        stats: [],
+        totalCount,
+        transitiveCount,
+        workspaceCount,
+        thirdPartyCount,
       }
-      const workspaces = lockfile.workspaces || {}
+    }
 
-      for (const wsKey of Object.keys(workspaces)) {
-        const ws = workspaces[wsKey]
-        const allDeps = { ...ws.dependencies, ...ws.devDependencies }
-        for (const depName of Object.keys(allDeps)) {
-          if (declaredSet[depName]) continue
-          declaredSet[depName] = true
-          const version = allDeps[depName]
-          const isWorkspace = version === 'workspace:*' || depName.startsWith('@stacksjs/')
-          declared.push({ name: depName, version, isWorkspace, isScoped: depName.includes('/') })
-        }
-      }
-      declared.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+    const declaredSet: Record<string, boolean> = {}
+    const lockfile = Bun.JSONC.parse(readFileSync(lockPath, 'utf-8')) as {
+      workspaces?: Record<string, { name?: string, dependencies?: Record<string, string>, devDependencies?: Record<string, string> }>
+      packages?: Record<string, [string, ...unknown[]]>
+    }
+    const workspaces = lockfile.workspaces || {}
+    const workspaceNames = new Set(
+      Object.values(workspaces)
+        .map(workspace => workspace.name)
+        .filter((name): name is string => Boolean(name)),
+    )
 
-      const transitiveSet = new Set<string>()
-      for (const value of Object.values(lockfile.packages || {})) {
-        const resolution = value[0]
-        if (resolution.includes('@workspace:')) continue
-        const versionSeparator = resolution.startsWith('@')
-          ? resolution.indexOf('@', 1)
-          : resolution.lastIndexOf('@')
-        if (versionSeparator <= 0) continue
-        const name = resolution.slice(0, versionSeparator)
-        const version = resolution.slice(versionSeparator + 1)
-        if (declaredSet[name] || transitiveSet.has(name)) continue
-        transitiveSet.add(name)
-        transitive.push({ name, version, isScoped: name.includes('/') })
+    for (const wsKey of Object.keys(workspaces)) {
+      const ws = workspaces[wsKey]
+      const allDeps = { ...ws.dependencies, ...ws.devDependencies }
+      for (const depName of Object.keys(allDeps)) {
+        if (declaredSet[depName]) continue
+        declaredSet[depName] = true
+        const version = allDeps[depName]
+        const isWorkspace = workspaceNames.has(depName)
+        declared.push({ name: depName, version, isWorkspace, isScoped: depName.includes('/') })
       }
-      transitive.sort((a, b) => String(a.name).localeCompare(String(b.name)))
-
-      workspaceCount = declared.filter(p => p.isWorkspace).length
-      thirdPartyCount = declared.length - workspaceCount
-      transitiveCount = transitive.length
-      totalCount = declared.length + transitiveCount
     }
-    catch {
-      // bun.lock may not exist yet
+    declared.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+
+    const transitiveSet = new Set<string>()
+    for (const value of Object.values(lockfile.packages || {})) {
+      const resolution = value[0]
+      if (resolution.includes('@workspace:')) continue
+      const versionSeparator = resolution.startsWith('@')
+        ? resolution.indexOf('@', 1)
+        : resolution.lastIndexOf('@')
+      if (versionSeparator <= 0) continue
+      const name = resolution.slice(0, versionSeparator)
+      const version = resolution.slice(versionSeparator + 1)
+      if (declaredSet[name] || transitiveSet.has(name)) continue
+      transitiveSet.add(name)
+      transitive.push({ name, version, isScoped: name.includes('/') })
     }
+    transitive.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+
+    workspaceCount = declared.filter(p => p.isWorkspace).length
+    thirdPartyCount = declared.length - workspaceCount
+    transitiveCount = transitive.length
+    totalCount = declared.length + transitiveCount
 
     const thirdParty = declared.filter(p => !p.isWorkspace)
     const workspace = declared.filter(p => p.isWorkspace)
@@ -73,6 +89,6 @@ export default new Action({
       { label: 'Transitive', value: String(transitiveCount) },
     ]
 
-    return { declared, thirdParty, workspace, transitive, stats, totalCount, transitiveCount, workspaceCount, thirdPartyCount }
+    return { available: true, source: 'bun.lock', declared, thirdParty, workspace, transitive, stats, totalCount, transitiveCount, workspaceCount, thirdPartyCount }
   },
 })

package/app/Actions/Dashboard/Library/GetAverageReleaseTime.ts

@@ -1,5 +1,5 @@
 import { Action } from '@stacksjs/actions'
-// import { Library } from '@stacksjs/orm'
+import { db } from '@stacksjs/database'
 
 export default new Action({
   name: 'GetAverageReleaseTime',
@@ -7,6 +7,24 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    // return Library.averageReleaseTime()
+    const rows = await db
+      .selectFrom('releases')
+      .select(['created_at'])
+      .where('created_at', 'is not', null)
+      .orderBy('created_at')
+      .execute() as unknown as Array<{ created_at: string }>
+
+    const timestamps = rows
+      .map(row => new Date(row.created_at).getTime())
+      .filter(Number.isFinite)
+
+    if (timestamps.length < 2)
+      return { averageSeconds: null, intervals: 0 }
+
+    const elapsed = timestamps.slice(1).reduce((total, value, index) => total + value - timestamps[index]!, 0)
+    return {
+      averageSeconds: Math.round(elapsed / (timestamps.length - 1) / 1000),
+      intervals: timestamps.length - 1,
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetComponents.ts

@@ -1,4 +1,5 @@
 import { Action } from '@stacksjs/actions'
+import { componentSourceRows } from './library-source'
 
 export default new Action({
   name: 'GetComponents',
@@ -6,19 +7,14 @@ export default new Action({
   method: 'GET',
 
   async handle() {
-    const components = [
-      { name: 'Button', category: 'Forms', instances: 47, description: 'Interactive button component with variants' },
-      { name: 'Input', category: 'Forms', instances: 38, description: 'Text input with validation support' },
-      { name: 'Card', category: 'Layout', instances: 23, description: 'Container card with header and footer slots' },
-      { name: 'Modal', category: 'Overlay', instances: 12, description: 'Dialog modal with backdrop' },
-      { name: 'Table', category: 'Data', instances: 18, description: 'Data table with sorting and pagination' },
-      { name: 'Badge', category: 'Display', instances: 34, description: 'Status badge with color variants' },
-      { name: 'Avatar', category: 'Display', instances: 21, description: 'User avatar with fallback' },
-      { name: 'Dropdown', category: 'Navigation', instances: 15, description: 'Dropdown menu with items' },
-    ]
+    const components = componentSourceRows()
+    const categories = ['All', ...new Set(components.map(component => component.category))]
 
-    const categories = ['All', 'Forms', 'Layout', 'Overlay', 'Data', 'Display', 'Navigation']
-
-    return { components, categories }
+    return {
+      components,
+      categories,
+      totalBytes: components.reduce((sum, component) => sum + component.bytes, 0),
+      sourceRoot: 'resources/components',
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetComponentsDownloadCount.ts

@@ -1,5 +1,4 @@
 import { Action } from '@stacksjs/actions'
-// import { Library } from '@stacksjs/orm'
 
 export default new Action({
   name: 'GetComponentsDownloadCount',
@@ -7,6 +6,10 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    // return Library.componentsDownloadCount()
+    return {
+      available: false,
+      downloads: null,
+      reason: 'No component download telemetry source is configured.',
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetDownloadCount.ts

@@ -1,5 +1,5 @@
 import { Action } from '@stacksjs/actions'
-// import { Library } from '@stacksjs/orm'
+import { db } from '@stacksjs/database'
 
 export default new Action({
   name: 'GetDownloadCount',
@@ -7,6 +7,11 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    // return Library.downloadCount()
+    const row = await db
+      .selectFrom('releases')
+      .select(db.fn.sum('downloads').as('downloads'))
+      .executeTakeFirst() as { downloads?: number | string | null } | undefined
+
+    return { downloads: Number(row?.downloads || 0), source: 'releases.downloads' }
   },
 })

package/app/Actions/Dashboard/Library/GetFunctions.ts

@@ -1,4 +1,5 @@
 import { Action } from '@stacksjs/actions'
+import { functionSourceRows } from './library-source'
 
 export default new Action({
   name: 'GetFunctions',
@@ -6,17 +7,12 @@ export default new Action({
   method: 'GET',
 
   async handle() {
-    const functions = [
-      { name: 'formatDate', category: 'Date', calls: 1247, description: 'Format dates in various formats' },
-      { name: 'validateEmail', category: 'Validation', calls: 892, description: 'Validate email addresses' },
-      { name: 'slugify', category: 'String', calls: 456, description: 'Convert strings to URL slugs' },
-      { name: 'debounce', category: 'Utility', calls: 234, description: 'Debounce function calls' },
-      { name: 'formatCurrency', category: 'Number', calls: 678, description: 'Format numbers as currency' },
-      { name: 'parseJSON', category: 'Data', calls: 345, description: 'Safely parse JSON strings' },
-      { name: 'truncate', category: 'String', calls: 567, description: 'Truncate strings with ellipsis' },
-      { name: 'capitalize', category: 'String', calls: 423, description: 'Capitalize first letter' },
-    ]
+    const functions = functionSourceRows()
 
-    return { functions }
+    return {
+      functions,
+      totalBytes: functions.reduce((sum, fn) => sum + fn.bytes, 0),
+      sourceRoot: 'resources/functions',
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetFunctionsDownloadCount.ts

@@ -1,5 +1,4 @@
 import { Action } from '@stacksjs/actions'
-// import { Library } from '@stacksjs/orm'
 
 export default new Action({
   name: 'GetFunctionsDownloadCount',
@@ -7,6 +6,10 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    // return Library.functionsDownloadCount()
+    return {
+      available: false,
+      downloads: null,
+      reason: 'No function download telemetry source is configured.',
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetReleaseCount.ts

@@ -1,5 +1,5 @@
 import { Action } from '@stacksjs/actions'
-// import { Library } from '@stacksjs/orm'
+import { db } from '@stacksjs/database'
 
 export default new Action({
   name: 'GetReleaseCount',
@@ -7,6 +7,11 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    // return Library.releaseCount()
+    const row = await db
+      .selectFrom('releases')
+      .select(db.fn.count('id').as('count'))
+      .executeTakeFirst() as { count?: number | string } | undefined
+
+    return { count: Number(row?.count || 0) }
   },
 })

package/app/Actions/Dashboard/Library/GetReleases.ts

@@ -7,22 +7,17 @@ export default new Action({
   method: 'GET',
 
   async handle() {
-    try {
-      const allReleases = await Release.orderByDesc('id').get()
+    const allReleases = await Release.orderByDesc('id').get()
 
-      const releases = allReleases.map(r => ({
-        version: String(r.get('version') || ''),
-        date: String(r.get('created_at') || r.get('released_at') || ''),
-        type: String(r.get('type') || 'patch'),
-        status: String(r.get('status') || 'previous'),
-        changes: Number(r.get('changes') || r.get('change_count') || 0),
-        breaking: Boolean(r.get('breaking') || false),
-      }))
+    const releases = allReleases.map(r => ({
+      version: String(r.get('version') || ''),
+      date: String(r.get('created_at') || r.get('released_at') || ''),
+      type: String(r.get('type') || 'patch'),
+      status: String(r.get('status') || 'previous'),
+      changes: Number(r.get('changes') || r.get('change_count') || 0),
+      breaking: Boolean(r.get('breaking') || false),
+    }))
 
-      return { releases }
-    }
-    catch {
-      return { releases: [] }
-    }
+    return { releases }
   },
 })

package/app/Actions/Dashboard/Library/PackageIndexAction.ts

@@ -1,26 +1,19 @@
 import { Action } from '@stacksjs/actions'
+import { workspacePackageRows } from './library-source'
 
 export default new Action({
   name: 'PackageIndexAction',
   description: 'Returns package data for the dashboard.',
   method: 'GET',
   async handle() {
-    const packages = [
-      { name: '@stacksjs/core', version: '2.4.0', latest: '2.4.0', type: 'dependency', status: 'up-to-date' },
-      { name: '@stacksjs/ui', version: '1.8.2', latest: '1.9.0', type: 'dependency', status: 'update-available' },
-      { name: '@stacksjs/database', version: '3.1.0', latest: '3.1.0', type: 'dependency', status: 'up-to-date' },
-      { name: 'typescript', version: '5.3.3', latest: '5.3.3', type: 'devDependency', status: 'up-to-date' },
-      { name: 'bun', version: '1.0.21', latest: '1.0.25', type: 'devDependency', status: 'update-available' },
-      { name: 'vitest', version: '1.1.0', latest: '1.2.0', type: 'devDependency', status: 'update-available' },
-    ]
+    const packages = workspacePackageRows()
 
-    const stats = [
-      { label: 'Total Packages', value: '47' },
-      { label: 'Up to Date', value: '41' },
-      { label: 'Updates Available', value: '6' },
-      { label: 'Security Issues', value: '0' },
-    ]
-
-    return { packages, stats }
+    return {
+      packages,
+      publicCount: packages.filter(pkg => !pkg.private).length,
+      privateCount: packages.filter(pkg => pkg.private).length,
+      dependencyCount: packages.reduce((sum, pkg) => sum + pkg.dependencyCount, 0),
+      source: 'bun.lock',
+    }
   },
 })