@openpen/module-api 1.1.1 → 1.3.0

package/src/host/popup-anchor.ts

@@ -1,14 +0,0 @@
-/**
- * @openpen/module-api/host — Popup Anchor
- *
- * Re-exports the usePopupAnchor composable and its pure helper
- * calculatePopupAnchor for module components that need anchor-relative
- * popup positioning.
- *
- * Exposed here so module code can import without cross-layer relative paths.
- */
-
-export {
-  usePopupAnchor,
-  calculatePopupAnchor,
-} from '../../../../src/composables/usePopupAnchor'

package/src/host/slot-entries.ts

@@ -1,9 +0,0 @@
-/**
- * @openpen/module-api/host — Slot Entries Reader
- *
- * Re-exports getSlotEntries so module components can render UI driven
- * by other modules' contributions to the same slot (for example,
- * the shape-picker rendering all canvas.shapes contributions).
- */
-
-export { getSlotEntries } from '../../../../src/core/runtime/contribution-store'

package/src/host/stroke-store.ts

@@ -1,20 +0,0 @@
-/**
- * @openpen/module-api/host — Stroke Store
- *
- * Re-exports the stroke store APIs that module tools need.
- * Only the minimum surface required by stroke-eraser (and similar tools)
- * is exposed: getAllStrokes, removeStrokeById, pushCommand.
- *
- * Host-internal state mutation helpers (clearAll, addStroke, undo, redo)
- * are intentionally NOT exported — modules must use hostCommands for
- * undo/redo and canvas clear.
- */
-
-export {
-  getAllStrokes,
-  removeStrokeById,
-  pushCommand,
-} from '../../../../src/services/stroke-store'
-
-// Re-export Stroke type via the public SDK types, not host internals.
-export type { Stroke } from '../types/tool'

package/src/host/stroke-style.ts

@@ -1,15 +0,0 @@
-/**
- * @openpen/module-api/host — Stroke Style
- *
- * Re-exports the public API of the host useStrokeStyle composable.
- * Module components MUST import from here, not from src/composables directly.
- *
- * Exposed here so module components can access it without cross-layer imports.
- */
-
-// Re-export the public API functions that modules need.
-// initStrokeStyleFromSettings is host-boot-only and intentionally NOT exported here.
-export { useStrokeStyle } from '../../../../src/composables/useStrokeStyle'
-
-// Re-export the StrokeColor type via the public SDK types (not host internals).
-export type { StrokeColor } from '../types/tool'

package/src/index.ts

@@ -1,131 +0,0 @@
-/**
- * @openpen/module-api — public contract surface for OpenPen modules.
- *
- * This is the **only** import path that built-in modules and plugins
- * are allowed to use, alongside relative imports, `node:*`, and
- * third-party npm packages. Boundary tests in the OpenPen main repo
- * enforce this rule on `src/core/modules/**` and on plugin code.
- */
-
-// Core helpers
-export { defineModule } from './define-module'
-export { useModuleContext } from './use-module-context'
-export { isValidModuleId, MODULE_ID_RE } from './validation'
-export { resolveLabel, sanitizeIdForI18n } from './locale'
-export type { LocaleMap } from './locale'
-
-// Slot catalogue
-export {
-  ALL_SLOTS,
-  V1_ACTIVE_SLOTS,
-  V1_RESERVED_SLOTS,
-  CONTRIBUTION_KEY_TO_SLOT_ID,
-  isKnownSlot,
-  getSlot,
-} from './slots'
-export type { SlotDefinition, SlotCategory, SlotStatus } from './slots'
-
-// Tool primitives (Point, Stroke, StrokeStyle, Tool, …)
-export type {
-  Point,
-  StrokeColor,
-  StrokeStyle,
-  Stroke,
-  PointerModifiers,
-  Tool,
-} from './types/tool'
-
-// Control bar layout types + helpers
-export type { ControlBarLayout, LayoutGroup, GroupInset, ControlBarContribution } from './types/control-bar-layout'
-export {
-  ControlBarLayoutSchema,
-  LayoutGroupSchema,
-  GroupInsetSchema,
-  DEFAULT_CONTROL_BAR_LAYOUT,
-  repairLayoutL3a,
-  repairLayoutL3b,
-} from './types/control-bar-layout'
-
-// Notification types
-export type { NotifyPayload, NotifyHandle } from './types/notification'
-
-// Module + Contribution types
-export type { OpenPenModule, ModuleSetupContext } from './types/module'
-export type {
-  ModuleContributions,
-  ToolContribution,
-  ShapeContribution,
-  StrokeStyleContribution,
-  HistoryCommandContribution,
-  CanvasLayerContribution,
-  HtmlOverlayContribution,
-  StrokeTransformerContribution,
-  SettingsTabContribution,
-  SettingsPanelContribution,
-  CursorContribution,
-  CursorSpec,
-  SvgCursorSpec,
-  PngCursorSpec,
-  Hotspot,
-  StatusContribution,
-  ModalContribution,
-  TrayMenuContribution,
-  ContextMenuContribution,
-  ThemeTokenContribution,
-  ShortcutContribution,
-  WindowBehaviorContribution,
-  LocaleContribution,
-  EventSubscriptionContribution,
-  LifecycleContribution,
-  StorageContribution,
-  MainHandlerContribution,
-  FileDropContribution,
-} from './types/contributions'
-
-// Host ↔ module inject keys (Vue provide/inject bridge)
-export {
-  STROKE_STYLE_CONTEXT_KEY,
-  SNAP_EDGE_KEY,
-  IS_VERTICAL_KEY,
-  MODAL_MANAGER_KEY,
-  WRAPPER_EL_KEY,
-  ANCHOR_EL_KEY,
-  CONTROL_BAR_ANIMATING_KEY,
-  HOST_DIALOG_OPEN_COUNT_KEY,
-  POPOVER_PLACEMENT_HINT_KEY,
-  ACTIVE_TOOL_KEY,
-} from './inject-keys'
-export type { StrokeStyleContext, SnapEdge, ModalManager, PopoverPlacementHint } from './inject-keys'
-
-// Cursor compilation + sanitisation (used by host runtime; helpers
-// re-exported so plugins can validate cursor specs in their own tests).
-export {
-  compileCursor,
-  sanitizeSvgMarkup,
-  sanitizeCursorContributions,
-  isSafeRelativePath,
-  pluginHostname,
-  pluginAssetUrl,
-  SAFE_CURSOR_KEYWORDS,
-} from './cursors'
-export type {
-  CompiledCursor,
-  CursorResolutionContext,
-  CursorSanitizeRule,
-  CursorSanitizeDiagnostic,
-  CursorSanitizeOptions,
-  CursorSanitizeResult,
-} from './cursors'
-
-// Re-export zod so modules don't need a separate import path.
-export { z } from 'zod'
-
-// Host-internal registry writers — re-exported here so the host's module
-// loader pulls them through the SAME externalised entry point
-// (`@openpen/module-api`, runtime bundle: openpen-runtime/module-api.js)
-// that `useModuleContext` reads from. Importing them via
-// `@openpen/module-api/host` instead would inline a duplicate
-// module-context-registry into the host bundle, breaking state-sharing
-// between writers and readers in production builds (see
-// project_dev_prod_parity.md). Plugin authors MUST NOT use these.
-export { setModuleContext, clearModuleContext } from './host/module-context-registry'

package/src/slots.ts

