dsh-tiddlywiki 0.1.0 → 0.1.2

package/package.json

@@ -1,63 +1,79 @@
-{
-  "name": "dsh-tiddlywiki",
-  "description": "TiddlyWiki 5 as the DSH persistent knowledge base: tiddlywiki_* agent tools (search/get/put/delete + git sync), a full TiddlyWiki editor embedded in the GUI center column, a floating quick-note widget in the chat area, and git-based sync with auto-commit. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.1.0",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "slots"
-      ],
-      "platform": "web"
-    }
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "src",
-    "cordis.patch.yml",
-    "LICENSE",
-    "README.md"
-  ],
-  "license": "MIT",
-  "homepage": "https://github.com/bbqisbbq/dsh-tiddlywiki#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki.git"
-  },
-  "bugs": {
-    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki/issues"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "dependencies": {
-    "tiddlywiki": "^5.4.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22.20.1",
-    "@types/react": "^19.1.0",
-    "react": "^19.1.0",
-    "tsdown": "0.22.2",
-    "tsx": "^4.19.2",
-    "typescript": "~5.7.2",
-    "unrun": "*"
-  },
-  "scripts": {
-    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
-    "build:host": "tsdown -c tsdown.host.config.ts",
-    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
-    "watch": "tsdown -c tsdown.host.config.ts --watch",
-    "typecheck": "tsc --noEmit",
-    "selftest": "node scripts/selftest.mjs"
-  }
-}
+{
+  "name": "dsh-tiddlywiki",
+  "description": "TiddlyWiki 5 as the DSH persistent knowledge base: tiddlywiki_* agent tools (search/get/put/delete + git sync), a full TiddlyWiki editor embedded in the GUI center column, a floating quick-note widget in the chat area, and git-based sync with auto-commit. Mounts via the official dsh plugin system — no DSH source changes.",
+  "version": "0.1.2",
+  "type": "module",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "tiddlywiki",
+    "knowledge-base",
+    "note-taking",
+    "notes",
+    "wiki",
+    "git-sync",
+    "agent-tools",
+    "plugin"
+  ],
+  "author": {
+    "name": "bbqisbbq",
+    "url": "https://github.com/bbqisbbq"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "src",
+    "cordis.patch.yml",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/bbqisbbq/dsh-tiddlywiki#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "tiddlywiki": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "@types/react": "^19.1.0",
+    "react": "^19.1.0",
+    "tsdown": "0.22.2",
+    "tsx": "^4.19.2",
+    "typescript": "~5.7.2",
+    "unrun": "*"
+  },
+  "scripts": {
+    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
+    "build:host": "tsdown -c tsdown.host.config.ts",
+    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
+    "watch": "tsdown -c tsdown.host.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "selftest": "node scripts/selftest.mjs"
+  }
+}

package/src/client/editor-popup.ts

