@signalsafe/tree-spec-editor 0.2.0 → 0.2.2

package/dist/panels/inspector/choiceActionIconProps.d.ts

@@ -0,0 +1,12 @@
+import type { KeyboardEvent, MouseEvent } from 'react';
+export declare function choiceActionIconProps(onClick: () => void, title: string, className: string, disabled?: boolean): {
+    role: "button";
+    tabIndex: number;
+    title: string;
+    'aria-label': string;
+    'aria-disabled': boolean | undefined;
+    className: string;
+    onClick: ((event: MouseEvent<HTMLElement>) => void) | undefined;
+    onKeyDown: ((event: KeyboardEvent<HTMLElement>) => void) | undefined;
+};
+//# sourceMappingURL=choiceActionIconProps.d.ts.map

package/dist/panels/inspector/choiceActionIconProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choiceActionIconProps.d.ts","sourceRoot":"","sources":["../../../src/panels/inspector/choiceActionIconProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEvD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,IAAI,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,UAAQ;;;;;;;sBAaE,UAAU,CAAC,WAAW,CAAC;wBAOvB,aAAa,CAAC,WAAW,CAAC;EAQ/C"}

package/dist/panels/inspector/choiceActionIconProps.js

@@ -0,0 +1,26 @@
+export function choiceActionIconProps(onClick, title, className, disabled = false) {
+    return {
+        role: 'button',
+        tabIndex: disabled ? -1 : 0,
+        title,
+        'aria-label': title,
+        'aria-disabled': disabled ? true : undefined,
+        className: `${className} action-icon flex-shrink-0${disabled ? ' text-secondary opacity-50' : ' cursor-pointer'}`,
+        onClick: disabled
+            ? undefined
+            : (event) => {
+                event.preventDefault();
+                event.stopPropagation();
+                onClick();
+            },
+        onKeyDown: disabled
+            ? undefined
+            : (event) => {
+                if (event.key === 'Enter' || event.key === ' ') {
+                    event.preventDefault();
+                    event.stopPropagation();
+                    onClick();
+                }
+            },
+    };
+}

package/dist/panels/inspector/types.d.ts

@@ -0,0 +1,77 @@
+import type { ReactNode } from 'react';
+import type { EditorChoice, EditorNode, EditorTransition, EditorTree } from '@signalsafe/tree-spec-editor-core';
+/** Host-provided choice type (stable id + default label). */
+export type ChoiceTypeOption = {
+    id: string;
+    label: string;
+};
+/**
+ * Canonical outcome values from the `@signalsafe/tree-spec` wire contract.
+ * Hosts can override via the `outcomeOptions` prop.
+ */
+export declare const DEFAULT_OUTCOME_OPTIONS: ReadonlyArray<{
+    value: string;
+    label: string;
+}>;
+export interface InspectorNodeRenderContext {
+    tree: EditorTree;
+    node: EditorNode;
+    isPublished: boolean;
+    onUpdateNode: (patch: Partial<EditorNode>) => void;
+}
+export interface InspectorChoiceRenderContext {
+    tree: EditorTree;
+    node: EditorNode;
+    choice: EditorChoice;
+    transition: EditorTransition | undefined;
+    isPublished: boolean;
+    onUpdateNode: (patch: Partial<EditorNode>) => void;
+}
+export interface InspectorPanelProps {
+    tree: EditorTree;
+    selectedNode: EditorNode | null;
+    focusChoiceId?: string | null;
+    isPublished?: boolean;
+    /** Sync canvas / sidebar highlight when the user focuses a choice field. */
+    onFocusChoice?: (choiceId: string) => void;
+    onUpdateSelectedNode: (patch: Partial<EditorNode>) => void;
+    onAddChoice: () => void;
+    onDeleteChoice: (choiceId: string) => void;
+    /** Move a choice up or down in the node's choice list. When omitted, reorder controls are hidden. */
+    onMoveChoice?: (choiceId: string, direction: 'up' | 'down') => void;
+    onSetChoiceTarget: (choiceId: string, targetNodeId: string) => void;
+    onSetChoiceOutcome: (choiceId: string, outcome: string) => void;
+    /**
+     * Override the END-transition outcome `<select>` options.
+     * Defaults to the canonical TreeSpec `TerminalOutcome` values.
+     */
+    outcomeOptions?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    /** Hide the outcome selector entirely. Useful when the host manages outcomes elsewhere. */
+    hideOutcomeField?: boolean;
+    /** Render extra UI below the prompt textarea, scoped to the current node. */
+    renderExtraNodeFields?: (ctx: InspectorNodeRenderContext) => ReactNode;
+    /** Render extra UI below each choice card (after Next/Outcome). */
+    renderExtraChoiceFields?: (ctx: InspectorChoiceRenderContext) => ReactNode;
+    /** Host-defined choice types (stable ids) for the Type selector on each choice. */
+    choiceTypes?: ReadonlyArray<ChoiceTypeOption>;
+    onSetChoiceType?: (choiceId: string, typeId: string, defaultLabel?: string) => void;
+    /**
+     * When set, shows a delete control in the Required card header (grid-style icon button).
+     * Typical host: `editor.actions.deleteSelectedNode`. Disabled when `isPublished` is true.
+     */
+    onDeleteSelectedNode?: () => void;
+    /** Override the Required card header (default "Required"). */
+    title?: string;
+    /** Override the empty-state message (default "Select a node to edit it."). */
+    emptyStateText?: string;
+    /**
+     * Override the muted helper text under the Type field.
+     * Defaults to: "Type is stored as a string in tree_spec. You can use presets or any custom value."
+     */
+    typeHelperText?: string;
+}
+export declare const DEFAULT_TYPE_HELPER_TEXT = "Type is stored as a string in tree_spec. You can use presets or any custom value.";
+//# sourceMappingURL=types.d.ts.map