@@ -1,135 +0,0 @@
-/**
- * OpenPen Contribution Slot catalogue.
- *
- * Slots are the only places where modules can affect the host app.
- * Adding a slot is an architectural change — it usually requires a
- * new adapter on the OpenPen side and a minor version bump of this
- * package. Removing a slot is a breaking change.
- *
- * `status: 'v1'` slots are wired through to runtime adapters.
- * `status: 'reserved'` slots accept registrations and pass validation;
- * no runtime adapter is active yet so contributions are stored but
- * inert. Forward-compatible: modules can ship against reserved slots
- * without any plugin-side changes once an adapter lands.
- */
-
-export type SlotCategory = 'canvas' | 'ui' | 'system'
-export type SlotStatus = 'v1' | 'reserved'
-
-export interface SlotDefinition {
-  /** Dotted slot id, e.g. `'canvas.tools'`. */
-  id: string
-  /** Implementation status — see file header. */
-  status: SlotStatus
-  /** High-level grouping for documentation and UI. */
-  category: SlotCategory
-  /** One-sentence purpose, shown in `docs/reference/slots.md`. */
-  description: string
-}
-
-/**
- * v1 active slots (16). Wired through to runtime adapters.
- */
-export const V1_ACTIVE_SLOTS: readonly SlotDefinition[] = [
-  // Canvas
-  { id: 'canvas.tools', status: 'v1', category: 'canvas', description: 'Drawing tools driven by pointer events.' },
-  { id: 'canvas.shapes', status: 'v1', category: 'canvas', description: 'Shape primitives consumed by the shape tool.' },
-  { id: 'canvas.stroke.style', status: 'v1', category: 'canvas', description: 'Writers into the shared stroke style store.' },
-  { id: 'canvas.layers.background', status: 'v1', category: 'canvas', description: 'Render below strokes (grids, watermarks).' },
-  { id: 'canvas.layers.overlay', status: 'v1', category: 'canvas', description: 'Render above strokes (rulers, guides).' },
-  { id: 'canvas.html.overlay', status: 'v1', category: 'canvas', description: 'Mount HTML elements above the canvas (text, stickers).' },
-  // UI
-  { id: 'ui.control-bar', status: 'v1', category: 'ui', description: 'Control bar item slot (groups and ordering managed by layout config).' },
-  { id: 'ui.settings.tabs', status: 'v1', category: 'ui', description: 'Tabs in the settings window.' },
-  { id: 'ui.settings.panels', status: 'v1', category: 'ui', description: 'Sections inside the Features settings tab, grouped by module.' },
-  { id: 'ui.cursors', status: 'v1', category: 'ui', description: 'Drawing-mode cursor styles.' },
-  { id: 'ui.status', status: 'v1', category: 'ui', description: 'Ephemeral status badges on the control bar.' },
-  { id: 'ui.modals', status: 'v1', category: 'ui', description: 'Registered modals managed by the global modal stack.' },
-  // System
-  { id: 'system.shortcuts', status: 'v1', category: 'system', description: 'Global and drawing-mode keyboard shortcuts.' },
-  { id: 'system.locales', status: 'v1', category: 'system', description: 'i18n dictionary contributions.' },
-  { id: 'system.main.handlers', status: 'v1', category: 'system', description: 'Node-side IPC handlers for main process capabilities.' },
-  { id: 'system.events', status: 'v1', category: 'system', description: 'Subscribers and emitters on the domain event bus.' },
-  { id: 'system.lifecycle', status: 'v1', category: 'system', description: 'App lifecycle hooks (onReady / onSuspend / onQuit).' },
-] as const
-
-/**
- * v1 reserved slots. Registrations pass validation but no runtime
- * adapter is active yet.
- */
-export const V1_RESERVED_SLOTS: readonly SlotDefinition[] = [
-  { id: 'canvas.history.commands', status: 'reserved', category: 'canvas', description: 'Undo/redo history commands. Adapter not yet active; built-in command types are used internally.' },
-  { id: 'canvas.stroke.transformers', status: 'reserved', category: 'canvas', description: 'Post-process strokes after creation (smooth, simplify).' },
-  { id: 'ui.tray.menu', status: 'reserved', category: 'ui', description: 'System tray menu items. Adapter not yet active.' },
-  { id: 'ui.context.menu', status: 'reserved', category: 'ui', description: 'Right-click context menu items on canvas / control bar.' },
-  { id: 'ui.theme.tokens', status: 'reserved', category: 'ui', description: 'CSS custom property contributions (colour swatches, spacing tokens).' },
-  { id: 'system.window.behaviors', status: 'reserved', category: 'system', description: 'Window behavior customizations. Adapter not yet active.' },
-  { id: 'system.storage', status: 'reserved', category: 'system', description: 'Per-plugin isolated storage at ~/.openpen/plugins/<id>/data/. Adapter not yet active; first real consumer will drive the storage backend design.' },
-  { id: 'system.file.drop', status: 'reserved', category: 'system', description: 'Handlers for files dropped onto the canvas.' },
-] as const
-
-/**
- * All slots (active + reserved). Source of truth for validation.
- */
-export const ALL_SLOTS: readonly SlotDefinition[] = [
-  ...V1_ACTIVE_SLOTS,
-  ...V1_RESERVED_SLOTS,
-]
-
-const SLOT_BY_ID = new Map<string, SlotDefinition>(
-  ALL_SLOTS.map((s) => [s.id, s])
-)
-
-/** Returns `true` when `id` matches a slot in {@link ALL_SLOTS} (active or reserved). */
-export function isKnownSlot(id: string): boolean {
-  return SLOT_BY_ID.has(id)
-}
-
-/**
- * Returns the {@link SlotDefinition} for a known slot id, or `undefined` if
- * the id is not registered in {@link ALL_SLOTS}.
- */
-export function getSlot(id: string): SlotDefinition | undefined {
-  return SLOT_BY_ID.get(id)
-}
-
-/**
- * Mapping from `contributes` field name (camelCase) to slot id (dotted).
- *
- * Modules express contributions via the ergonomic camelCase keys on
- * `contributes` (e.g. `historyCommands`); the validator maps them
- * back to slot ids (`canvas.history.commands`) before checking against
- * `ALL_SLOTS`.
- *
- * Adding a new field here is part of adding a new slot.
- */
-export const CONTRIBUTION_KEY_TO_SLOT_ID: Record<string, string> = {
-  // Canvas
-  tools: 'canvas.tools',
-  shapes: 'canvas.shapes',
-  strokeStyle: 'canvas.stroke.style',
-  historyCommands: 'canvas.history.commands',
-  backgroundLayers: 'canvas.layers.background',
-  overlayLayers: 'canvas.layers.overlay',
-  htmlOverlays: 'canvas.html.overlay',
-  strokeTransformers: 'canvas.stroke.transformers',
-  // UI
-  controlBar: 'ui.control-bar',
-  settingsTabs: 'ui.settings.tabs',
-  settingsPanels: 'ui.settings.panels',
-  cursors: 'ui.cursors',
-  status: 'ui.status',
-  modals: 'ui.modals',
-  trayMenu: 'ui.tray.menu',
-  contextMenu: 'ui.context.menu',
-  themeTokens: 'ui.theme.tokens',
-  // System
-  shortcuts: 'system.shortcuts',
-  windowBehaviors: 'system.window.behaviors',
-  locales: 'system.locales',
-  events: 'system.events',
-  lifecycle: 'system.lifecycle',
-  storage: 'system.storage',
-  mainHandlers: 'system.main.handlers',
-  fileDrop: 'system.file.drop',
-}

package/src/types/contributions.ts

@@ -1,333 +0,0 @@
-import type { Component } from 'vue'
-import type { LocaleMap } from '../locale'
-import type { Stroke, Tool } from './tool'
-import type { ControlBarContribution } from './control-bar-layout'
-
-export type { ControlBarContribution }
-
-/**
- * The shape of `OpenPenModule.contributes`. Every field is optional;
- * `defineModule` requires at least one field to be present and rejects
- * any unknown field at module-author boundary time.
- *
- * Each field corresponds to a slot in {@link import('../slots').ALL_SLOTS}.
- * The mapping from camelCase field name to dotted slot id lives in
- * `CONTRIBUTION_KEY_TO_SLOT_ID`.
- */
-export interface ModuleContributions {
-  // ── Canvas ──────────────────────────────────────────────────────────────
-  tools?: ToolContribution[]
-  shapes?: ShapeContribution[]
-  strokeStyle?: StrokeStyleContribution
-  historyCommands?: HistoryCommandContribution[]
-  backgroundLayers?: CanvasLayerContribution[]
-  overlayLayers?: CanvasLayerContribution[]
-  htmlOverlays?: HtmlOverlayContribution[]
-  /** ⏳ Reserved slot — accepts registrations, adapter not yet wired. */
-  strokeTransformers?: StrokeTransformerContribution[]
-
-  // ── UI ──────────────────────────────────────────────────────────────────
-  controlBar?: ControlBarContribution[]
-  settingsTabs?: SettingsTabContribution[]
-  settingsPanels?: SettingsPanelContribution[]
-  cursors?: CursorContribution[]
-  status?: StatusContribution[]
-  modals?: ModalContribution[]
-  trayMenu?: TrayMenuContribution[]
-  /** ⏳ Reserved slot — accepts registrations, adapter not yet wired. */
-  contextMenu?: ContextMenuContribution[]
-  /** ⏳ Reserved slot — accepts registrations, adapter not yet wired. */
-  themeTokens?: ThemeTokenContribution
-
-  // ── System ──────────────────────────────────────────────────────────────
-  shortcuts?: ShortcutContribution[]
-  windowBehaviors?: WindowBehaviorContribution[]
-  locales?: LocaleContribution
-  events?: EventSubscriptionContribution[]
-  lifecycle?: LifecycleContribution
-  storage?: StorageContribution
-  mainHandlers?: MainHandlerContribution
-  /** ⏳ Reserved slot — accepts registrations, adapter not yet wired. */
-  fileDrop?: FileDropContribution[]
-}
-
-// ════════════════════════════════════════════════════════════════════════
-// Below: per-slot contribution shapes. These are the locked public-facing
-// names referenced by docs and the validator; their internals can extend
-// without breaking modules.
-// ════════════════════════════════════════════════════════════════════════
-
-/**
- * Drawing tool driven by pointer events. Implements the full `Tool`
- * interface (onPointerDown / Move / Up) plus optional metadata for
- * the toolbar UI and an optional `renderStroke` for tools whose
- * strokes need custom redraw semantics (shapes, erasers, anything
- * beyond a simple polyline).
- */
-export interface ToolContribution extends Tool {
-  id: string
-  label?: string | LocaleMap
-  /**
-   * SVG markup string for this tool's icon in the control-bar button.
-   *
-   * The host renders tool icons via `v-html`, so only raw SVG strings are
-   * accepted (not Vue components or CSS class names). Recommended size is
-   * `width="16" height="16"` with `stroke="currentColor"` so the icon
-   * inherits the button's colour automatically.
-   *
-   * @example
-   * icon: '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 17c3-3 6-6 9-3s6 0 9-3"/></svg>'
-   *
-   * Note: built-in tools (freehand, line, eraser) use their own Vue button
-   * components rather than this field — `icon` is the lightweight path for
-   * plugin-contributed tools that do not need a custom button component.
-   */
-  icon?: string
-  /**
-   * Custom redraw renderer. When omitted, canvas-engine falls back
-   * to a polyline render through `stroke.points` — sufficient for
-   * freehand- and line-style tools.
-   */
-  renderStroke?: (canvasCtx: CanvasRenderingContext2D, stroke: Stroke) => void
-}
-
-/** Shape primitive used by the shape tool. */
-export interface ShapeContribution {
-  id: string
-  label?: string | LocaleMap
-  /**
-   * Vue component or SVG string for the shape icon in control-bar / sub-panel.
-   * Host renders via `<component :is="icon">`.
-   * Component icons MAY accept an optional `filled?: boolean` prop —
-   * the host passes the current fill-toggle state so icons can mirror it
-   * (e.g. solid vs outline rendering). Plugin icons that ignore the prop
-   * still work; they just won't reflect fill state visually.
-   */
-  icon?: Component | string
-  draw: (...args: unknown[]) => void
-}
-
-/**
- * Stroke style writer. Modules declare which keys of the shared
- * stroke style store they write to; collision detection happens at
- * module-validator time.
- */
-export interface StrokeStyleContribution {
-  /** Keys this module writes (e.g. `['lineWidth']`, `['color']`). */
-  provides: string[]
-}
-
-/**
- * Undo/redo command handler for the `canvas.history.commands` slot.
- *
- * The host calls `undo` / `redo` with whatever `payload` was stored when the
- * command was pushed onto the history stack. The contributing module decides
- * the payload shape — the host treats it as `unknown` and passes it through
- * without inspection.
- */
-export interface HistoryCommandContribution {
-  type: string
-  undo: (payload: unknown) => void
-  redo: (payload: unknown) => void
-}
-
-export interface CanvasLayerContribution {
-  id: string
-  /** Render priority within the layer; higher = drawn later (on top). */
-  order?: number
-  render: (ctx: CanvasRenderingContext2D) => void
-}
-
-export interface HtmlOverlayContribution {
-  id: string
-  component: Component
-}
-
-export interface StrokeTransformerContribution {
-  id: string
-  /** Receives a stroke, returns a transformed stroke. Slot ⏳ reserved. */
-  transform: (stroke: unknown) => unknown
-}
-
-export interface SettingsTabContribution {
-  id: string
-  label: string | LocaleMap
-  component: Component
-}
-
-export interface SettingsPanelContribution {
-  id: string
-  label: string | LocaleMap
-  component: Component
-}
-
-/** Hotspot offset in CSS pixels relative to the cursor image's top-left. */
-export interface Hotspot {
-  x: number
-  y: number
-}
-
-/**
- * Vector cursor: inline SVG markup OR a plugin-internal relative path
- * to a `.svg` file. URL-shaped strings, absolute paths, and `..` segments
- * are rejected at contribution-validation time.
- */
-export interface SvgCursorSpec {
-  svg: string
-  hotspot?: Hotspot
-  /** CSS keyword fallback for legacy / non-overlay contexts. Defaults to `'crosshair'`. */
-  fallback?: string
-}
-
-/**
- * Raster cursor: plugin-internal relative path to a `.png` file. Inline
- * form is not supported — PNG payload comes through `openpen-plugin://`.
- */
-export interface PngCursorSpec {
-  png: string
-  hotspot?: Hotspot
-  fallback?: string
-}
-
-/**
- * Cursor specification. The legacy `string` form must be one of the
- * whitelisted CSS keywords (see `SAFE_CURSOR_KEYWORDS` in cursors.ts);
- * any string containing `url(` / `image-set(` / `-webkit-image-set(` is
- * rejected to keep the asset trust boundary closed.
- */
-export type CursorSpec = string | SvgCursorSpec | PngCursorSpec
-
-export interface CursorContribution {
-  id: string
-  cursor: CursorSpec
-}
-
-export interface StatusContribution {
-  id: string
-  component: Component
-}
-
-export interface ModalContribution {
-  id: string
-  component: Component
-}
-
-export interface TrayMenuContribution {
-  id: string
-  label: string | LocaleMap
-  click: () => void
-}
-
-export interface ContextMenuContribution {
-  id: string
-  label: string | LocaleMap
-  /** Where the menu may appear; runtime filters by context at open time. */
-  context: 'canvas' | 'toolbar' | 'tray'
-  click: () => void
-}
-
-/**
- * CSS custom property contributions for the `ui.theme.tokens` slot.
- *
- * Keys are CSS custom property names (e.g. `'--my-plugin-accent'`).
- * Values are CSS color or length values (e.g. `'#ff6600'`, `'4px'`).
- * The host merges all contributions into `:root` at startup.
- */
-export type ThemeTokenContribution = Record<string, string>
-
-export interface ShortcutContribution {
-  id: string
-  /** Accelerator string; tinykeys-style or Electron globalShortcut format. */
-  keys: string
-  /** `'global'` registers OS-wide; `'drawing'` only when overlay is active. */
-  scope: 'global' | 'drawing'
-  handler: () => void
-  /** Human-readable name. Omit to hide this shortcut from the user-visible shortcuts list. */
-  label?: string | LocaleMap
-  /** Optional secondary description shown below the label in the shortcuts settings panel. */
-  sublabel?: string | LocaleMap
-  /** When true, the user can rebind this key. The chosen key is persisted under `config.json → customShortcuts`. */
-  userCustomizable?: boolean
-}
-
-export interface WindowBehaviorContribution {
-  id: string
-  /** Reserved — concrete behaviour API not yet defined. */
-  [key: string]: unknown
-}
-
-/** Leaf or branch in a locale dictionary. Leaves must be strings. */
-type LocaleDictValue = string | LocaleDict
-
-/**
- * Recursive locale dictionary.
- * Leaves are translated strings; branches are nested sub-dictionaries.
- * Use the `interface` form (not `type`) to allow self-reference without
- * triggering TypeScript's circular-type restrictions.
- */
-interface LocaleDict {
-  [key: string]: LocaleDictValue
-}
-
-/**
- * A locale dictionary keyed by BCP-47 tag (e.g. `'en'`, `'zh-Hant'`).
- *
- * Values are per-locale message dictionaries. Supports both flat and nested
- * layouts — vue-i18n treats `.` in ctx.t(key) as a nested path separator,
- * so keys like `'notif.ready'` must use a nested object dict
- * `{ notif: { ready: '...' } }`, not a flat key `{ 'notif.ready': '...' }`.
- *
- * Non-string leaves are rejected at compile time; use ctx.t() to resolve
- * keys to strings before passing them to runtime APIs.
- */
-export type LocaleContribution = Record<string, LocaleDict>
-
-/**
- * Subscription to a named domain event on the `system.events` slot.
- *
- * `event` must match the event name emitted by another module (or the host)
- * via `system.events`. The host routes each emitted event to all registered
- * handlers whose `event` string matches.
- */
-export interface EventSubscriptionContribution {
-  event: string
-  handler: (payload: unknown) => void
-}
-
-/**
- * App lifecycle hooks for the `system.lifecycle` slot.
- *
- * Call order: `setup` (from `OpenPenModule.setup`) → `onReady` (host fully
- * booted) → `onSuspend` (overlay hidden) → `onQuit` (app shutting down).
- * All hooks may return a Promise; the host awaits each before advancing.
- */
-export interface LifecycleContribution {
-  onReady?: () => void | Promise<void>
-  onSuspend?: () => void | Promise<void>
-  onQuit?: () => void | Promise<void>
-}
-
-/**
- * Marker that this module wants an isolated storage area at
- * `~/.openpen/plugins/<id>/data/`. Capacity / quota policy is defined
- * by the host runtime.
- */
-export interface StorageContribution {
-  /** If true, the host pre-creates the data directory at module load. */
-  preCreate?: boolean
-}
-
-/**
- * Map of action name to async handler. Routed from the renderer via
- * `window.openPenApi.moduleCall(moduleId, action, payload)`.
- */
-export type MainHandlerContribution = Record<
-  string,
-  (payload: unknown) => unknown | Promise<unknown>
->
-
-export interface FileDropContribution {
-  /** MIME types this handler accepts (e.g. `['image/png']`). */
-  accept: string[]
-  handle: (files: File[]) => void | Promise<void>
-}