import { describe, expect, it } from 'vitest' import Loader from '@cordisjs/plugin-loader' import * as sidebar from '../src/index.ts' /** * Run the real namespace export through `Loader.unwrapExports`; a stray * default would discard `name`, `inject`, `Config`, and `apply`. Same guard * the official plugin repos ship (dsh-external/turtle-ui, * packages/ui/jsonrpc). */ describe('dsh-apes-sidebar plugin export shape', () => { it('has the namespace-plugin export shape (no stray default) so the Loader keeps name/inject/Config/apply', () => { expect('default' in sidebar).toBe(false) expect(typeof sidebar.apply).toBe('function') const loader = Object.create(Loader.prototype) as Loader const unwrapped = loader.unwrapExports(sidebar) as Record expect(unwrapped).toBe(sidebar) expect(unwrapped.name).toBe('dsh-apes-sidebar') expect(unwrapped.inject).toEqual(['webServer', 'sessions', 'webRuntime', 'tools']) expect(unwrapped.Config).toBeDefined() expect(typeof unwrapped.apply).toBe('function') }) it('exports the schemastery Config with the documented tunable fields', () => { const schema = sidebar.Config expect(schema).toBeDefined() // The resolved defaults mirror the pre-config constants. const resolved = (schema as unknown as { (input: Record | undefined): Record })(undefined) expect(resolved.readLimit).toBe(512 * 1024) expect(resolved.mediaLimit).toBe(20 * 1024 * 1024) expect(resolved.listLimit).toBe(1000) expect(resolved.terminalsPerSession).toBe(3) expect(resolved.reconnectGraceMs).toBe(30_000) // The terminal shell config defaults to auto-resolution (empty shell = // the platform chain in defaultShell()). expect(resolved.shell).toBe('') // Shell args default to an empty list; non-empty values replace the // automatic platform login flag. expect(resolved.shellArgs).toEqual([]) const configured = (schema as unknown as { (input: Record | undefined): Record })({ shell: 'pwsh.exe' }) expect(configured.shell).toBe('pwsh.exe') const configuredWithArgs = (schema as unknown as { (input: Record | undefined): Record })({ shell: '/bin/zsh', shellArgs: ['--noprofile', '--no-rc'] }) expect(configuredWithArgs.shell).toBe('/bin/zsh') expect(configuredWithArgs.shellArgs).toEqual(['--noprofile', '--no-rc']) }) it('registers the side card preferences schema with the documented defaults', async () => { const { PrefsSchema, SIDEBAR_PREFS_NS, SIDEBAR_PREFS_DEFAULTS } = await import('../src/config.ts') expect(SIDEBAR_PREFS_NS).toBe('better-sidebar') const resolved = (PrefsSchema as unknown as { (input: Record | undefined): Record })(undefined) expect(resolved.openByDefault).toBeUndefined() expect(resolved.defaultWidthPercent).toBeUndefined() expect(resolved.changesDiffFloat).toBeUndefined() expect(resolved.autoOpenSubagent).toBe(true) // A new background job auto-opens the Jobs page too. expect(resolved.autoOpenJobs).toBe(true) // The terminal tools default OFF (the feature is dormant until the user // enables it in the side card settings). expect(resolved.agentTerminalTools).toBe(false) // The sidebar-open tool defaults OFF too (same dormant-until-enabled rule). expect(resolved.agentOpenTools).toBe(false) // The terminal font customizations default to the theme (empty family) // and 13px. expect(resolved.terminalFontFamily).toBe('') expect(resolved.terminalFontSize).toBe(13) // The position-compat scheme is declared WITHOUT a schema default so a // stored document that predates it resolves without the field — the // CLIENT parsePrefs then applies the conservative `auto` default (or // migrates the legacy boolean), which is exactly what makes old // documents migrate instead of silently flipping to a scheme. The // legacy strip keeps its schema default of 40px. expect(resolved.titleBarScheme).toBeUndefined() expect(resolved.titleBarPresetId).toBeUndefined() expect(resolved.customCss).toBeUndefined() expect(resolved.titleBarCompat).toBe(false) expect(resolved.titleBarStripPx).toBe(40) // The enable-switch maps resolve to {} (everything on) for old documents. expect(resolved.tabsEnabled).toEqual({}) expect(resolved.viewersEnabled).toEqual({}) // The separate file-window mode is the default (each file opens its own // tab; the merged editor-explorer is opt-in). expect(resolved.editorExplorer).toBe(false) // The workspace fence (containment over the sidebar fs routes) defaults // ON — the safe default never depends on the stored document. expect(resolved.workspaceFence).toBe(true) // A stored overridden value resolves through (the range contract is // enforced by the settings service on write); the new pref keeps its // default when the stored document predates it. const overridden = (PrefsSchema as unknown as { (input: Record | undefined): Record })({ openByDefault: false, defaultWidthPercent: 45, changesDiffFloat: true }) // Schemastery's object schema is OPEN: a document written by an older // plugin version still carrying the retired keys resolves them through // verbatim. They are inert — the typed value the client consumes // (parsePrefs) drops them (tests/prefs.spec.ts) — and the defaults no // longer declare them. // titleBarScheme / titleBarPresetId / customCss are declared WITHOUT a // schema default (the client's parsePrefs supplies them), so they are // absent from a resolved document that never stored them. const { titleBarScheme, titleBarPresetId, customCss, ...schemaDefaults } = SIDEBAR_PREFS_DEFAULTS void titleBarScheme; void titleBarPresetId; void customCss expect(overridden).toEqual({ ...schemaDefaults, openByDefault: false, defaultWidthPercent: 45, changesDiffFloat: true }) }) })