package/dist/panels/inspector/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/panels/inspector/types.ts"],"names":[],"mappings":"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"}

package/dist/panels/inspector/types.js

@@ -0,0 +1,11 @@
+import { TERMINAL_OUTCOME } from '@signalsafe/tree-spec';
+/**
+ * Canonical outcome values from the `@signalsafe/tree-spec` wire contract.
+ * Hosts can override via the `outcomeOptions` prop.
+ */
+export const DEFAULT_OUTCOME_OPTIONS = [
+    { value: TERMINAL_OUTCOME.SAFE, label: TERMINAL_OUTCOME.SAFE },
+    { value: TERMINAL_OUTCOME.AT_RISK, label: TERMINAL_OUTCOME.AT_RISK },
+    { value: TERMINAL_OUTCOME.COMPROMISED, label: TERMINAL_OUTCOME.COMPROMISED },
+];
+export const DEFAULT_TYPE_HELPER_TEXT = 'Type is stored as a string in tree_spec. You can use presets or any custom value.';

package/package.json

@@ -1,69 +1,87 @@
 {
     "name": "@signalsafe/tree-spec-editor",
-    "version": "0.2.0",
-  "private": false,
-  "type": "module",
-  "description": "Reusable TreeSpec graph editor (React Flow) and authoring helpers (no API or routing)",
-  "license": "UNLICENSED",
-  "keywords": [
-    "tree-spec",
-    "react-flow",
-    "editor",
-    "signalsafe"
-  ],
-  "sideEffects": false,
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+    "version": "0.2.2",
+    "type": "module",
+    "description": "Reusable TreeSpec graph editor (React Flow) and authoring helpers (no API or routing).",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/SignalSafeSoftware/tree-spec-editor.git"
+    },
+    "bugs": {
+        "url": "https://github.com/SignalSafeSoftware/tree-spec-editor/issues"
+    },
+    "homepage": "https://github.com/SignalSafeSoftware/tree-spec-editor#readme",
+    "keywords": [
+        "tree-spec",
+        "react-flow",
+        "editor",
+        "graph-editor",
+        "decision-tree",
+        "react-bootstrap",
+        "typescript",
+        "signalsafe"
+    ],
+    "sideEffects": false,
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "docs",
+        "README.md",
+        "LICENSE"
+    ],
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "typecheck": "tsc --noEmit",
+        "pack:local": "npm pack --pack-destination ../../dist/reusable-npm",
+        "release:check": "node ../../scripts/run-private-package-release-checks.mjs --mode prepublish",
+        "release:verify": "node ../../scripts/run-private-package-release-checks.mjs --mode postpublish",
+        "publish:preflight": "node ../../scripts/check-private-registry-preflight.mjs --scope @signalsafe",
+        "publish:dry-run": "npm publish --dry-run",
+        "publish:verify": "node ../../scripts/check-private-package-postpublish.mjs --scope @signalsafe --package @signalsafe/tree-spec-editor --version $npm_package_version",
+        "pack:check": "node ../../scripts/check-package-tarball.mjs --tgz \"../../dist/reusable-npm/signalsafe-tree-spec-editor-$npm_package_version.tgz\" --expect package/dist/index.js --expect package/dist/index.d.ts --expect package/package.json --expect package/README.md",
+        "smoke:external": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs",
+        "smoke:published": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs --source registry",
+        "prepublishOnly": "npm run build",
+        "prepare": "npm run build",
+        "test": "vitest run",
+        "test:monorepo": "cd ../../frontend && yarn vitest run --config vitest.tree-spec-editor.config.ts"
+    },
+    "dependencies": {
+        "@signalsafe/tree-spec": "^0.3.1",
+        "@signalsafe/tree-spec-editor-core": "^0.1.2",
+        "@signalsafe/tree-spec-editor-react": "^0.1.2"
+    },
+    "peerDependencies": {
+        "react": "^18.0.0",
+        "react-bootstrap": "^2.10.0",
+        "react-dom": "^18.0.0",
+        "reactflow": "^11.0.0"
+    },
+    "devDependencies": {
+        "@types/react": "^18.2.66",
+        "@types/react-dom": "^18.2.22",
+        "@types/react-test-renderer": "^18.3.0",
+        "react": "^18.3.1",
+        "react-bootstrap": "^2.10.2",
+        "react-dom": "^18.3.1",
+        "react-test-renderer": "^18.3.1",
+        "reactflow": "^11.11.4",
+        "typescript": "^5.4.2",
+        "vitest": "^3.2.4"
     }
-  },
-  "files": [
-    "dist",
-    "docs",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "pack:local": "npm pack --pack-destination ../../dist/reusable-npm",
-    "release:check": "node ../../scripts/run-private-package-release-checks.mjs --mode prepublish",
-    "release:verify": "node ../../scripts/run-private-package-release-checks.mjs --mode postpublish",
-    "publish:preflight": "node ../../scripts/check-private-registry-preflight.mjs --scope @signalsafe",
-    "publish:dry-run": "npm publish --dry-run",
-    "publish:verify": "node ../../scripts/check-private-package-postpublish.mjs --scope @signalsafe --package @signalsafe/tree-spec-editor --version $npm_package_version",
-    "pack:check": "node ../../scripts/check-package-tarball.mjs --tgz \"../../dist/reusable-npm/signalsafe-tree-spec-editor-$npm_package_version.tgz\" --expect package/dist/index.js --expect package/dist/index.d.ts --expect package/package.json --expect package/README.md",
-    "smoke:external": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs",
-    "smoke:published": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs --source registry",
-    "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
-    "test": "cd ../../frontend && yarn vitest run --config vitest.tree-spec-editor.config.ts"
-  },
-  "dependencies": {
-    "@signalsafe/tree-spec": "^0.1.3",
-    "@signalsafe/tree-spec-editor-core": "^0.1.0",
-    "@signalsafe/tree-spec-editor-react": "^0.1.0"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0",
-    "react-bootstrap": "^2.10.0",
-    "react-dom": "^18.0.0",
-    "reactflow": "^11.0.0"
-  },
-  "devDependencies": {
-    "@types/react": "^18.2.66",
-    "@types/react-dom": "^18.2.22",
-    "react": "^18.3.1",
-    "react-bootstrap": "^2.10.2",
-    "react-dom": "^18.3.1",
-    "react-test-renderer": "18.3.1",
-    "reactflow": "^11.11.4",
-    "typescript": "^5.4.2"
-  }
 }