@@ -1,121 +1,121 @@
-/**
- * Floating popup iframe that loads TiddlyWiki's NATIVE editor for a draft
- * (quick-note "✏️ 在 TW 中编辑"). A small draggable + resizable overlay with its
- * own iframe pointed at `twUrl#<draftTitle>`: the fragment-only navigation
- * triggers TW's hashchange, which opens the draft in the story, and because the
- * draft tiddler carries `draft.of` the story renders the native EditTemplate.
- *
- * Independent of the center panel — a separate floating window so the user can
- * edit a note without leaving the chat context.
- *
- * @module dsh-tiddlywiki/client/editor-popup
- */
-
-let root: HTMLDivElement | undefined
-let frame: HTMLIFrameElement | undefined
-let titleEl: HTMLSpanElement | undefined
-
-/** Open (create on first use) the popup and load `url` (twUrl#draftTitle). */
-export function openEditorPopup(url: string, label: string): void {
-  ensurePopup()
-  if (root === undefined || frame === undefined) return
-  if (titleEl !== undefined) titleEl.textContent = `TiddlyWiki 编辑器 · ${label}`
-  root.style.display = ''
-  // Same-base fragment navigation reloads nothing; a changed base (restart on a
-  // new port) reloads the app and TW still opens the draft from the hash.
-  frame.src = url
-}
-
-/** Remove the popup DOM entirely (plugin dispose). */
-export function disposeEditorPopup(): void {
-  root?.remove()
-  root = undefined
-  frame = undefined
-  titleEl = undefined
-}
-
-function ensurePopup(): void {
-  if (root !== undefined && frame !== undefined) return
-
-  root = document.createElement('div')
-  root.className = 'dsh-tw-editor-popup'
-  root.style.display = 'none'
-
-  const bar = document.createElement('div')
-  bar.className = 'dsh-tw-editor-bar'
-  titleEl = document.createElement('span')
-  titleEl.className = 'dsh-tw-editor-title'
-  titleEl.textContent = 'TiddlyWiki 编辑器'
-  const close = document.createElement('button')
-  close.type = 'button'
-  close.className = 'dsh-tw-editor-close'
-  close.textContent = '✕'
-  close.title = '关闭'
-  bar.append(titleEl, close)
-
-  frame = document.createElement('iframe')
-  frame.className = 'dsh-tw-editor-frame'
-  frame.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms allow-popups')
-  frame.title = 'TiddlyWiki 编辑器'
-
-  const resize = document.createElement('div')
-  resize.className = 'dsh-tw-editor-resize'
-  resize.title = '拖拽调整大小'
-
-  root.append(bar, frame, resize)
-  document.body.append(root)
-
-  close.addEventListener('click', () => {
-    if (root !== undefined) root.style.display = 'none'
-  })
-
-  // Drag by the title bar (un-center by setting explicit left/top + margin 0).
-  bar.addEventListener('mousedown', (event) => {
-    if (event.button !== 0 || root === undefined) return
-    event.preventDefault()
-    const rect = root.getBoundingClientRect()
-    const startX = event.clientX
-    const startY = event.clientY
-    const baseLeft = rect.left
-    const baseTop = rect.top
-    const onMove = (ev: MouseEvent): void => {
-      if (root === undefined) return
-      root.style.left = `${baseLeft + ev.clientX - startX}px`
-      root.style.top = `${baseTop + ev.clientY - startY}px`
-      root.style.margin = '0'
-      root.style.right = 'auto'
-      root.style.bottom = 'auto'
-    }
-    const onUp = (): void => {
-      window.removeEventListener('mousemove', onMove)
-      window.removeEventListener('mouseup', onUp)
-    }
-    window.addEventListener('mousemove', onMove)
-    window.addEventListener('mouseup', onUp)
-  })
-
-  // Resize from the bottom-right corner.
-  resize.addEventListener('mousedown', (event) => {
-    if (event.button !== 0 || root === undefined) return
-    event.preventDefault()
-    event.stopPropagation()
-    const rect = root.getBoundingClientRect()
-    const startX = event.clientX
-    const startY = event.clientY
-    const baseW = rect.width
-    const baseH = rect.height
-    const onMove = (ev: MouseEvent): void => {
-      if (root === undefined) return
-      root.style.width = `${Math.max(360, baseW + ev.clientX - startX)}px`
-      root.style.height = `${Math.max(260, baseH + ev.clientY - startY)}px`
-      root.style.right = 'auto'
-      root.style.bottom = 'auto'
-    }
-    const onUp = (): void => {
-      window.removeEventListener('mousemove', onMove)
-      window.removeEventListener('mouseup', onUp)
-    }
-    window.addEventListener('mousemove', onMove)
-    window.addEventListener('mouseup', onUp)
-  })
-}
+/**
+ * Floating popup iframe that loads TiddlyWiki's NATIVE editor for a draft
+ * (quick-note "✏️ 在 TW 中编辑"). A small draggable + resizable overlay with its
+ * own iframe pointed at `twUrl#<draftTitle>`: the fragment-only navigation
+ * triggers TW's hashchange, which opens the draft in the story, and because the
+ * draft tiddler carries `draft.of` the story renders the native EditTemplate.
+ *
+ * Independent of the center panel — a separate floating window so the user can
+ * edit a note without leaving the chat context.
+ *
+ * @module dsh-tiddlywiki/client/editor-popup
+ */
+
+let root: HTMLDivElement | undefined
+let frame: HTMLIFrameElement | undefined
+let titleEl: HTMLSpanElement | undefined
+
+/** Open (create on first use) the popup and load `url` (twUrl#draftTitle). */
+export function openEditorPopup(url: string, label: string): void {
+  ensurePopup()
+  if (root === undefined || frame === undefined) return
+  if (titleEl !== undefined) titleEl.textContent = `TiddlyWiki 编辑器 · ${label}`
+  root.style.display = ''
+  // Same-base fragment navigation reloads nothing; a changed base (restart on a
+  // new port) reloads the app and TW still opens the draft from the hash.
+  frame.src = url
+}
+
+/** Remove the popup DOM entirely (plugin dispose). */
+export function disposeEditorPopup(): void {
+  root?.remove()
+  root = undefined
+  frame = undefined
+  titleEl = undefined
+}
+
+function ensurePopup(): void {
+  if (root !== undefined && frame !== undefined) return
+
+  root = document.createElement('div')
+  root.className = 'dsh-tw-editor-popup'
+  root.style.display = 'none'
+
+  const bar = document.createElement('div')
+  bar.className = 'dsh-tw-editor-bar'
+  titleEl = document.createElement('span')
+  titleEl.className = 'dsh-tw-editor-title'
+  titleEl.textContent = 'TiddlyWiki 编辑器'
+  const close = document.createElement('button')
+  close.type = 'button'
+  close.className = 'dsh-tw-editor-close'
+  close.textContent = '✕'
+  close.title = '关闭'
+  bar.append(titleEl, close)
+
+  frame = document.createElement('iframe')
+  frame.className = 'dsh-tw-editor-frame'
+  frame.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms allow-popups')
+  frame.title = 'TiddlyWiki 编辑器'
+
+  const resize = document.createElement('div')
+  resize.className = 'dsh-tw-editor-resize'
+  resize.title = '拖拽调整大小'
+
+  root.append(bar, frame, resize)
+  document.body.append(root)
+
+  close.addEventListener('click', () => {
+    if (root !== undefined) root.style.display = 'none'
+  })
+
+  // Drag by the title bar (un-center by setting explicit left/top + margin 0).
+  bar.addEventListener('mousedown', (event) => {
+    if (event.button !== 0 || root === undefined) return
+    event.preventDefault()
+    const rect = root.getBoundingClientRect()
+    const startX = event.clientX
+    const startY = event.clientY
+    const baseLeft = rect.left
+    const baseTop = rect.top
+    const onMove = (ev: MouseEvent): void => {
+      if (root === undefined) return
+      root.style.left = `${baseLeft + ev.clientX - startX}px`
+      root.style.top = `${baseTop + ev.clientY - startY}px`
+      root.style.margin = '0'
+      root.style.right = 'auto'
+      root.style.bottom = 'auto'
+    }
+    const onUp = (): void => {
+      window.removeEventListener('mousemove', onMove)
+      window.removeEventListener('mouseup', onUp)
+    }
+    window.addEventListener('mousemove', onMove)
+    window.addEventListener('mouseup', onUp)
+  })
+
+  // Resize from the bottom-right corner.
+  resize.addEventListener('mousedown', (event) => {
+    if (event.button !== 0 || root === undefined) return
+    event.preventDefault()
+    event.stopPropagation()
+    const rect = root.getBoundingClientRect()
+    const startX = event.clientX
+    const startY = event.clientY
+    const baseW = rect.width
+    const baseH = rect.height
+    const onMove = (ev: MouseEvent): void => {
+      if (root === undefined) return
+      root.style.width = `${Math.max(360, baseW + ev.clientX - startX)}px`
+      root.style.height = `${Math.max(260, baseH + ev.clientY - startY)}px`
+      root.style.right = 'auto'
+      root.style.bottom = 'auto'
+    }
+    const onUp = (): void => {
+      window.removeEventListener('mousemove', onMove)
+      window.removeEventListener('mouseup', onUp)
+    }
+    window.addEventListener('mousemove', onMove)
+    window.addEventListener('mouseup', onUp)
+  })
+}

