deskforge 1.0.0

package/examples/notekeeper/src/components/noteCard.ts

@@ -0,0 +1,147 @@
+// NoteCard.dtx
+// A single note card component.
+// Shows title, preview, date, and action buttons.
+// Used in the notes list on the Home screen.
+
+import {
+  createNode,
+}              from '@deskforge/core/src/tree'
+import { State } from '@deskforge/state/'
+import type { Note } from '../state/appState'
+import {Component} from '@deskforge/core/src/component'
+
+// Props for NoteCard
+interface NoteCardProps {
+  note:           Note
+  onOpen:         () => void
+  onDelete:       () => void
+  onTogglePin:    () => void
+  onToggleArchive:() => void
+}
+
+// NoteCard component
+// Shows note preview with action buttons
+export const NoteCard = Component((props: NoteCardProps) => {
+  const { note } = props
+
+  // Local state for hover
+  const state = State({ hovered: false })
+
+  // Format the date
+  function formatDate(timestamp: number): string {
+    const date = new Date(timestamp)
+    return date.toLocaleDateString('en-GB', {
+      day:   '2-digit',
+      month: 'short',
+      year:  'numeric',
+    })
+  }
+
+  // Get content preview — first 100 chars
+  function preview(content: string): string {
+    if (content.length <= 100) return content
+    return content.slice(0, 100) + '...'
+  }
+
+  // The card node tree
+  return createNode('Card', {
+    padding:    16,
+    radius:     8,
+    background: state.hovered ? 'surfaceAlt' : 'surface',
+    shadow:     state.hovered ? 'md' : 'sm',
+    cursor:     'pointer',
+    transition: { duration: 150, easing: 'easeOut' },
+
+    onHoverEnter: () => { state.hovered = true  },
+    onHoverLeave: () => { state.hovered = false },
+    onClick:       props.onOpen,
+  }, [
+
+    // Top row — title and pin indicator
+    createNode('Row', {
+      align:   'center',
+      gap:     8,
+      marginBottom: 8,
+    }, [
+      // Pin icon if pinned
+      note.pinned
+        ? createNode('Icon', {
+            name:  'pin',
+            size:  14,
+            color: 'primary',
+          })
+        : createNode('Fragment', {}),
+
+      // Note title
+      createNode('Text', {
+        value:      note.title,
+        style:      'subheading',
+        flex:       1,
+        maxLines:   1,
+        overflow:   'ellipsis',
+      }),
+    ]),
+
+    // Content preview
+    createNode('Text', {
+      value:    preview(note.content),
+      style:    'body',
+      color:    'textMuted',
+      maxLines: 2,
+      overflow: 'ellipsis',
+      marginBottom: 12,
+    }),
+
+    // Bottom row — date and actions
+    createNode('Row', {
+      align:   'center',
+      justify: 'space-between',
+    }, [
+
+      // Date
+      createNode('Text', {
+        value: formatDate(note.updatedAt),
+        style: 'caption',
+        color: 'textMuted',
+      }),
+
+      // Action buttons
+      createNode('Row', { gap: 4 }, [
+
+        // Pin button
+        createNode('Button', {
+          variant: 'ghost',
+          icon:    note.pinned ? 'pin-filled' : 'pin',
+          size:    'sm',
+          onClick: (e: Event) => {
+            e.stopPropagation()
+            props.onTogglePin()
+          },
+        }),
+
+        // Archive button
+        createNode('Button', {
+          variant: 'ghost',
+          icon:    'archive',
+          size:    'sm',
+          onClick: (e: Event) => {
+            e.stopPropagation()
+            props.onToggleArchive()
+          },
+        }),
+
+        // Delete button
+        createNode('Button', {
+          variant: 'ghost',
+          icon:    'trash',
+          size:    'sm',
+          color:   'danger',
+          onClick: (e: Event) => {
+            e.stopPropagation()
+            props.onDelete()
+          },
+        }),
+      ]),
+    ]),
+  ])
+})

