@atlassian/chippy 0.0.0-stage → 0.0.1-beta.2

package/lib/types/plugins/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Chippy plugin registry. The core runtime has no product knowledge; plugins
+ * add it through the context provider and commit metrics adapter seams.
+ *
+ * The bundle ships the built-in Jira and ATL plugins, and a packed build
+ * (`chippy pack`) appends more through `__AVALANCHE__.registerPlugin()`. A
+ * plugin runs only once it is both registered and enabled. A page enables
+ * plugins through the startup config (`plugins: ['jira', 'atl']`), the
+ * `__CHIPPY_PLUGINS` global, or `__AVALANCHE__.enablePlugins()`; a packed
+ * build can name defaults for pages that do neither.
+ */
+import { type CommitMetricsAdapter } from '../avalanche/commit-metrics-adapter.js';
+import { type ContextProvider } from '../layout-lab/marker-context.js';
+export type ChippyPlugin = {
+    /** Stable id used to enable the plugin, e.g. `'jira'`. */
+    id: string;
+    /** Short name shown in the extension's plugin settings. */
+    label?: string;
+    contextProvider?: ContextProvider;
+    commitMetricsAdapter?: CommitMetricsAdapter;
+};
+export type PluginStatus = {
+    id: string;
+    label: string;
+    enabled: boolean;
+};
+export declare const BUILTIN_PLUGINS: readonly ChippyPlugin[];
+/**
+ * Register a plugin. It starts at once if its id was already enabled.
+ * Registering the same id again replaces the earlier plugin.
+ */
+export declare function registerPlugin(plugin: ChippyPlugin): () => void;
+/**
+ * Enable plugins by id. An id that is not registered yet starts when its
+ * plugin registers; non-string ids are ignored. Returns the running ids.
+ */
+export declare function enablePlugins(ids: unknown): string[];
+/**
+ * Record the page's own plugin selection. Once a page has chosen, build
+ * defaults no longer apply, so a user who turned a default off keeps it off.
+ */
+export declare function selectPlugins(ids: unknown): string[];
+/** Enable a packed build's default plugins unless the page made its own selection. */
+export declare function enableDefaultPlugins(ids: unknown): string[];
+export declare function listPlugins(): PluginStatus[];
+/** Register the built-in plugins. Returns a function that removes them. */
+export declare function registerBuiltinPlugins(): () => void;
+/** Stop every plugin and forget all registrations and selections. Test helper. */
+export declare function resetPlugins(): void;

package/lib/types/plugins/jira/context-provider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Jira context provider: recognizes Jira's OwnerMark/OwnershipMark ownership
+ * markers and JSErrorBoundary props, and layers them onto the generic marker
+ * context as an `owner` boundary kind and error-boundary enrichment.
+ *
+ * Registered by the bundle's composition root; the core marker context works
+ * without it.
+ */
+import { type Fiber } from '../../layout-lab/fiber-walk.js';
+import { type ContextContribution, type ContextProvider, type MarkerContext } from '../../layout-lab/marker-context.js';
+export type JiraOwnership = {
+    markerName: string;
+    type: string | null;
+    name: string | null;
+    packageName: string | null;
+    teamName: string | null;
+    variant: string | null;
+    source: 'display-name' | 'props';
+};
+export type JiraErrorBoundary = {
+    componentName: string;
+    id: string | null;
+    packageName: string | null;
+    fallback: string | null;
+    teamName: string | null;
+};
+export declare function parseOwnerMarkDisplayName(displayName: string | null | undefined): JiraOwnership | null;
+export declare function describeOwnership(fiber: Fiber): JiraOwnership | null;
+/**
+ * Scan the probed ancestry for OwnerMark ownership, the nearest JSErrorBoundary,
+ * and Jira's ErrorComponent fallback marker.
+ */
+export declare function describeJiraContribution(fibers: Fiber[]): ContextContribution | null;
+export declare const jiraContextProvider: ContextProvider;
+/** The marker context with the Jira fields always present. */
+export declare function describeJiraContext(fiber: Fiber | null | undefined): MarkerContext | null;

package/package.json

@@ -1,6 +1,108 @@
 {
   "name": "@atlassian/chippy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1-beta.2",
+  "description": "React runtime inspection and Avalanche commit evidence",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atlassian-labs/chippy.git"
+  },
+  "homepage": "https://github.com/atlassian-labs/chippy#readme",
+  "bugs": {
+    "url": "https://github.com/atlassian-labs/chippy/issues"
+  },
+  "packageManager": "yarn@4.8.1",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "registry": "https://packages.atlassian.com/api/npm/npm-public/"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "bin": {
+    "chippy": "./bin/chippy.mjs",
+    "chippy-mcp": "./lib/mcp-skill/scripts/chippy-mcp.cjs"
+  },
+  "exports": {
+    "./avalanche": {
+      "types": "./lib/types/package/avalanche.d.ts",
+      "import": "./lib/avalanche.js"
+    },
+    "./bootstrap": {
+      "types": "./lib/bootstrap.d.ts",
+      "import": "./lib/bootstrap.js"
+    },
+    "./browser": {
+      "types": "./lib/types/package/browser.d.ts",
+      "import": "./lib/browser.js"
+    },
+    "./plugin": {
+      "types": "./lib/types/package/plugin.d.ts",
+      "import": "./lib/plugin.js"
+    },
+    "./storybook": "./lib/storybook/preset.js"
+  },
+  "scripts": {
+    "storybook": "storybook dev -p 6006 --host 0.0.0.0",
+    "build-storybook": "storybook build",
+    "chippy:helper": "node .agents/skills/chippy/scripts/chippy-helper-server.js",
+    "avalanche:build": "vite build --config vite.avalanche.config.ts",
+    "avalanche:sync": "yarn avalanche:build && cp dist/avalanche.iife.js .agents/skills/chippy/extension/avalanche.iife.js && cp dist/avalanche.es.js .agents/skills/chippy/extension/avalanche.es.js && cp dist/avalanche.iife.js.map .agents/skills/chippy/extension/avalanche.iife.js.map && cp dist/avalanche.es.js.map .agents/skills/chippy/extension/avalanche.es.js.map",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.helper.json",
+    "test:chippy-headless": "vitest run src/__tests__/chippy-capabilities.test.ts",
+    "chippy:zip": "node scripts/package-chippy.mjs skill",
+    "chippy:extension:zip": "node scripts/package-chippy.mjs extension",
+    "chippy:library:build": "node scripts/build-chippy-library.mjs",
+    "chippy:mcp:build": "node scripts/build-chippy-mcp.mjs",
+    "chippy:mcp": "node .agents/skills/chippy/scripts/chippy-mcp.cjs"
+  },
+  "peerDependencies": {
+    "esbuild": ">=0.20",
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20",
+    "storybook": "^10.3.3"
+  },
+  "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "storybook": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "^7.27.1",
+    "@babel/plugin-transform-react-jsx-source": "^7.27.1",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@playwright/cli": "^0.1.13",
+    "@storybook/react-vite": "^10.3.3",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22",
+    "@vitejs/plugin-react": "^4.3.4",
+    "esbuild": "^0.25.12",
+    "jsdom": "^26.1.0",
+    "playwright": "^1.64.1",
+    "react": "^18.3.1",
+    "react-19": "npm:react@19.2.0",
+    "react-dom": "^18.3.1",
+    "react-dom-19": "npm:react-dom@19.2.0",
+    "storybook": "^10.3.3",
+    "typescript": "^5.9.3",
+    "vite": "^6.4.1",
+    "vitest": "^3.2.4",
+    "zod": "^4.6.7"
+  }
+}