package/src/client/index.ts

@@ -1,76 +1,76 @@
-/**
- * Browser half entry for dsh-tiddlywiki (design doc §12, D5): injects the
- * stylesheet, mounts the sidebar entry, the center-column TiddlyWiki panel,
- * the floating quick-note widget, and registers the plugin's settings page
- * (config panel, §13) into the shell's Settings.
- *
- * Failure policy: DOM mounting problems are logged, never thrown — the web
- * shell fails the whole boot when a plugin apply throws.
- *
- * Export shape: `name` / `inject` / `apply`, no default.
- *
- * @module dsh-tiddlywiki/client
- */
-import { injectStyles } from './styles.ts'
-import { PanelState } from './state.ts'
-import { mountSidebarEntry } from './sidebar-entry.ts'
-import { mountPanel } from './panel.ts'
-import { mountNoteWidget } from './note-widget.ts'
-import { disposeEditorPopup } from './editor-popup.ts'
-import { SettingsSection } from './settings-page.ts'
-
-/** Client plugin name. */
-export const name = 'dsh-tiddlywiki/client'
-
-/** Required client services: the slots registry (settings.section seat). */
-export const inject: string[] = ['slots']
-
-/** Effect-hook face the runner provides on the client context. */
-interface ClientContextFace {
-  slots?: {
-    inject(name: string, register: () => unknown): (() => void) | undefined
-    register(
-      opts: { name: string; id: string; order?: number; label?: string | (() => string) },
-      component: unknown,
-    ): () => void
-  }
-  effect?(fn: () => unknown, label?: string): void
-}
-
-/**
- * Client entry: installs styles and mounts the DOM seats + settings page.
- * @param ctx - the cordis client context.
- */
-export function apply(ctx: ClientContextFace): void {
-  try {
-    injectStyles()
-    const state = new PanelState()
-    const disposers: Array<() => void> = []
-    try {
-      disposers.push(mountSidebarEntry(state))
-      disposers.push(mountPanel(state))
-      disposers.push(mountNoteWidget())
-      disposers.push(disposeEditorPopup)
-    } catch (error) {
-      // DOM failures degrade the plugin, never the GUI.
-      console.error('[dsh-tiddlywiki] mount failed:', error)
-    }
-    try {
-      // Settings page → Settings → 「TiddlyWiki 知识库」(config panel §13).
-      const removeSettings = ctx.slots?.inject('settings.section', () =>
-        ctx.slots?.register(
-          { name: 'settings.section', id: 'dsh-tiddlywiki', order: 50, label: 'TiddlyWiki 知识库' },
-          SettingsSection,
-        ),
-      )
-      if (removeSettings !== undefined) disposers.push(removeSettings)
-    } catch (error) {
-      console.error('[dsh-tiddlywiki] settings section failed:', error)
-    }
-    ctx.effect?.(() => () => {
-      for (const dispose of disposers.splice(0)) dispose()
-    }, 'dsh-tiddlywiki: client mount')
-  } catch (error) {
-    console.error('[dsh-tiddlywiki] client half failed to start:', error)
-  }
-}
+/**
+ * Browser half entry for dsh-tiddlywiki (design doc §12, D5): injects the
+ * stylesheet, mounts the sidebar entry, the center-column TiddlyWiki panel,
+ * the floating quick-note widget, and registers the plugin's settings page
+ * (config panel, §13) into the shell's Settings.
+ *
+ * Failure policy: DOM mounting problems are logged, never thrown — the web
+ * shell fails the whole boot when a plugin apply throws.
+ *
+ * Export shape: `name` / `inject` / `apply`, no default.
+ *
+ * @module dsh-tiddlywiki/client
+ */
+import { injectStyles } from './styles.ts'
+import { PanelState } from './state.ts'
+import { mountSidebarEntry } from './sidebar-entry.ts'
+import { mountPanel } from './panel.ts'
+import { mountNoteWidget } from './note-widget.ts'
+import { disposeEditorPopup } from './editor-popup.ts'
+import { SettingsSection } from './settings-page.ts'
+
+/** Client plugin name. */
+export const name = 'dsh-tiddlywiki/client'
+
+/** Required client services: the slots registry (settings.section seat). */
+export const inject: string[] = ['slots']
+
+/** Effect-hook face the runner provides on the client context. */
+interface ClientContextFace {
+  slots?: {
+    inject(name: string, register: () => unknown): (() => void) | undefined
+    register(
+      opts: { name: string; id: string; order?: number; label?: string | (() => string) },
+      component: unknown,
+    ): () => void
+  }
+  effect?(fn: () => unknown, label?: string): void
+}
+
+/**
+ * Client entry: installs styles and mounts the DOM seats + settings page.
+ * @param ctx - the cordis client context.
+ */
+export function apply(ctx: ClientContextFace): void {
+  try {
+    injectStyles()
+    const state = new PanelState()
+    const disposers: Array<() => void> = []
+    try {
+      disposers.push(mountSidebarEntry(state))
+      disposers.push(mountPanel(state))
+      disposers.push(mountNoteWidget())
+      disposers.push(disposeEditorPopup)
+    } catch (error) {
+      // DOM failures degrade the plugin, never the GUI.
+      console.error('[dsh-tiddlywiki] mount failed:', error)
+    }
+    try {
+      // Settings page → Settings → 「TiddlyWiki 知识库」(config panel §13).
+      const removeSettings = ctx.slots?.inject('settings.section', () =>
+        ctx.slots?.register(
+          { name: 'settings.section', id: 'dsh-tiddlywiki', order: 50, label: 'TiddlyWiki 知识库' },
+          SettingsSection,
+        ),
+      )
+      if (removeSettings !== undefined) disposers.push(removeSettings)
+    } catch (error) {
+      console.error('[dsh-tiddlywiki] settings section failed:', error)
+    }
+    ctx.effect?.(() => () => {
+      for (const dispose of disposers.splice(0)) dispose()
+    }, 'dsh-tiddlywiki: client mount')
+  } catch (error) {
+    console.error('[dsh-tiddlywiki] client half failed to start:', error)
+  }
+}