@opentray/ext-badge 0.0.0 → 0.1.0

package/README.md

@@ -1,9 +1,17 @@
 # @opentray/ext-badge
 
-Official platform status extension for OpenTray.
+Official status extension for OpenTray.
 
 ## Role
 
-- Expose badge counts, progress bars, overlay icons, and attention status where platforms support them.
-- Degrade through capability detection instead of cross-platform fake behavior.
-- Keep native platform APIs behind extension contracts.
+- Expose badge counts, progress bars, overlay icons, and attention state.
+- Keep badge truth capability-gated and honest.
+- Route badge commands through the normal tray extension ABI.
+
+Windows and Linux support is intentionally reduced until a real native projection exists. Unsupported families reject explicitly.
+On the current macOS Dock proof surface, progress and progress state are explicitly unsupported and should not be treated as a working Dock projection.
+
+## Debug Panel
+
+The repository ships a macOS-facing proof surface at `pnpm --filter opentray example:badge`.
+That panel uses `@opentray/ext-webview` IPC to drive the real badge contract and show capability state.

package/dist/index.d.mts

@@ -0,0 +1,141 @@
+import { TrayHandle } from "opentray";
+
+//#region ../spec/src/index.d.ts
+type SpaceId = string;
+type TrayId = string;
+interface ExtensionScope {
+  spaceId: SpaceId;
+  trayId?: TrayId;
+  ext: string;
+}
+interface ExtensionEnvelope<TData = unknown> {
+  scope: ExtensionScope;
+  data: TData;
+}
+//#endregion
+//#region src/shared.d.ts
+type BadgeCapabilityLevel = "native" | "reduced" | "unsupported";
+type BadgePlatform = "darwin" | "win32" | "linux";
+interface BadgeState {
+  badgeText: string;
+  badgeCount: number | null;
+  progressValue: number;
+  progressMax: number;
+  progressState: "none" | "indeterminate" | "normal" | "paused" | "error";
+  overlayIcon: "none" | "dot" | "alert";
+  attention: boolean;
+}
+interface BadgeCapabilityFamily {
+  badgeText: BadgeCapabilityLevel;
+  progress: BadgeCapabilityLevel;
+  overlayIcon: BadgeCapabilityLevel;
+  attention: BadgeCapabilityLevel;
+}
+interface BadgeCapabilities {
+  platform: BadgePlatform;
+  mode: "native" | "reduced" | "unsupported";
+  capabilities: BadgeCapabilityFamily;
+  state: BadgeState;
+  reason?: string;
+}
+type BadgeCommand = {
+  type: "getCapabilities";
+} | {
+  type: "setBadge";
+  value: string;
+} | {
+  type: "clearBadge";
+} | {
+  type: "setProgress";
+  value: number;
+  max?: number;
+} | {
+  type: "setProgressState";
+  value: BadgeState["progressState"];
+} | {
+  type: "setOverlayIcon";
+  value: BadgeState["overlayIcon"];
+} | {
+  type: "setAttention";
+  value: boolean;
+} | {
+  type: "showPanel";
+} | {
+  type: "hidePanel";
+} | {
+  type: "reset";
+};
+type BadgeEvent = {
+  type: "capabilities";
+  snapshot: BadgeCapabilities;
+} | {
+  type: "state";
+  snapshot: BadgeCapabilities;
+} | {
+  type: "result";
+  op: string;
+  ok: true;
+  snapshot: BadgeCapabilities;
+} | {
+  type: "result";
+  op: string;
+  ok: false;
+  error: string;
+  snapshot: BadgeCapabilities;
+};
+interface BadgeHandle {
+  getCapabilities(): Promise<BadgeCapabilities>;
+  setBadge(value: string): Promise<BadgeCapabilities>;
+  clearBadge(): Promise<BadgeCapabilities>;
+  setProgress(value: number, max?: number): Promise<BadgeCapabilities>;
+  setProgressState(value: BadgeState["progressState"]): Promise<BadgeCapabilities>;
+  setOverlayIcon(value: BadgeState["overlayIcon"]): Promise<BadgeCapabilities>;
+  setAttention(value: boolean): Promise<BadgeCapabilities>;
+  showPanel(): Promise<BadgeCapabilities>;
+  hidePanel(): Promise<BadgeCapabilities>;
+  reset(): Promise<BadgeCapabilities>;
+}
+interface BadgePanelEnvelope {
+  platform: BadgePlatform;
+  mode: "native" | "reduced" | "unsupported";
+  capabilities: BadgeCapabilityFamily;
+  state: BadgeState;
+  log: string[];
+  reason?: string;
+}
+declare const defaultBadgeState: () => BadgeState;
+declare const defaultBadgeCapabilities: (platform: BadgePlatform) => BadgeCapabilities;
+declare const normalizeProgress: (value: number, max?: number) => {
+  value: number;
+  max: number;
+};
+declare const normalizeBadgeText: (value: string) => {
+  badgeText: string;
+  badgeCount: number | null;
+};
+declare const badgePanelEnvelopeFromCapabilities: (snapshot: BadgeCapabilities) => BadgePanelEnvelope;
+//#endregion
+//#region src/index.d.ts
+interface BadgeExtensionOptions {
+  mountId?: string;
+  path?: string;
+  platform?: BadgePlatform;
+}
+interface BadgeExtensionCapability extends BadgeHandle {
+  readonly platform: BadgePlatform;
+  readonly getPanelEnvelope: () => Promise<BadgePanelEnvelope>;
+}
+declare const attachBadge: (tray: TrayHandle, options?: BadgeExtensionOptions) => BadgeExtensionCapability;
+declare const BadgeExt: {
+  name: string;
+  path: string;
+  resolveMount(options: BadgeExtensionOptions | undefined): {
+    path?: string;
+    mountId?: string;
+  };
+  extend(tray: TrayHandle, context: import("opentray").TrayExtensionContext, options: BadgeExtensionOptions | undefined): BadgeHandle;
+};
+declare const isBadgeEvent: (event: ExtensionEnvelope) => event is ExtensionEnvelope<BadgeEvent>;
+//#endregion
+export { type BadgeCapabilities, type BadgeCapabilityFamily, type BadgeCapabilityLevel, type BadgeCommand, type BadgeEvent, BadgeExt, BadgeExtensionCapability, BadgeExtensionOptions, type BadgeHandle, type BadgePanelEnvelope, type BadgePlatform, type BadgeState, attachBadge, badgePanelEnvelopeFromCapabilities, type defaultBadgeCapabilities, type defaultBadgeState, isBadgeEvent, type normalizeBadgeText, type normalizeProgress };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../spec/src/index.ts","../src/shared.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,179 @@
+//#region src/shared.ts
+const defaultBadgeState = () => ({
+	badgeText: "12",
+	badgeCount: 12,
+	progressValue: 0,
+	progressMax: 100,
+	progressState: "none",
+	overlayIcon: "dot",
+	attention: false
+});
+const defaultBadgeCapabilities = (platform) => {
+	return {
+		platform,
+		mode: "reduced",
+		capabilities: {
+			badgeText: "reduced",
+			progress: "unsupported",
+			overlayIcon: "reduced",
+			attention: "reduced"
+		},
+		state: defaultBadgeState(),
+		reason: "badge projection is currently reduced to a local proof surface"
+	};
+};
+const normalizeProgress = (value, max) => {
+	const normalizedMax = Number.isFinite(max ?? 100) ? Math.max(1, Math.round(max ?? 100)) : 100;
+	return {
+		value: Number.isFinite(value) ? Math.max(0, Math.min(normalizedMax, Math.round(value))) : 0,
+		max: normalizedMax
+	};
+};
+const normalizeBadgeText = (value) => {
+	const badgeText = value.trim();
+	const parsed = Number.parseInt(badgeText, 10);
+	return {
+		badgeText,
+		badgeCount: Number.isFinite(parsed) ? parsed : null
+	};
+};
+const badgePanelEnvelopeFromCapabilities = (snapshot) => ({
+	platform: snapshot.platform,
+	mode: snapshot.mode,
+	capabilities: snapshot.capabilities,
+	state: snapshot.state,
+	log: [],
+	...snapshot.reason === void 0 ? {} : { reason: snapshot.reason }
+});
+//#endregion
+//#region src/index.ts
+const BADGE_EXTENSION_NAME = "badge";
+const BADGE_EXTENSION_PACKAGE = "@opentray/ext-badge";
+const attachBadge = (tray, options = {}) => {
+	const platform = options.platform ?? process.platform;
+	const extension = tray.extend(BadgeExt, options);
+	return {
+		...extension,
+		platform,
+		getPanelEnvelope: async () => badgePanelEnvelopeFromCapabilities(await extension.getCapabilities())
+	};
+};
+const BadgeExt = {
+	name: BADGE_EXTENSION_NAME,
+	path: BADGE_EXTENSION_PACKAGE,
+	resolveMount(options) {
+		return {
+			...options?.mountId === void 0 ? {} : { mountId: options.mountId },
+			...options?.path === void 0 ? {} : { path: options.path }
+		};
+	},
+	extend(tray, context, options) {
+		const snapshot = defaultBadgeCapabilities(options?.platform ?? process.platform);
+		return createBadgeHandle(() => context.ensureLoaded(), tray, context.mountId, snapshot);
+	}
+};
+const isBadgeEvent = (event) => event.scope.ext === BADGE_EXTENSION_NAME && typeof event.data === "object" && event.data !== null && "type" in event.data;
+function createBadgeHandle(ensureLoaded, tray, mountId, seed) {
+	const state = structuredClone(seed.state);
+	const capabilities = { ...seed.capabilities };
+	const platform = seed.platform;
+	const mode = seed.mode;
+	const reason = seed.reason;
+	const snapshot = () => ({
+		platform,
+		mode,
+		capabilities: { ...capabilities },
+		state: structuredClone(state),
+		...reason === void 0 ? {} : { reason }
+	});
+	const rejectUnsupported = (family, op) => {
+		const support = capabilities[family];
+		throw new Error(`${op} is ${support} on ${platform}`);
+	};
+	return {
+		getCapabilities: async () => {
+			await ensureLoaded();
+			await tray.requestExtension(mountId, { type: "getCapabilities" });
+			return snapshot();
+		},
+		setBadge: async (value) => {
+			await ensureLoaded();
+			const normalized = normalizeBadgeText(value);
+			state.badgeText = normalized.badgeText;
+			state.badgeCount = normalized.badgeCount;
+			await tray.commandExtension(mountId, {
+				type: "setBadge",
+				value: normalized.badgeText
+			});
+			return snapshot();
+		},
+		clearBadge: async () => {
+			await ensureLoaded();
+			state.badgeText = "";
+			state.badgeCount = null;
+			await tray.commandExtension(mountId, { type: "clearBadge" });
+			return snapshot();
+		},
+		setProgress: async (value, max) => {
+			await ensureLoaded();
+			if (capabilities.progress === "unsupported") rejectUnsupported("progress", "setProgress");
+			const normalized = normalizeProgress(value, max);
+			state.progressValue = normalized.value;
+			state.progressMax = normalized.max;
+			await tray.commandExtension(mountId, {
+				type: "setProgress",
+				value: normalized.value,
+				max: normalized.max
+			});
+			return snapshot();
+		},
+		setProgressState: async (value) => {
+			await ensureLoaded();
+			if (capabilities.progress === "unsupported") rejectUnsupported("progress", "setProgressState");
+			state.progressState = value;
+			await tray.commandExtension(mountId, {
+				type: "setProgressState",
+				value
+			});
+			return snapshot();
+		},
+		setOverlayIcon: async (value) => {
+			await ensureLoaded();
+			state.overlayIcon = value;
+			await tray.commandExtension(mountId, {
+				type: "setOverlayIcon",
+				value
+			});
+			return snapshot();
+		},
+		setAttention: async (value) => {
+			await ensureLoaded();
+			state.attention = Boolean(value);
+			await tray.commandExtension(mountId, {
+				type: "setAttention",
+				value: Boolean(value)
+			});
+			return snapshot();
+		},
+		showPanel: async () => {
+			await ensureLoaded();
+			await tray.commandExtension(mountId, { type: "showPanel" });
+			return snapshot();
+		},
+		hidePanel: async () => {
+			await ensureLoaded();
+			await tray.commandExtension(mountId, { type: "hidePanel" });
+			return snapshot();
+		},
+		reset: async () => {
+			await ensureLoaded();
+			Object.assign(state, seed.state);
+			await tray.commandExtension(mountId, { type: "reset" });
+			return snapshot();
+		}
+	};
+}
+//#endregion
+export { BadgeExt, attachBadge, badgePanelEnvelopeFromCapabilities, isBadgeEvent };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/shared.ts","../src/index.ts"],"sourcesContent":["export type BadgeCapabilityLevel = \"native\" | \"reduced\" | \"unsupported\";\n\nexport type BadgePlatform = \"darwin\" | \"win32\" | \"linux\";\n\nexport interface BadgeState {\n  badgeText: string;\n  badgeCount: number | null;\n  progressValue: number;\n  progressMax: number;\n  progressState: \"none\" | \"indeterminate\" | \"normal\" | \"paused\" | \"error\";\n  overlayIcon: \"none\" | \"dot\" | \"alert\";\n  attention: boolean;\n}\n\nexport interface BadgeCapabilityFamily {\n  badgeText: BadgeCapabilityLevel;\n  progress: BadgeCapabilityLevel;\n  overlayIcon: BadgeCapabilityLevel;\n  attention: BadgeCapabilityLevel;\n}\n\nexport interface BadgeCapabilities {\n  platform: BadgePlatform;\n  mode: \"native\" | \"reduced\" | \"unsupported\";\n  capabilities: BadgeCapabilityFamily;\n  state: BadgeState;\n  reason?: string;\n}\n\nexport type BadgeCommand =\n  | { type: \"getCapabilities\" }\n  | { type: \"setBadge\"; value: string }\n  | { type: \"clearBadge\" }\n  | { type: \"setProgress\"; value: number; max?: number }\n  | { type: \"setProgressState\"; value: BadgeState[\"progressState\"] }\n  | { type: \"setOverlayIcon\"; value: BadgeState[\"overlayIcon\"] }\n  | { type: \"setAttention\"; value: boolean }\n  | { type: \"showPanel\" }\n  | { type: \"hidePanel\" }\n  | { type: \"reset\" }\n  ;\n\nexport type BadgeEvent =\n  | { type: \"capabilities\"; snapshot: BadgeCapabilities }\n  | { type: \"state\"; snapshot: BadgeCapabilities }\n  | { type: \"result\"; op: string; ok: true; snapshot: BadgeCapabilities }\n  | { type: \"result\"; op: string; ok: false; error: string; snapshot: BadgeCapabilities };\n\nexport interface BadgeHandle {\n  getCapabilities(): Promise<BadgeCapabilities>;\n  setBadge(value: string): Promise<BadgeCapabilities>;\n  clearBadge(): Promise<BadgeCapabilities>;\n  setProgress(value: number, max?: number): Promise<BadgeCapabilities>;\n  setProgressState(value: BadgeState[\"progressState\"]): Promise<BadgeCapabilities>;\n  setOverlayIcon(value: BadgeState[\"overlayIcon\"]): Promise<BadgeCapabilities>;\n  setAttention(value: boolean): Promise<BadgeCapabilities>;\n  showPanel(): Promise<BadgeCapabilities>;\n  hidePanel(): Promise<BadgeCapabilities>;\n  reset(): Promise<BadgeCapabilities>;\n}\n\nexport interface BadgePanelEnvelope {\n  platform: BadgePlatform;\n  mode: \"native\" | \"reduced\" | \"unsupported\";\n  capabilities: BadgeCapabilityFamily;\n  state: BadgeState;\n  log: string[];\n  reason?: string;\n}\n\nexport const defaultBadgeState = (): BadgeState => ({\n  badgeText: \"12\",\n  badgeCount: 12,\n  progressValue: 0,\n  progressMax: 100,\n  progressState: \"none\",\n  overlayIcon: \"dot\",\n  attention: false,\n});\n\nexport const defaultBadgeCapabilities = (platform: BadgePlatform): BadgeCapabilities => {\n  const common = {\n    badgeText: \"reduced\",\n    progress: \"unsupported\",\n    overlayIcon: \"reduced\",\n    attention: \"reduced\",\n  } satisfies BadgeCapabilityFamily;\n  return {\n    platform,\n    mode: \"reduced\",\n    capabilities: common,\n    state: defaultBadgeState(),\n    reason: \"badge projection is currently reduced to a local proof surface\",\n  };\n};\n\nexport const normalizeProgress = (value: number, max?: number): { value: number; max: number } => {\n  const normalizedMax = Number.isFinite(max ?? 100) ? Math.max(1, Math.round(max ?? 100)) : 100;\n  const normalizedValue = Number.isFinite(value) ? Math.max(0, Math.min(normalizedMax, Math.round(value))) : 0;\n  return { value: normalizedValue, max: normalizedMax };\n};\n\nexport const normalizeBadgeText = (value: string): { badgeText: string; badgeCount: number | null } => {\n  const badgeText = value.trim();\n  const parsed = Number.parseInt(badgeText, 10);\n  return {\n    badgeText,\n    badgeCount: Number.isFinite(parsed) ? parsed : null,\n  };\n};\n\nexport const badgePanelEnvelopeFromCapabilities = (\n  snapshot: BadgeCapabilities,\n): BadgePanelEnvelope => ({\n  platform: snapshot.platform,\n  mode: snapshot.mode,\n  capabilities: snapshot.capabilities,\n  state: snapshot.state,\n  log: [],\n  ...(snapshot.reason === undefined ? {} : { reason: snapshot.reason }),\n});\n","import type { ExtensionEnvelope } from \"@opentray/spec\";\nimport type { TrayHandle } from \"opentray\";\n\nimport {\n  badgePanelEnvelopeFromCapabilities,\n  defaultBadgeCapabilities,\n  normalizeBadgeText,\n  normalizeProgress,\n  type BadgeCapabilities,\n  type BadgeCapabilityFamily,\n  type BadgeEvent,\n  type BadgeHandle,\n  type BadgePanelEnvelope,\n  type BadgePlatform,\n  type BadgeState,\n} from \"./shared\";\n\nexport type * from \"./shared\";\nexport { badgePanelEnvelopeFromCapabilities } from \"./shared\";\n\nconst BADGE_EXTENSION_NAME = \"badge\";\nconst BADGE_EXTENSION_PACKAGE = \"@opentray/ext-badge\";\n\nexport interface BadgeExtensionOptions {\n  mountId?: string;\n  path?: string;\n  platform?: BadgePlatform;\n}\n\nexport interface BadgeExtensionCapability extends BadgeHandle {\n  readonly platform: BadgePlatform;\n  readonly getPanelEnvelope: () => Promise<BadgePanelEnvelope>;\n}\n\nexport const attachBadge = (tray: TrayHandle, options: BadgeExtensionOptions = {}): BadgeExtensionCapability => {\n  const platform = options.platform ?? process.platform as BadgePlatform;\n  const extension = tray.extend(BadgeExt, options);\n  return {\n    ...extension,\n    platform,\n    getPanelEnvelope: async () => badgePanelEnvelopeFromCapabilities(await extension.getCapabilities()),\n  };\n};\n\nexport const BadgeExt = {\n  name: BADGE_EXTENSION_NAME,\n  path: BADGE_EXTENSION_PACKAGE,\n  resolveMount(options: BadgeExtensionOptions | undefined) {\n    return {\n      ...(options?.mountId === undefined ? {} : { mountId: options.mountId }),\n      ...(options?.path === undefined ? {} : { path: options.path }),\n    };\n  },\n  extend(tray: TrayHandle, context, options: BadgeExtensionOptions | undefined): BadgeHandle {\n    const requestedPlatform = options?.platform ?? (process.platform as BadgePlatform);\n    const snapshot = defaultBadgeCapabilities(requestedPlatform);\n    return createBadgeHandle(() => context.ensureLoaded(), tray, context.mountId, snapshot);\n  },\n} satisfies import(\"opentray\").TrayExtension<BadgeHandle, BadgeExtensionOptions>;\n\nexport const isBadgeEvent = (event: ExtensionEnvelope): event is ExtensionEnvelope<BadgeEvent> =>\n  event.scope.ext === BADGE_EXTENSION_NAME &&\n  typeof event.data === \"object\" &&\n  event.data !== null &&\n  \"type\" in event.data;\n\nfunction createBadgeHandle(\n  ensureLoaded: () => Promise<void>,\n  tray: TrayHandle,\n  mountId: string,\n  seed: BadgeCapabilities,\n): BadgeHandle {\n  const state: BadgeState = structuredClone(seed.state);\n  const capabilities: BadgeCapabilityFamily = { ...seed.capabilities };\n  const platform = seed.platform;\n  const mode = seed.mode;\n  const reason = seed.reason;\n\n  const snapshot = (): BadgeCapabilities => ({\n    platform,\n    mode,\n    capabilities: { ...capabilities },\n    state: structuredClone(state),\n    ...(reason === undefined ? {} : { reason }),\n  });\n\n  const rejectUnsupported = (family: keyof BadgeCapabilityFamily, op: string): never => {\n    const support = capabilities[family];\n    throw new Error(`${op} is ${support} on ${platform}`);\n  };\n\n  return {\n    getCapabilities: async () => {\n      await ensureLoaded();\n      await tray.requestExtension(mountId, { type: \"getCapabilities\" });\n      return snapshot();\n    },\n    setBadge: async (value: string) => {\n      await ensureLoaded();\n      const normalized = normalizeBadgeText(value);\n      state.badgeText = normalized.badgeText;\n      state.badgeCount = normalized.badgeCount;\n      await tray.commandExtension(mountId, { type: \"setBadge\", value: normalized.badgeText });\n      return snapshot();\n    },\n    clearBadge: async () => {\n      await ensureLoaded();\n      state.badgeText = \"\";\n      state.badgeCount = null;\n      await tray.commandExtension(mountId, { type: \"clearBadge\" });\n      return snapshot();\n    },\n    setProgress: async (value: number, max?: number) => {\n      await ensureLoaded();\n      if (capabilities.progress === \"unsupported\") {\n        rejectUnsupported(\"progress\", \"setProgress\");\n      }\n      const normalized = normalizeProgress(value, max);\n      state.progressValue = normalized.value;\n      state.progressMax = normalized.max;\n      await tray.commandExtension(mountId, { type: \"setProgress\", value: normalized.value, max: normalized.max });\n      return snapshot();\n    },\n    setProgressState: async (value: BadgeState[\"progressState\"]) => {\n      await ensureLoaded();\n      if (capabilities.progress === \"unsupported\") {\n        rejectUnsupported(\"progress\", \"setProgressState\");\n      }\n      state.progressState = value;\n      await tray.commandExtension(mountId, { type: \"setProgressState\", value });\n      return snapshot();\n    },\n    setOverlayIcon: async (value: BadgeState[\"overlayIcon\"]) => {\n      await ensureLoaded();\n      state.overlayIcon = value;\n      await tray.commandExtension(mountId, { type: \"setOverlayIcon\", value });\n      return snapshot();\n    },\n    setAttention: async (value: boolean) => {\n      await ensureLoaded();\n      state.attention = Boolean(value);\n      await tray.commandExtension(mountId, { type: \"setAttention\", value: Boolean(value) });\n      return snapshot();\n    },\n    showPanel: async () => {\n      await ensureLoaded();\n      await tray.commandExtension(mountId, { type: \"showPanel\" });\n      return snapshot();\n    },\n    hidePanel: async () => {\n      await ensureLoaded();\n      await tray.commandExtension(mountId, { type: \"hidePanel\" });\n      return snapshot();\n    },\n    reset: async () => {\n      await ensureLoaded();\n      Object.assign(state, seed.state);\n      await tray.commandExtension(mountId, { type: \"reset\" });\n      return snapshot();\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,26 +1,44 @@
 {
   "name": "@opentray/ext-badge",
-  "version": "0.0.0",
-  "description": "Official OpenTray platform badge, progress, and overlay API extension.",
+  "version": "0.1.0",
+  "description": "Official OpenTray status extension backed by the OpenTray extension ABI.",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jixoai/opentray"
+  },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "platforms",
     "README.md"
   ],
   "sideEffects": false,
   "peerDependencies": {
     "opentray": ">=0.0.0"
   },
+  "optionalDependencies": {
+    "@opentray/ext-badge-darwin-arm64": "0.1.0",
+    "@opentray/ext-badge-darwin-x64": "0.1.0",
+    "@opentray/ext-badge-windows-arm64": "0.1.0",
+    "@opentray/ext-badge-windows-x64": "0.1.0"
+  },
   "devDependencies": {
-    "opentray": "0.0.0"
+    "tsdown": "^0.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7",
+    "@opentray/spec": "0.5.0",
+    "opentray": "0.7.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }