@noego/wood 0.0.1

package/dist/components/contextMenu.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contextMenu_exports = {};
+__export(contextMenu_exports, {
+  contextMenu: () => contextMenu,
+  executeCallback: () => executeCallback
+});
+module.exports = __toCommonJS(contextMenu_exports);
+const WOOD_INTERNAL_BRIDGE_KEY = "__NOEGO_WOOD_BRIDGE__";
+const callbacks = /* @__PURE__ */ new Map();
+let idCounter = 0;
+function nextId() {
+  return `__cb_${++idCounter}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function executeCallback(id) {
+  const fn = callbacks.get(id);
+  if (fn) {
+    callbacks.delete(id);
+    fn();
+  }
+}
+function buildDefaults(e) {
+  const target = e.target;
+  const selection = document.getSelection()?.toString();
+  const isEditable = target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target.isContentEditable;
+  const linkEl = target.closest("a[href]");
+  const items = [];
+  if (isEditable) {
+    items.push(
+      { label: "Cut", action: "cut" },
+      { label: "Copy", action: "copy" },
+      { label: "Paste", action: "paste" },
+      { label: "Select All", action: "selectAll" }
+    );
+  } else if (selection) {
+    items.push({ label: "Copy", action: "copy" });
+  }
+  if (linkEl) {
+    if (items.length) items.push({ type: "separator" });
+    items.push(
+      { label: "Open Link", action: "openExternal", data: linkEl.getAttribute("href") },
+      { label: "Copy Link Address", action: "copyText", data: linkEl.getAttribute("href") }
+    );
+  }
+  return items;
+}
+function serializeItems(entries) {
+  return entries.map((entry, i) => {
+    if ("type" in entry && entry.type === "separator") {
+      return { id: `sep_${i}`, type: "separator" };
+    }
+    const e = entry;
+    if (typeof e.action === "function") {
+      const cbId = nextId();
+      callbacks.set(cbId, e.action);
+      return {
+        id: cbId,
+        label: e.label,
+        _callbackId: cbId,
+        disabled: e.disabled
+      };
+    }
+    return {
+      id: `${e.action}_${i}`,
+      label: e.label,
+      action: e.action,
+      data: e.data,
+      disabled: e.disabled
+    };
+  });
+}
+function contextMenu(node, param) {
+  let currentParam = param;
+  function getBridge() {
+    const bridge = window[WOOD_INTERNAL_BRIDGE_KEY];
+    if (!bridge || typeof bridge !== "object") {
+      throw new Error(`Wood bridge "${WOOD_INTERNAL_BRIDGE_KEY}" not found.`);
+    }
+    return bridge;
+  }
+  function handler(e) {
+    e.preventDefault();
+    let entries;
+    if (Array.isArray(currentParam)) {
+      entries = currentParam;
+    } else {
+      const cfg = currentParam;
+      let defaults = [];
+      if (cfg.defaults) {
+        defaults = buildDefaults(e);
+        if (cfg.remove) {
+          const removeSet = new Set(cfg.remove);
+          defaults = defaults.filter((item) => {
+            if ("type" in item && item.type === "separator") return true;
+            const actionKey = typeof item.action === "string" ? item.action : "";
+            return !removeSet.has(actionKey);
+          });
+        }
+        if (cfg.overrides) {
+          defaults = defaults.map((item) => {
+            if ("type" in item && item.type === "separator") return item;
+            const entry = item;
+            const override = cfg.overrides[entry.action];
+            if (override) {
+              return {
+                ...entry,
+                ...override.label !== void 0 && { label: override.label },
+                ...override.disabled !== void 0 && { disabled: override.disabled }
+              };
+            }
+            return item;
+          });
+        }
+      }
+      if (cfg.items && cfg.items.length > 0) {
+        if (defaults.length > 0) {
+          entries = [...defaults, { type: "separator" }, ...cfg.items];
+        } else {
+          entries = cfg.items;
+        }
+      } else {
+        entries = defaults;
+      }
+    }
+    if (entries.length === 0) return;
+    const serialized = serializeItems(entries);
+    getBridge().__contextMenu.show({
+      items: serialized,
+      position: { x: e.clientX, y: e.clientY }
+    });
+  }
+  node.addEventListener("contextmenu", handler);
+  return {
+    update(newParam) {
+      currentParam = newParam;
+    },
+    destroy() {
+      node.removeEventListener("contextmenu", handler);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  contextMenu,
+  executeCallback
+});
+//# sourceMappingURL=contextMenu.cjs.map

package/dist/components/contextMenu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/contextMenu.ts"],"sourcesContent":["/**\n * Svelte action + types for the `use:contextMenu` directive.\n *\n * Prevents the native contextmenu event, builds smart defaults when\n * `defaults: true`, serializes items (storing callbacks in a module-level\n * map), and calls the internal Wood bridge `__contextMenu.show()`.\n */\nconst WOOD_INTERNAL_BRIDGE_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype InternalWoodBridge = {\n  __contextMenu: {\n    show(data: { items: unknown[]; position: { x: number; y: number } }): Promise<void>;\n  };\n};\n\n// ── Types ────────────────────────────────────────────────────────────\n\n/** Individual menu entry. */\nexport type ContextMenuEntry =\n  | { label: string; action: string; data?: string; disabled?: boolean }\n  | { label: string; action: () => void; disabled?: boolean }\n  | { type: 'separator' };\n\n/** What the developer passes to `use:contextMenu`. */\n/** Overrides applied to default items by action key. */\nexport type ContextMenuOverride = { label?: string; disabled?: boolean };\n\nexport type ContextMenuParam =\n  | ContextMenuEntry[]\n  | {\n      defaults?: boolean;\n      remove?: string[];\n      overrides?: Record<string, ContextMenuOverride>;\n      items?: ContextMenuEntry[];\n    };\n\n/** Resolved item shape passed to the `menu` snippet. */\nexport interface ResolvedMenuItem {\n  label: string;\n  disabled: boolean;\n  type?: 'separator';\n  execute: () => void;\n}\n\n// ── Callback map ─────────────────────────────────────────────────────\n\nconst callbacks = new Map<string, () => void>();\nlet idCounter = 0;\n\nfunction nextId(): string {\n  return `__cb_${++idCounter}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Execute a stored callback by its ID and remove it from the map.\n * Called from `ContextMenuProvider` when it receives `__contextMenu:callback`.\n */\nexport function executeCallback(id: string): void {\n  const fn = callbacks.get(id);\n  if (fn) {\n    callbacks.delete(id);\n    fn();\n  }\n}\n\n// ── Smart defaults ───────────────────────────────────────────────────\n\nfunction buildDefaults(e: MouseEvent): ContextMenuEntry[] {\n  const target = e.target as HTMLElement;\n  const selection = document.getSelection()?.toString();\n  const isEditable =\n    target instanceof HTMLInputElement ||\n    target instanceof HTMLTextAreaElement ||\n    target.isContentEditable;\n  const linkEl = target.closest('a[href]') as HTMLAnchorElement | null;\n  const items: ContextMenuEntry[] = [];\n\n  if (isEditable) {\n    items.push(\n      { label: 'Cut', action: 'cut' },\n      { label: 'Copy', action: 'copy' },\n      { label: 'Paste', action: 'paste' },\n      { label: 'Select All', action: 'selectAll' },\n    );\n  } else if (selection) {\n    items.push({ label: 'Copy', action: 'copy' });\n  }\n\n  if (linkEl) {\n    if (items.length) items.push({ type: 'separator' });\n    items.push(\n      { label: 'Open Link', action: 'openExternal', data: linkEl.getAttribute('href')! },\n      { label: 'Copy Link Address', action: 'copyText', data: linkEl.getAttribute('href')! },\n    );\n  }\n\n  return items;\n}\n\n// ── Serialization ────────────────────────────────────────────────────\n\ninterface SerializedItem {\n  id: string;\n  label?: string;\n  action?: string;\n  data?: string;\n  _callbackId?: string;\n  disabled?: boolean;\n  type?: 'separator';\n}\n\nfunction serializeItems(entries: ContextMenuEntry[]): SerializedItem[] {\n  return entries.map((entry, i) => {\n    if ('type' in entry && entry.type === 'separator') {\n      return { id: `sep_${i}`, type: 'separator' as const };\n    }\n\n    const e = entry as Exclude<ContextMenuEntry, { type: 'separator' }>;\n\n    if (typeof e.action === 'function') {\n      const cbId = nextId();\n      callbacks.set(cbId, e.action);\n      return {\n        id: cbId,\n        label: e.label,\n        _callbackId: cbId,\n        disabled: e.disabled,\n      };\n    }\n\n    return {\n      id: `${e.action}_${i}`,\n      label: e.label,\n      action: e.action,\n      data: (e as { data?: string }).data,\n      disabled: e.disabled,\n    };\n  });\n}\n\n// ── Svelte action ────────────────────────────────────────────────────\n\nexport function contextMenu(node: HTMLElement, param: ContextMenuParam) {\n  let currentParam = param;\n\n  function getBridge(): InternalWoodBridge {\n    const bridge = (window as unknown as Record<string, unknown>)[WOOD_INTERNAL_BRIDGE_KEY];\n    if (!bridge || typeof bridge !== 'object') {\n      throw new Error(`Wood bridge \"${WOOD_INTERNAL_BRIDGE_KEY}\" not found.`);\n    }\n    return bridge as InternalWoodBridge;\n  }\n\n  function handler(e: MouseEvent) {\n    e.preventDefault();\n\n    let entries: ContextMenuEntry[];\n\n    if (Array.isArray(currentParam)) {\n      entries = currentParam;\n    } else {\n      const cfg = currentParam;\n      let defaults: ContextMenuEntry[] = [];\n\n      if (cfg.defaults) {\n        defaults = buildDefaults(e);\n\n        // Apply remove\n        if (cfg.remove) {\n          const removeSet = new Set(cfg.remove);\n          defaults = defaults.filter(item => {\n            if ('type' in item && item.type === 'separator') return true;\n            const actionKey = typeof (item as any).action === 'string' ? (item as any).action : '';\n            return !removeSet.has(actionKey);\n          });\n        }\n\n        // Apply overrides\n        if (cfg.overrides) {\n          defaults = defaults.map((item): ContextMenuEntry => {\n            if ('type' in item && item.type === 'separator') return item;\n            const entry = item as { label: string; action: string; data?: string; disabled?: boolean };\n            const override = cfg.overrides![entry.action];\n            if (override) {\n              return {\n                ...entry,\n                ...(override.label !== undefined && { label: override.label }),\n                ...(override.disabled !== undefined && { disabled: override.disabled }),\n              };\n            }\n            return item;\n          });\n        }\n      }\n\n      // Append custom items (with separator if both exist)\n      if (cfg.items && cfg.items.length > 0) {\n        if (defaults.length > 0) {\n          entries = [...defaults, { type: 'separator' }, ...cfg.items];\n        } else {\n          entries = cfg.items;\n        }\n      } else {\n        entries = defaults;\n      }\n    }\n\n    if (entries.length === 0) return;\n\n    const serialized = serializeItems(entries);\n\n    getBridge().__contextMenu.show({\n      items: serialized,\n      position: { x: e.clientX, y: e.clientY },\n    });\n  }\n\n  node.addEventListener('contextmenu', handler);\n\n  return {\n    update(newParam: ContextMenuParam) {\n      currentParam = newParam;\n    },\n    destroy() {\n      node.removeEventListener('contextmenu', handler);\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,MAAM,2BAA2B;AAuCjC,MAAM,YAAY,oBAAI,IAAwB;AAC9C,IAAI,YAAY;AAEhB,SAAS,SAAiB;AACxB,SAAO,QAAQ,EAAE,SAAS,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AACtE;AAMO,SAAS,gBAAgB,IAAkB;AAChD,QAAM,KAAK,UAAU,IAAI,EAAE;AAC3B,MAAI,IAAI;AACN,cAAU,OAAO,EAAE;AACnB,OAAG;AAAA,EACL;AACF;AAIA,SAAS,cAAc,GAAmC;AACxD,QAAM,SAAS,EAAE;AACjB,QAAM,YAAY,SAAS,aAAa,GAAG,SAAS;AACpD,QAAM,aACJ,kBAAkB,oBAClB,kBAAkB,uBAClB,OAAO;AACT,QAAM,SAAS,OAAO,QAAQ,SAAS;AACvC,QAAM,QAA4B,CAAC;AAEnC,MAAI,YAAY;AACd,UAAM;AAAA,MACJ,EAAE,OAAO,OAAO,QAAQ,MAAM;AAAA,MAC9B,EAAE,OAAO,QAAQ,QAAQ,OAAO;AAAA,MAChC,EAAE,OAAO,SAAS,QAAQ,QAAQ;AAAA,MAClC,EAAE,OAAO,cAAc,QAAQ,YAAY;AAAA,IAC7C;AAAA,EACF,WAAW,WAAW;AACpB,UAAM,KAAK,EAAE,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAAA,EAC9C;AAEA,MAAI,QAAQ;AACV,QAAI,MAAM,OAAQ,OAAM,KAAK,EAAE,MAAM,YAAY,CAAC;AAClD,UAAM;AAAA,MACJ,EAAE,OAAO,aAAa,QAAQ,gBAAgB,MAAM,OAAO,aAAa,MAAM,EAAG;AAAA,MACjF,EAAE,OAAO,qBAAqB,QAAQ,YAAY,MAAM,OAAO,aAAa,MAAM,EAAG;AAAA,IACvF;AAAA,EACF;AAEA,SAAO;AACT;AAcA,SAAS,eAAe,SAA+C;AACrE,SAAO,QAAQ,IAAI,CAAC,OAAO,MAAM;AAC/B,QAAI,UAAU,SAAS,MAAM,SAAS,aAAa;AACjD,aAAO,EAAE,IAAI,OAAO,CAAC,IAAI,MAAM,YAAqB;AAAA,IACtD;AAEA,UAAM,IAAI;AAEV,QAAI,OAAO,EAAE,WAAW,YAAY;AAClC,YAAM,OAAO,OAAO;AACpB,gBAAU,IAAI,MAAM,EAAE,MAAM;AAC5B,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,OAAO,EAAE;AAAA,QACT,aAAa;AAAA,QACb,UAAU,EAAE;AAAA,MACd;AAAA,IACF;AAEA,WAAO;AAAA,MACL,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC;AAAA,MACpB,OAAO,EAAE;AAAA,MACT,QAAQ,EAAE;AAAA,MACV,MAAO,EAAwB;AAAA,MAC/B,UAAU,EAAE;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAIO,SAAS,YAAY,MAAmB,OAAyB;AACtE,MAAI,eAAe;AAEnB,WAAS,YAAgC;AACvC,UAAM,SAAU,OAA8C,wBAAwB;AACtF,QAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,YAAM,IAAI,MAAM,gBAAgB,wBAAwB,cAAc;AAAA,IACxE;AACA,WAAO;AAAA,EACT;AAEA,WAAS,QAAQ,GAAe;AAC9B,MAAE,eAAe;AAEjB,QAAI;AAEJ,QAAI,MAAM,QAAQ,YAAY,GAAG;AAC/B,gBAAU;AAAA,IACZ,OAAO;AACL,YAAM,MAAM;AACZ,UAAI,WAA+B,CAAC;AAEpC,UAAI,IAAI,UAAU;AAChB,mBAAW,cAAc,CAAC;AAG1B,YAAI,IAAI,QAAQ;AACd,gBAAM,YAAY,IAAI,IAAI,IAAI,MAAM;AACpC,qBAAW,SAAS,OAAO,UAAQ;AACjC,gBAAI,UAAU,QAAQ,KAAK,SAAS,YAAa,QAAO;AACxD,kBAAM,YAAY,OAAQ,KAAa,WAAW,WAAY,KAAa,SAAS;AACpF,mBAAO,CAAC,UAAU,IAAI,SAAS;AAAA,UACjC,CAAC;AAAA,QACH;AAGA,YAAI,IAAI,WAAW;AACjB,qBAAW,SAAS,IAAI,CAAC,SAA2B;AAClD,gBAAI,UAAU,QAAQ,KAAK,SAAS,YAAa,QAAO;AACxD,kBAAM,QAAQ;AACd,kBAAM,WAAW,IAAI,UAAW,MAAM,MAAM;AAC5C,gBAAI,UAAU;AACZ,qBAAO;AAAA,gBACL,GAAG;AAAA,gBACH,GAAI,SAAS,UAAU,UAAa,EAAE,OAAO,SAAS,MAAM;AAAA,gBAC5D,GAAI,SAAS,aAAa,UAAa,EAAE,UAAU,SAAS,SAAS;AAAA,cACvE;AAAA,YACF;AACA,mBAAO;AAAA,UACT,CAAC;AAAA,QACH;AAAA,MACF;AAGA,UAAI,IAAI,SAAS,IAAI,MAAM,SAAS,GAAG;AACrC,YAAI,SAAS,SAAS,GAAG;AACvB,oBAAU,CAAC,GAAG,UAAU,EAAE,MAAM,YAAY,GAAG,GAAG,IAAI,KAAK;AAAA,QAC7D,OAAO;AACL,oBAAU,IAAI;AAAA,QAChB;AAAA,MACF,OAAO;AACL,kBAAU;AAAA,MACZ;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW,EAAG;AAE1B,UAAM,aAAa,eAAe,OAAO;AAEzC,cAAU,EAAE,cAAc,KAAK;AAAA,MAC7B,OAAO;AAAA,MACP,UAAU,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ;AAAA,IACzC,CAAC;AAAA,EACH;AAEA,OAAK,iBAAiB,eAAe,OAAO;AAE5C,SAAO;AAAA,IACL,OAAO,UAA4B;AACjC,qBAAe;AAAA,IACjB;AAAA,IACA,UAAU;AACR,WAAK,oBAAoB,eAAe,OAAO;AAAA,IACjD;AAAA,EACF;AACF;","names":[]}

package/dist/components/contextMenu.d.cts

@@ -0,0 +1,43 @@
+/** Individual menu entry. */
+type ContextMenuEntry = {
+    label: string;
+    action: string;
+    data?: string;
+    disabled?: boolean;
+} | {
+    label: string;
+    action: () => void;
+    disabled?: boolean;
+} | {
+    type: 'separator';
+};
+/** What the developer passes to `use:contextMenu`. */
+/** Overrides applied to default items by action key. */
+type ContextMenuOverride = {
+    label?: string;
+    disabled?: boolean;
+};
+type ContextMenuParam = ContextMenuEntry[] | {
+    defaults?: boolean;
+    remove?: string[];
+    overrides?: Record<string, ContextMenuOverride>;
+    items?: ContextMenuEntry[];
+};
+/** Resolved item shape passed to the `menu` snippet. */
+interface ResolvedMenuItem {
+    label: string;
+    disabled: boolean;
+    type?: 'separator';
+    execute: () => void;
+}
+/**
+ * Execute a stored callback by its ID and remove it from the map.
+ * Called from `ContextMenuProvider` when it receives `__contextMenu:callback`.
+ */
+declare function executeCallback(id: string): void;
+declare function contextMenu(node: HTMLElement, param: ContextMenuParam): {
+    update(newParam: ContextMenuParam): void;
+    destroy(): void;
+};
+
+export { type ContextMenuEntry, type ContextMenuOverride, type ContextMenuParam, type ResolvedMenuItem, contextMenu, executeCallback };

package/dist/components/contextMenu.d.ts

@@ -0,0 +1,43 @@
+/** Individual menu entry. */
+type ContextMenuEntry = {
+    label: string;
+    action: string;
+    data?: string;
+    disabled?: boolean;
+} | {
+    label: string;
+    action: () => void;
+    disabled?: boolean;
+} | {
+    type: 'separator';
+};
+/** What the developer passes to `use:contextMenu`. */
+/** Overrides applied to default items by action key. */
+type ContextMenuOverride = {
+    label?: string;
+    disabled?: boolean;
+};
+type ContextMenuParam = ContextMenuEntry[] | {
+    defaults?: boolean;
+    remove?: string[];
+    overrides?: Record<string, ContextMenuOverride>;
+    items?: ContextMenuEntry[];
+};
+/** Resolved item shape passed to the `menu` snippet. */
+interface ResolvedMenuItem {
+    label: string;
+    disabled: boolean;
+    type?: 'separator';
+    execute: () => void;
+}
+/**
+ * Execute a stored callback by its ID and remove it from the map.
+ * Called from `ContextMenuProvider` when it receives `__contextMenu:callback`.
+ */
+declare function executeCallback(id: string): void;
+declare function contextMenu(node: HTMLElement, param: ContextMenuParam): {
+    update(newParam: ContextMenuParam): void;
+    destroy(): void;
+};
+
+export { type ContextMenuEntry, type ContextMenuOverride, type ContextMenuParam, type ResolvedMenuItem, contextMenu, executeCallback };

package/dist/components/contextMenu.js

@@ -0,0 +1,138 @@
+const WOOD_INTERNAL_BRIDGE_KEY = "__NOEGO_WOOD_BRIDGE__";
+const callbacks = /* @__PURE__ */ new Map();
+let idCounter = 0;
+function nextId() {
+  return `__cb_${++idCounter}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function executeCallback(id) {
+  const fn = callbacks.get(id);
+  if (fn) {
+    callbacks.delete(id);
+    fn();
+  }
+}
+function buildDefaults(e) {
+  const target = e.target;
+  const selection = document.getSelection()?.toString();
+  const isEditable = target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target.isContentEditable;
+  const linkEl = target.closest("a[href]");
+  const items = [];
+  if (isEditable) {
+    items.push(
+      { label: "Cut", action: "cut" },
+      { label: "Copy", action: "copy" },
+      { label: "Paste", action: "paste" },
+      { label: "Select All", action: "selectAll" }
+    );
+  } else if (selection) {
+    items.push({ label: "Copy", action: "copy" });
+  }
+  if (linkEl) {
+    if (items.length) items.push({ type: "separator" });
+    items.push(
+      { label: "Open Link", action: "openExternal", data: linkEl.getAttribute("href") },
+      { label: "Copy Link Address", action: "copyText", data: linkEl.getAttribute("href") }
+    );
+  }
+  return items;
+}
+function serializeItems(entries) {
+  return entries.map((entry, i) => {
+    if ("type" in entry && entry.type === "separator") {
+      return { id: `sep_${i}`, type: "separator" };
+    }
+    const e = entry;
+    if (typeof e.action === "function") {
+      const cbId = nextId();
+      callbacks.set(cbId, e.action);
+      return {
+        id: cbId,
+        label: e.label,
+        _callbackId: cbId,
+        disabled: e.disabled
+      };
+    }
+    return {
+      id: `${e.action}_${i}`,
+      label: e.label,
+      action: e.action,
+      data: e.data,
+      disabled: e.disabled
+    };
+  });
+}
+function contextMenu(node, param) {
+  let currentParam = param;
+  function getBridge() {
+    const bridge = window[WOOD_INTERNAL_BRIDGE_KEY];
+    if (!bridge || typeof bridge !== "object") {
+      throw new Error(`Wood bridge "${WOOD_INTERNAL_BRIDGE_KEY}" not found.`);
+    }
+    return bridge;
+  }
+  function handler(e) {
+    e.preventDefault();
+    let entries;
+    if (Array.isArray(currentParam)) {
+      entries = currentParam;
+    } else {
+      const cfg = currentParam;
+      let defaults = [];
+      if (cfg.defaults) {
+        defaults = buildDefaults(e);
+        if (cfg.remove) {
+          const removeSet = new Set(cfg.remove);
+          defaults = defaults.filter((item) => {
+            if ("type" in item && item.type === "separator") return true;
+            const actionKey = typeof item.action === "string" ? item.action : "";
+            return !removeSet.has(actionKey);
+          });
+        }
+        if (cfg.overrides) {
+          defaults = defaults.map((item) => {
+            if ("type" in item && item.type === "separator") return item;
+            const entry = item;
+            const override = cfg.overrides[entry.action];
+            if (override) {
+              return {
+                ...entry,
+                ...override.label !== void 0 && { label: override.label },
+                ...override.disabled !== void 0 && { disabled: override.disabled }
+              };
+            }
+            return item;
+          });
+        }
+      }
+      if (cfg.items && cfg.items.length > 0) {
+        if (defaults.length > 0) {
+          entries = [...defaults, { type: "separator" }, ...cfg.items];
+        } else {
+          entries = cfg.items;
+        }
+      } else {
+        entries = defaults;
+      }
+    }
+    if (entries.length === 0) return;
+    const serialized = serializeItems(entries);
+    getBridge().__contextMenu.show({
+      items: serialized,
+      position: { x: e.clientX, y: e.clientY }
+    });
+  }
+  node.addEventListener("contextmenu", handler);
+  return {
+    update(newParam) {
+      currentParam = newParam;
+    },
+    destroy() {
+      node.removeEventListener("contextmenu", handler);
+    }
+  };
+}
+export {
+  contextMenu,
+  executeCallback
+};
+//# sourceMappingURL=contextMenu.js.map

package/dist/components/contextMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/contextMenu.ts"],"sourcesContent":["/**\n * Svelte action + types for the `use:contextMenu` directive.\n *\n * Prevents the native contextmenu event, builds smart defaults when\n * `defaults: true`, serializes items (storing callbacks in a module-level\n * map), and calls the internal Wood bridge `__contextMenu.show()`.\n */\nconst WOOD_INTERNAL_BRIDGE_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype InternalWoodBridge = {\n  __contextMenu: {\n    show(data: { items: unknown[]; position: { x: number; y: number } }): Promise<void>;\n  };\n};\n\n// ── Types ────────────────────────────────────────────────────────────\n\n/** Individual menu entry. */\nexport type ContextMenuEntry =\n  | { label: string; action: string; data?: string; disabled?: boolean }\n  | { label: string; action: () => void; disabled?: boolean }\n  | { type: 'separator' };\n\n/** What the developer passes to `use:contextMenu`. */\n/** Overrides applied to default items by action key. */\nexport type ContextMenuOverride = { label?: string; disabled?: boolean };\n\nexport type ContextMenuParam =\n  | ContextMenuEntry[]\n  | {\n      defaults?: boolean;\n      remove?: string[];\n      overrides?: Record<string, ContextMenuOverride>;\n      items?: ContextMenuEntry[];\n    };\n\n/** Resolved item shape passed to the `menu` snippet. */\nexport interface ResolvedMenuItem {\n  label: string;\n  disabled: boolean;\n  type?: 'separator';\n  execute: () => void;\n}\n\n// ── Callback map ─────────────────────────────────────────────────────\n\nconst callbacks = new Map<string, () => void>();\nlet idCounter = 0;\n\nfunction nextId(): string {\n  return `__cb_${++idCounter}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Execute a stored callback by its ID and remove it from the map.\n * Called from `ContextMenuProvider` when it receives `__contextMenu:callback`.\n */\nexport function executeCallback(id: string): void {\n  const fn = callbacks.get(id);\n  if (fn) {\n    callbacks.delete(id);\n    fn();\n  }\n}\n\n// ── Smart defaults ───────────────────────────────────────────────────\n\nfunction buildDefaults(e: MouseEvent): ContextMenuEntry[] {\n  const target = e.target as HTMLElement;\n  const selection = document.getSelection()?.toString();\n  const isEditable =\n    target instanceof HTMLInputElement ||\n    target instanceof HTMLTextAreaElement ||\n    target.isContentEditable;\n  const linkEl = target.closest('a[href]') as HTMLAnchorElement | null;\n  const items: ContextMenuEntry[] = [];\n\n  if (isEditable) {\n    items.push(\n      { label: 'Cut', action: 'cut' },\n      { label: 'Copy', action: 'copy' },\n      { label: 'Paste', action: 'paste' },\n      { label: 'Select All', action: 'selectAll' },\n    );\n  } else if (selection) {\n    items.push({ label: 'Copy', action: 'copy' });\n  }\n\n  if (linkEl) {\n    if (items.length) items.push({ type: 'separator' });\n    items.push(\n      { label: 'Open Link', action: 'openExternal', data: linkEl.getAttribute('href')! },\n      { label: 'Copy Link Address', action: 'copyText', data: linkEl.getAttribute('href')! },\n    );\n  }\n\n  return items;\n}\n\n// ── Serialization ────────────────────────────────────────────────────\n\ninterface SerializedItem {\n  id: string;\n  label?: string;\n  action?: string;\n  data?: string;\n  _callbackId?: string;\n  disabled?: boolean;\n  type?: 'separator';\n}\n\nfunction serializeItems(entries: ContextMenuEntry[]): SerializedItem[] {\n  return entries.map((entry, i) => {\n    if ('type' in entry && entry.type === 'separator') {\n      return { id: `sep_${i}`, type: 'separator' as const };\n    }\n\n    const e = entry as Exclude<ContextMenuEntry, { type: 'separator' }>;\n\n    if (typeof e.action === 'function') {\n      const cbId = nextId();\n      callbacks.set(cbId, e.action);\n      return {\n        id: cbId,\n        label: e.label,\n        _callbackId: cbId,\n        disabled: e.disabled,\n      };\n    }\n\n    return {\n      id: `${e.action}_${i}`,\n      label: e.label,\n      action: e.action,\n      data: (e as { data?: string }).data,\n      disabled: e.disabled,\n    };\n  });\n}\n\n// ── Svelte action ────────────────────────────────────────────────────\n\nexport function contextMenu(node: HTMLElement, param: ContextMenuParam) {\n  let currentParam = param;\n\n  function getBridge(): InternalWoodBridge {\n    const bridge = (window as unknown as Record<string, unknown>)[WOOD_INTERNAL_BRIDGE_KEY];\n    if (!bridge || typeof bridge !== 'object') {\n      throw new Error(`Wood bridge \"${WOOD_INTERNAL_BRIDGE_KEY}\" not found.`);\n    }\n    return bridge as InternalWoodBridge;\n  }\n\n  function handler(e: MouseEvent) {\n    e.preventDefault();\n\n    let entries: ContextMenuEntry[];\n\n    if (Array.isArray(currentParam)) {\n      entries = currentParam;\n    } else {\n      const cfg = currentParam;\n      let defaults: ContextMenuEntry[] = [];\n\n      if (cfg.defaults) {\n        defaults = buildDefaults(e);\n\n        // Apply remove\n        if (cfg.remove) {\n          const removeSet = new Set(cfg.remove);\n          defaults = defaults.filter(item => {\n            if ('type' in item && item.type === 'separator') return true;\n            const actionKey = typeof (item as any).action === 'string' ? (item as any).action : '';\n            return !removeSet.has(actionKey);\n          });\n        }\n\n        // Apply overrides\n        if (cfg.overrides) {\n          defaults = defaults.map((item): ContextMenuEntry => {\n            if ('type' in item && item.type === 'separator') return item;\n            const entry = item as { label: string; action: string; data?: string; disabled?: boolean };\n            const override = cfg.overrides![entry.action];\n            if (override) {\n              return {\n                ...entry,\n                ...(override.label !== undefined && { label: override.label }),\n                ...(override.disabled !== undefined && { disabled: override.disabled }),\n              };\n            }\n            return item;\n          });\n        }\n      }\n\n      // Append custom items (with separator if both exist)\n      if (cfg.items && cfg.items.length > 0) {\n        if (defaults.length > 0) {\n          entries = [...defaults, { type: 'separator' }, ...cfg.items];\n        } else {\n          entries = cfg.items;\n        }\n      } else {\n        entries = defaults;\n      }\n    }\n\n    if (entries.length === 0) return;\n\n    const serialized = serializeItems(entries);\n\n    getBridge().__contextMenu.show({\n      items: serialized,\n      position: { x: e.clientX, y: e.clientY },\n    });\n  }\n\n  node.addEventListener('contextmenu', handler);\n\n  return {\n    update(newParam: ContextMenuParam) {\n      currentParam = newParam;\n    },\n    destroy() {\n      node.removeEventListener('contextmenu', handler);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/config/config_parser.cjs

@@ -0,0 +1,176 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var config_parser_exports = {};
+__export(config_parser_exports, {
+  parseConfig: () => parseConfig
+});
+module.exports = __toCommonJS(config_parser_exports);
+var import_js_yaml = __toESM(require("js-yaml"), 1);
+var import_fs = require("fs");
+var import_path = __toESM(require("path"), 1);
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:config");
+const WINDOW_DEFAULTS = {
+  frame: true,
+  resizable: true,
+  show: true,
+  modal: false
+};
+const DEV_DEFAULTS = {
+  watch: true,
+  splitServe: true,
+  port: 5173
+};
+function parseConfig(configPath) {
+  const resolved = import_path.default.resolve(configPath);
+  if (!(0, import_fs.existsSync)(resolved)) {
+    throw new Error(`Config file not found: ${resolved}`);
+  }
+  const raw = (0, import_fs.readFileSync)(resolved, "utf-8");
+  const doc = import_js_yaml.default.load(raw);
+  if (!doc || typeof doc !== "object") {
+    throw new Error(`Invalid YAML in config file: ${resolved}`);
+  }
+  validateRequired(doc);
+  const config = applyDefaults(doc);
+  logger.info("Parsed config", { path: resolved, windows: Object.keys(config.windows) });
+  return config;
+}
+function validateRequired(doc) {
+  requireString(doc, "app.boot", doc.app?.boot);
+  requireString(doc, "main.entry", doc.main?.entry);
+  requireString(doc, "main.controllers", doc.main?.controllers);
+  requireString(doc, "main.middleware", doc.main?.middleware);
+  requireString(doc, "main.openapi", doc.main?.openapi);
+  requireString(doc, "renderer.openapi", doc.renderer?.openapi);
+  requireString(doc, "renderer.componentDir", doc.renderer?.componentDir);
+  requireString(doc, "renderer.controllers", doc.renderer?.controllers);
+  const rendererEntry = doc.renderer?.entry;
+  if (rendererEntry !== void 0) {
+    requireString(doc, "renderer.entry", rendererEntry);
+  }
+  const windows = doc.windows;
+  if (!windows || typeof windows !== "object") {
+    throw new Error('Config validation error: "windows" is required and must be an object with at least one window');
+  }
+  const windowKeys = Object.keys(windows);
+  if (windowKeys.length === 0) {
+    throw new Error('Config validation error: "windows" must contain at least one window definition');
+  }
+  for (const key of windowKeys) {
+    const win = windows[key];
+    if (!win || typeof win !== "object") {
+      throw new Error(`Config validation error: window "${key}" must be an object`);
+    }
+    requireString(doc, `windows.${key}.title`, win.title);
+    requireNumber(doc, `windows.${key}.width`, win.width);
+    requireNumber(doc, `windows.${key}.height`, win.height);
+    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);
+    if (win.contextMenu !== void 0) {
+      if (typeof win.contextMenu !== "string") {
+        throw new Error(`Config validation error: "windows.${key}.contextMenu" must be a string`);
+      }
+      if (win.contextMenu !== "native" && win.contextMenu !== "custom") {
+        throw new Error(`Config validation error: "windows.${key}.contextMenu" must be "native" or "custom"`);
+      }
+    }
+  }
+}
+function requireString(_doc, field, value) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`Config validation error: "${field}" is required and must be a non-empty string`);
+  }
+}
+function requireNumber(_doc, field, value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`Config validation error: "${field}" is required and must be a number`);
+  }
+}
+function applyDefaults(doc) {
+  const app = doc.app;
+  const main = doc.main;
+  const renderer = doc.renderer;
+  const rawWindows = doc.windows;
+  const windows = {};
+  for (const [key, rawWin] of Object.entries(rawWindows)) {
+    windows[key] = {
+      ...WINDOW_DEFAULTS,
+      ...rawWin
+    };
+  }
+  const dev = {
+    ...DEV_DEFAULTS,
+    ...doc.dev
+  };
+  const config = {
+    root: typeof doc.root === "string" ? doc.root : ".",
+    outDir: typeof doc.outDir === "string" ? doc.outDir : "dist",
+    app: {
+      boot: app.boot,
+      watch: Array.isArray(app.watch) ? app.watch : []
+    },
+    main: {
+      entry: main.entry,
+      controllers: main.controllers,
+      middleware: main.middleware,
+      openapi: main.openapi,
+      watch: Array.isArray(main.watch) ? main.watch : []
+    },
+    renderer: {
+      openapi: renderer.openapi,
+      componentDir: renderer.componentDir,
+      controllers: renderer.controllers,
+      ...typeof renderer.entry === "string" ? { entry: renderer.entry } : {},
+      ...Array.isArray(renderer.watch) ? { watch: renderer.watch } : {}
+    },
+    windows,
+    dev
+  };
+  if (doc.database && typeof doc.database === "object") {
+    const db = doc.database;
+    if (typeof db.path === "string") {
+      config.database = {
+        path: db.path,
+        ...typeof db.migrations === "string" ? { migrations: db.migrations } : {}
+      };
+    }
+  }
+  if (Array.isArray(doc.assets)) {
+    config.assets = doc.assets;
+  }
+  if (doc.build && typeof doc.build === "object") {
+    config.build = doc.build;
+  }
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parseConfig
+});
+//# sourceMappingURL=config_parser.cjs.map

package/dist/config/config_parser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/config_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type { WoodConfig, WindowDef, DevConfig } from '../types/config.cjs';\n\nconst logger = getLogger('wood:config');\n\n/** Default values applied when optional fields are omitted. */\nconst WINDOW_DEFAULTS: Partial<WindowDef> = {\n  frame: true,\n  resizable: true,\n  show: true,\n  modal: false,\n};\n\nconst DEV_DEFAULTS: DevConfig = {\n  watch: true,\n  splitServe: true,\n  port: 5173,\n};\n\n/**\n * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig\n * with defaults applied for optional fields.\n */\nexport function parseConfig(configPath: string): WoodConfig {\n  const resolved = path.resolve(configPath);\n\n  if (!existsSync(resolved)) {\n    throw new Error(`Config file not found: ${resolved}`);\n  }\n\n  const raw = readFileSync(resolved, 'utf-8');\n  const doc = yaml.load(raw) as Record<string, unknown> | null;\n\n  if (!doc || typeof doc !== 'object') {\n    throw new Error(`Invalid YAML in config file: ${resolved}`);\n  }\n\n  validateRequired(doc);\n\n  const config = applyDefaults(doc as RawConfig);\n\n  logger.info('Parsed config', { path: resolved, windows: Object.keys(config.windows) });\n\n  return config;\n}\n\n/** Shape of the raw YAML before defaults are applied. */\ntype RawConfig = Record<string, unknown>;\n\nfunction validateRequired(doc: Record<string, unknown>): void {\n  requireString(doc, 'app.boot', (doc as Record<string, Record<string, unknown>>).app?.boot);\n  requireString(doc, 'main.entry', (doc as Record<string, Record<string, unknown>>).main?.entry);\n  requireString(doc, 'main.controllers', (doc as Record<string, Record<string, unknown>>).main?.controllers);\n  requireString(doc, 'main.middleware', (doc as Record<string, Record<string, unknown>>).main?.middleware);\n  requireString(doc, 'main.openapi', (doc as Record<string, Record<string, unknown>>).main?.openapi);\n  requireString(doc, 'renderer.openapi', (doc as Record<string, Record<string, unknown>>).renderer?.openapi);\n  requireString(doc, 'renderer.componentDir', (doc as Record<string, Record<string, unknown>>).renderer?.componentDir);\n  requireString(doc, 'renderer.controllers', (doc as Record<string, Record<string, unknown>>).renderer?.controllers);\n  const rendererEntry = (doc as Record<string, Record<string, unknown>>).renderer?.entry;\n  if (rendererEntry !== undefined) {\n    requireString(doc, 'renderer.entry', rendererEntry);\n  }\n\n  // Windows validation\n  const windows = doc.windows;\n  if (!windows || typeof windows !== 'object') {\n    throw new Error('Config validation error: \"windows\" is required and must be an object with at least one window');\n  }\n\n  const windowKeys = Object.keys(windows as Record<string, unknown>);\n  if (windowKeys.length === 0) {\n    throw new Error('Config validation error: \"windows\" must contain at least one window definition');\n  }\n\n  for (const key of windowKeys) {\n    const win = (windows as Record<string, Record<string, unknown>>)[key];\n    if (!win || typeof win !== 'object') {\n      throw new Error(`Config validation error: window \"${key}\" must be an object`);\n    }\n    requireString(doc, `windows.${key}.title`, win.title);\n    requireNumber(doc, `windows.${key}.width`, win.width);\n    requireNumber(doc, `windows.${key}.height`, win.height);\n    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);\n\n    if (win.contextMenu !== undefined) {\n      if (typeof win.contextMenu !== 'string') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be a string`);\n      }\n      if (win.contextMenu !== 'native' && win.contextMenu !== 'custom') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be \"native\" or \"custom\"`);\n      }\n    }\n  }\n}\n\nfunction requireString(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a non-empty string`);\n  }\n}\n\nfunction requireNumber(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a number`);\n  }\n}\n\nfunction applyDefaults(doc: RawConfig): WoodConfig {\n  const app = doc.app as Record<string, unknown>;\n  const main = doc.main as Record<string, unknown>;\n  const renderer = doc.renderer as Record<string, unknown>;\n  const rawWindows = doc.windows as Record<string, Record<string, unknown>>;\n\n  const windows: Record<string, WindowDef> = {};\n  for (const [key, rawWin] of Object.entries(rawWindows)) {\n    windows[key] = {\n      ...WINDOW_DEFAULTS,\n      ...rawWin,\n    } as WindowDef;\n  }\n\n  const dev: DevConfig = {\n    ...DEV_DEFAULTS,\n    ...(doc.dev as Record<string, unknown> | undefined),\n  };\n\n  const config: WoodConfig = {\n    root: typeof doc.root === 'string' ? doc.root : '.',\n    outDir: typeof doc.outDir === 'string' ? doc.outDir : 'dist',\n    app: {\n      boot: app.boot as string,\n      watch: Array.isArray(app.watch) ? (app.watch as string[]) : [],\n    },\n    main: {\n      entry: main.entry as string,\n      controllers: main.controllers as string,\n      middleware: main.middleware as string,\n      openapi: main.openapi as string,\n      watch: Array.isArray(main.watch) ? (main.watch as string[]) : [],\n    },\n    renderer: {\n      openapi: renderer.openapi as string,\n      componentDir: renderer.componentDir as string,\n      controllers: renderer.controllers as string,\n      ...(typeof renderer.entry === 'string' ? { entry: renderer.entry as string } : {}),\n      ...(Array.isArray(renderer.watch) ? { watch: renderer.watch as string[] } : {}),\n    },\n    windows,\n    dev,\n  };\n\n  // Optional database section (preserve :userData: token for runtime expansion)\n  if (doc.database && typeof doc.database === 'object') {\n    const db = doc.database as Record<string, unknown>;\n    if (typeof db.path === 'string') {\n      config.database = {\n        path: db.path,\n        ...(typeof db.migrations === 'string' ? { migrations: db.migrations } : {}),\n      };\n    }\n  }\n\n  // Optional assets\n  if (Array.isArray(doc.assets)) {\n    config.assets = doc.assets as string[];\n  }\n\n  // Optional build section\n  if (doc.build && typeof doc.build === 'object') {\n    config.build = doc.build as WoodConfig['build'];\n  }\n\n  return config;\n}\n"],"mappings":"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","names":["path","yaml"]}

package/dist/config/config_parser.d.cts

@@ -0,0 +1,9 @@
+import { WoodConfig } from '../types/config.cjs';
+
+/**
+ * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig
+ * with defaults applied for optional fields.
+ */
+declare function parseConfig(configPath: string): WoodConfig;
+
+export { parseConfig };

package/dist/config/config_parser.d.ts

@@ -0,0 +1,9 @@
+import { WoodConfig } from '../types/config.js';
+
+/**
+ * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig
+ * with defaults applied for optional fields.
+ */
+declare function parseConfig(configPath: string): WoodConfig;
+
+export { parseConfig };