package/examples/notekeeper/src/hooks/useNotes.ts

@@ -0,0 +1,169 @@
+// useNotes.dtx
+// Custom hook for note management.
+// Encapsulates all note logic in one place.
+// Components use this hook — never touch DB directly.
+
+import { Computed, Effect } from '@deskforge/state/'
+import { createScheduler }   from '@deskforge/core/src/scheduler'
+import { DB }               from '@deskforge/db/src'
+import { AppStore }         from '../state/appState'
+import type { Note }        from '../state/appState'
+import type { DFComputed }  from '@deskforge/state/src/computed'
+
+type NoteFilter = 'all' | 'pinned' | 'archived'
+type NoteChanges = Partial<Pick<Note, 'title' | 'content'>>
+
+interface UseNotesResult {
+  notes: DFComputed<Note[]>
+  loading: boolean
+  query: string
+  filter: NoteFilter
+  createNote: (title: string, content?: string) => Promise<Note>
+  updateNote: (id: string, changes: NoteChanges) => Promise<void>
+  deleteNote: (id: string) => Promise<void>
+  togglePin: (id: string) => Promise<void>
+  toggleArchive: (id: string) => Promise<void>
+  setQuery: (q: string) => void
+  setFilter: (f: NoteFilter) => void
+}
+
+// Generates a unique note ID
+function noteId(): string {
+  return 'note_' + Math.random().toString(16).slice(2, 10)
+}
+
+// Custom hook for note operations
+// Returns filtered notes and CRUD functions
+export function useNotes() {
+  const state = AppStore.state
+  const scheduler = createScheduler()
+
+  // Filtered notes based on query and filter
+  const filtered = Computed(() => {
+    let notes: Note[] = state.notes
+
+    // Apply filter
+    if (state.filter === 'pinned') {
+      notes = notes.filter((n: Note) => n.pinned)
+    } else if (state.filter === 'archived') {
+      notes = notes.filter((n: Note) => n.archived)
+    } else {
+      // All — exclude archived unless filter is archived
+      notes = notes.filter((n: Note) => !n.archived)
+    }
+
+    // Apply search query
+    if (state.query.trim()) {
+      const q = state.query.toLowerCase()
+      notes = notes.filter((n: Note) =>
+        n.title.toLowerCase().includes(q) ||
+        n.content.toLowerCase().includes(q)
+      )
+    }
+
+    // Pinned notes first
+    return [...notes].sort((a: Note, b: Note) => {
+      if (a.pinned && !b.pinned) return -1
+      if (!a.pinned && b.pinned) return 1
+      return b.updatedAt - a.updatedAt
+    })
+  })
+
+  // Load notes from DB on mount
+  Effect(() => {
+    AppStore.dispatch('setLoading', true)
+
+    DB.query<Note>('notes')
+      .orderBy('updatedAt', 'desc')
+      .all()
+      .then(notes => {
+        AppStore.dispatch('loadNotes', notes)
+      })
+      .catch(err => {
+        console.error('Failed to load notes:', err)
+        AppStore.dispatch('setLoading', false)
+      })
+  }, scheduler)
+
+  // Creates a new note and saves to DB
+  async function createNote(
+    title:   string,
+    content: string = ''
+  ): Promise<Note> {
+    const note: Note = {
+      id:        noteId(),
+      title:     title.trim() || 'Untitled',
+      content,
+      pinned:    false,
+      archived:  false,
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+    }
+
+    // Save to database
+    await DB.insert('notes', note as unknown as Record<string, unknown>)
+
+    // Update store
+    AppStore.dispatch('addNote', note)
+
+    return note
+  }
+
+  // Updates a note and saves to DB
+  async function updateNote(
+    id:      string,
+    changes: Partial<Pick<Note, 'title' | 'content'>>
+  ): Promise<void> {
+    await DB.update('notes', id, {
+      ...changes,
+      updatedAt: Date.now(),
+    })
+
+    AppStore.dispatch('updateNote', { id, changes })
+  }
+
+  // Deletes a note from DB and store
+  async function deleteNote(id: string): Promise<void> {
+    await DB.delete('notes', id)
+    AppStore.dispatch('deleteNote', id)
+  }
+
+  // Toggles pin on a note
+  async function togglePin(id: string): Promise<void> {
+    const note = state.notes.find((n: Note) => n.id === id)
+    if (!note) return
+
+    await DB.update('notes', id, { pinned: !note.pinned })
+    AppStore.dispatch('togglePin', id)
+  }
+
+  // Toggles archive on a note
+  async function toggleArchive(id: string): Promise<void> {
+    const note = state.notes.find((n: Note) => n.id === id)
+    if (!note) return
+
+    await DB.update('notes', id, { archived: !note.archived })
+    AppStore.dispatch('toggleArchive', id)
+  }
+
+  return {
+    // Reactive data
+    notes:    filtered,
+    loading:  state.loading,
+    query:    state.query,
+    filter:   state.filter,
+
+    // Actions
+    createNote,
+    updateNote,
+    deleteNote,
+    togglePin,
+    toggleArchive,
+
+    // Filters
+    setQuery:  (q: string) =>
+      AppStore.dispatch('setQuery', q),
+    setFilter: (f: 'all' | 'pinned' | 'archived') =>
+      AppStore.dispatch('setFilter', f),
+  }
+}

package/examples/notekeeper/src/state/appState.ts

@@ -0,0 +1,142 @@
+// appState.dtx
+// Global state for the NoteKeeper app.
+// Accessible from any component without prop drilling.
+// Persists to local SQLite on device.
+
+import { Store } from '@deskforge/state//store'
+
+// A single note
+interface Note {
+  id:        string
+  title:     string
+  content:   string
+  pinned:    boolean
+  archived:  boolean
+  createdAt: number
+  updatedAt: number
+}
+
+// The global app state
+export const AppStore = Store({
+  state: {
+    // All notes
+    notes:       [] as Note[],
+
+    // Current search query
+    query:       '',
+
+    // Active filter
+    filter:      'all' as 'all' | 'pinned' | 'archived',
+
+    // Currently editing note id
+    editingId:   null as string | null,
+
+    // Whether sidebar is open on desktop
+    sidebarOpen: true,
+
+    // App theme
+    theme:       'system' as 'dark' | 'light' | 'system',
+
+    // Whether app is loading initial data
+    loading:     false,
+  },
+
+  actions: {
+    // Adds a new note to the list
+    addNote(state, payload?: unknown) {
+      const note = payload as Note | undefined
+      if (!note) return
+      state.notes.push(note)
+    },
+
+    // Updates an existing note by id
+    updateNote(state, payload?: unknown) {
+      const p = payload as { id: string; changes: Partial<Note> } | undefined
+      if (!p) return
+      const index = state.notes.findIndex(n => n.id === p.id)
+      if (index !== -1) {
+        state.notes[index] = {
+          ...state.notes[index]!,
+          ...p.changes,
+          updatedAt: Date.now(),
+        }
+      }
+    },
+
+    // Removes a note by id
+    deleteNote(state, payload?: unknown) {
+      const id = payload as string | undefined
+      if (!id) return
+      state.notes = state.notes.filter(n => n.id !== id)
+    },
+
+    // Pins or unpins a note
+    togglePin(state, payload?: unknown) {
+      const id = payload as string | undefined
+      if (!id) return
+      const note = state.notes.find(n => n.id === id)
+      if (note) note.pinned = !note.pinned
+    },
+
+    // Archives or unarchives a note
+    toggleArchive(state, payload?: unknown) {
+      const id = payload as string | undefined
+      if (!id) return
+      const note = state.notes.find(n => n.id === id)
+      if (note) note.archived = !note.archived
+    },
+
+    // Sets the search query
+    setQuery(state, payload?: unknown) {
+      const query = payload as string | undefined
+      if (query === undefined) return
+      state.query = query
+    },
+
+    // Sets the active filter
+    setFilter(state, payload?: unknown) {
+      const filter = payload as 'all' | 'pinned' | 'archived' | undefined
+      if (!filter) return
+      state.filter = filter
+    },
+
+    // Sets the editing note id
+    setEditing(state, payload?: unknown) {
+      const id = payload as string | null | undefined
+      if (id === undefined) return
+      state.editingId = id
+    },
+
+    // Toggles the sidebar
+    toggleSidebar(state) {
+      state.sidebarOpen = !state.sidebarOpen
+    },
+
+    // Sets the theme
+    setTheme(state, payload?: unknown) {
+      const theme = payload as 'dark' | 'light' | 'system' | undefined
+      if (!theme) return
+      state.theme = theme
+    },
+
+    // Sets loading state
+    setLoading(state, payload?: unknown) {
+      const loading = payload as boolean | undefined
+      if (loading === undefined) return
+      state.loading = loading
+    },
+
+    // Loads notes from database
+    loadNotes(state, payload?: unknown) {
+      const notes = payload as Note[] | undefined
+      if (!notes) return
+      state.notes   = notes
+      state.loading = false
+    },
+  },
+
+  persist:    true,
+  persistKey: 'notekeeper-store',
+})
+
+export type { Note }

package/examples/notekeeper/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "declaration": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/app.ts"],
+  "exclude": ["node_modules", "dist", "src/components", "src/hooks", "src/state"]
+}

package/examples/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "rootDir": "./notekeeper/src",
+    "outDir": "./notekeeper/dist",
+    "strict": true,
+    "declaration": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "paths": {
+      "deskforge":               ["../../packages/core/src/index"],
+      "@deskforge/state":        ["../../packages/state/src/index"],
+      "@deskforge/ui":           ["../../packages/ui/src/index"],
+      "@deskforge/theme":        ["../../packages/theme/src/index"],
+      "@deskforge/router":       ["../../packages/router/src/index"],
+      "@deskforge/db":           ["../../packages/db/src/index"],
+      "@deskforge/notifications":["../../packages/notifications/src/index"],
+      "@deskforge/logger":       ["../../packages/logger/src/index"],
+      "@deskforge/file":         ["../../packages/file/src/index"],
+      "@deskforge/bridge":       ["../../packages/bridge/src/index"],
+      "@deskforge/ai":           ["../../packages/ai/src/index"],
+      "@deskforge/payments":     ["../../packages/payments/src/index"],
+      "@deskforge/security":     ["../../packages/security/src/index"],
+      "@deskforge/background":   ["../../packages/background/src/index"],
+      "@deskforge/i18n":         ["../../packages/i18n/src/index"],
+      "@deskforge/network":      ["../../packages/network/src/index"],
+      "@deskforge/updater":      ["../../packages/updater/src/index"]
+    }
+  },
+  "include": ["notekeeper/src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/local-app/addlibrary.ts

@@ -0,0 +1,7 @@
+// addlibrary.ts
+// Managed by dfcli — do not edit manually
+// To add:    dfcli lib add <name>
+// To remove: dfcli lib remove <name>
+
+// No libraries installed yet
+// Run: dfcli lib add <name>

package/local-app/app.ts

@@ -0,0 +1,29 @@
+// app.ts
+// Entry point for local-app
+// Platform: desktop
+
+import { App, Window, Screen, Column, Text, Button }
+  from 'deskforge'
+
+App({
+  name:      'local-app',
+  version:   '1.0.0',
+  theme:     'system',
+  platforms: ['desktop'],
+  os:        ['linux'],
+
+  desktop: Window({
+    title:     'local-app',
+    size:      [1024, 768],
+    resizable: true,
+    body:      Column([
+      Text('Welcome to local-app', {
+        style: 'heading'
+      }),
+      Button('Get Started', {
+        onClick: () => console.log('Hello!')
+      }),
+    ], { padding: 24, gap: 16 })
+  }),
+
+})

package/local-app/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "local-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "app.ts",
+  "scripts": {
+    "start": "dfcli start",
+    "build": "dfcli build"
+  },
+  "dependencies": {
+    "deskforge": "file:.."
+  }
+}

package/local-app/screens/Home.ts

@@ -0,0 +1,20 @@
+// screens/Home.ts
+// Home screen component
+
+import { Component, Column, Text, Button }
+  from 'deskforge'
+import { State } from 'deskforge/state'
+
+const HomeScreen = Component(() => {
+  const state = State({ count: 0 })
+
+  return Column([
+    Text('Home', { style: 'heading' }),
+    Text(`Count: ${state.count}`),
+    Button('Increment', {
+      onClick: () => state.count++
+    }),
+  ], { padding: 24, gap: 16 })
+})
+
+export default HomeScreen

package/local-app/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "strict": true,
+    "skipLibCheck": true
+  }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "deskforge",
+  "version": "1.0.0",
+  "description": "Build everything. Own everything. Pay for nothing.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "workspaces": [
+    "packages/*",
+    "examples/*"
+  ],
+  "scripts": {
+    "build": "node tools/build/build.js",
+    "test": "node tools/build/test.js",
+    "publish:packages": "npm run build && node tools/build/publish.js"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "typescript": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kofidoe777/deskforge-.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kofidoe777/deskforge-/issues"
+  },
+  "homepage": "https://github.com/kofidoe777/deskforge-#readme",
+  "license": "MIT"
+}

package/packages/ai/dist/brain.d.ts

@@ -0,0 +1,32 @@
+import type { PerceptionConfig, PerceptionResult } from './nodes/perception';
+import type { MemoryConfig, MemorySearchResult } from './nodes/memory';
+import type { LogicConfig, LogicResult } from './nodes/logic';
+type BrainModelSize = 'tiny' | 'small' | 'medium';
+interface BrainConfig {
+    name: string;
+    nodes: {
+        perception?: PerceptionConfig;
+        memory?: MemoryConfig;
+        logic?: LogicConfig;
+    };
+    train?: string;
+    model?: BrainModelSize;
+}
+interface BrainResult {
+    perception?: PerceptionResult | undefined;
+    memories?: MemorySearchResult[] | undefined;
+    logic?: LogicResult | undefined;
+    output: unknown;
+    duration: number;
+}
+interface DFBrain {
+    name: string;
+    analyse(input: unknown): Promise<BrainResult>;
+    remember(content: unknown, vector: number[]): Promise<string>;
+    recall(vector: number[], topN?: number): Promise<MemorySearchResult[]>;
+    config: BrainConfig;
+}
+declare function createBrain(config: BrainConfig): DFBrain;
+export type { BrainConfig, BrainResult, BrainModelSize, DFBrain };
+export { createBrain };
+//# sourceMappingURL=brain.d.ts.map

package/packages/ai/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAA6B,oBAAoB,CAAA;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EACnB,MAA6B,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACZ,MAA6B,eAAe,CAAA;AAM7C,KAAK,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAGjD,UAAU,WAAW;IAEnB,IAAI,EAAE,MAAM,CAAA;IAGZ,KAAK,EAAE;QACL,UAAU,CAAC,EAAE,gBAAgB,CAAA;QAC7B,MAAM,CAAC,EAAM,YAAY,CAAA;QACzB,KAAK,CAAC,EAAO,WAAW,CAAA;KACzB,CAAA;IAID,KAAK,CAAC,EAAE,MAAM,CAAA;IAGd,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB;AAGD,UAAU,WAAW;IAEnB,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAGzC,QAAQ,CAAC,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAA;IAG3C,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAG/B,MAAM,EAAE,OAAO,CAAA;IAGf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAGD,UAAU,OAAO;IAEf,IAAI,EAAE,MAAM,CAAA;IAGZ,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAG7C,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAG7D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;IAGtE,MAAM,EAAE,WAAW,CAAA;CACpB;AAMD,iBAAS,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CA6GjD;AAED,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,CAAA"}