nirs4all-ui 0.1.13 → 0.1.14

package/README.md

@@ -21,6 +21,7 @@ spectra motion asset.
 | `conformal` | `nirs4all-ui/conformal` | Validation and pure view-model projection for native nirs4all `CalibratedRunResult.to_dict()` and `ConformalMetricSet.to_dict()` payloads, guarantee-status badges, calibration replay provenance, coverage options, per-sample prediction interval rows, materialized interval summaries, and empirical metric rows. |
 | `robustness` | `nirs4all-ui/robustness` | Validation and compact card view-models for nirs4all robustness `summary.json` artifacts, optional conformal guarantee badge projection, plus fallback and registry-derived mode/scenario/distribution vocabulary and form validation aligned with the Python keyword registry. |
 | `keywordRegistry` | `nirs4all-ui/keywordRegistry` | Metadata-only validation, indexing, id/path/token/alias resolution, value-option extraction, form-field projection, ordered form-section grouping, optimizer-persistence field grouping, and workspace prediction publication contract projection for the exported full Python nirs4all keyword/effect registry. |
+| `nodeRegistry` | `nirs4all-ui/nodeRegistry` | `projectN4mManifest`: projects the n4m method manifest (`n4m_cli --manifest-json`) into typed pipeline-editor node definitions — role → node type, typed parameters (bounds, choices, unset defaults), required fit inputs, `n4m:<method_id>` operator token. |
 | `tuning` | `nirs4all-ui/tuning` | Validation and pure view-model projection for native nirs4all `TuningResult.to_dict()` payloads, lightweight `TuningResult.summary_artifact()` / `nirs4all.tuning.summary` cards, and pre-execution `nirs4all.tuning.ordered_search_space` artifacts for Studio/Web forms without optimizer logic. |
 | `dataset` | `nirs4all-ui/dataset` | Dataset preview contracts, counts, split summaries, spectral ranges, task labels, badges, and stats. |
 | `components` | `nirs4all-ui/components` | Stateless React components that render shared runtime, diagnostic, and metric affordances. |
@@ -35,7 +36,7 @@ spectra motion asset.
 The root export also exposes namespace barrels:
 
 ```ts
-import { brand, chains, conformal, dag, dataset, datasetBuilder, keywordRegistry, lab, robustness, runtime, score, styles, tuning } from "nirs4all-ui";
+import { brand, chains, conformal, dag, dataset, datasetBuilder, keywordRegistry, lab, nodeRegistry, robustness, runtime, score, styles, tuning } from "nirs4all-ui";
 ```
 
 Prefer domain imports when a consumer only needs one area:
@@ -47,6 +48,7 @@ import { buildRuntimeResultStatusView } from "nirs4all-ui/runtime";
 import { createConformalGuaranteeView, getCalibrationReplaySource, parseCalibratedRunResultArtifact } from "nirs4all-ui/conformal";
 import { createRobustnessGuaranteeView, createRobustnessSummaryCards, getRobustnessSpectralReplay, parseRobustnessSummaryArtifact, validateRobustnessScenarioDraft } from "nirs4all-ui/robustness";
 import { createKeywordRegistryFieldViews, createKeywordRegistryWorkspacePredictionPublicationContract, parseKeywordRegistryDocument } from "nirs4all-ui/keywordRegistry";
+import { projectN4mManifest } from "nirs4all-ui/nodeRegistry";
 import { createTuningSearchSpacePreview, createTuningStudySummary, createTuningSummaryCard, createTuningTrialRows, parseOrderedTuningSearchSpaceArtifact, parseTuningResultArtifact, parseTuningSummaryArtifact } from "nirs4all-ui/tuning";
 import { DatasetBuilder } from "nirs4all-ui/datasetBuilder";
 import { DagGraphView, fromCompiledGraph } from "nirs4all-ui/dag";

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * as runtime from "./runtime/index.js";
 export * as conformal from "./conformal/index.js";
 export * as robustness from "./robustness/index.js";
 export * as keywordRegistry from "./keywordRegistry/index.js";
+export * as nodeRegistry from "./nodeRegistry/index.js";
 export * as tuning from "./tuning/index.js";
 export * as dataset from "./dataset/index.js";
 export * as components from "./components/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -10,6 +10,7 @@ export * as runtime from "./runtime/index.js";
 export * as conformal from "./conformal/index.js";
 export * as robustness from "./robustness/index.js";
 export * as keywordRegistry from "./keywordRegistry/index.js";
+export * as nodeRegistry from "./nodeRegistry/index.js";
 export * as tuning from "./tuning/index.js";
 export * as dataset from "./dataset/index.js";
 export * as components from "./components/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC"}

package/dist/nodeRegistry/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Node registry projections — public surface.
+ *
+ * Pure helpers that turn native method metadata (the n4m manifest) into
+ * pipeline-editor node definitions for Studio and Web. Execution stays with
+ * the hosts' runtimes.
+ */
+export * from "./n4m.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/nodeRegistry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nodeRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,UAAU,CAAC"}

package/dist/nodeRegistry/index.js

@@ -0,0 +1,9 @@
+/**
+ * Node registry projections — public surface.
+ *
+ * Pure helpers that turn native method metadata (the n4m manifest) into
+ * pipeline-editor node definitions for Studio and Web. Execution stays with
+ * the hosts' runtimes.
+ */
+export * from "./n4m.js";
+//# sourceMappingURL=index.js.map

package/dist/nodeRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodeRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,UAAU,CAAC"}

package/dist/nodeRegistry/n4m.d.ts

@@ -0,0 +1,83 @@
+export declare const N4M_OPERATOR_TOKEN_PREFIX: "n4m:";
+export type N4mRole = "transformer" | "regressor" | "classifier" | "selector" | "sample_filter" | "splitter" | "augmenter" | "generic";
+export type N4mFitInput = "y" | "labels" | "sample_weight" | "groups" | "feature_groups" | "blocks" | "axis" | "target_domain" | "fold_ids";
+export type N4mInputRequirement = "none" | "optional" | "required";
+export type N4mParamType = "int" | "double" | "bool" | "enum" | "int_array" | "double_array";
+export type N4mParamValue = number | boolean | string | number[];
+export interface N4mManifestParam {
+    name: string;
+    type: N4mParamType;
+    required: boolean;
+    /** `null` means an unset optional value (the native default applies). */
+    default: N4mParamValue | null;
+    min: number | null;
+    max: number | null;
+    choices: readonly string[];
+}
+export interface N4mManifestMethod {
+    method_id: string;
+    fq_name: string;
+    kind: "estimator" | "procedure";
+    roles: readonly N4mRole[];
+    node_kinds: readonly string[];
+    capabilities: readonly string[];
+    state_format?: string;
+    inputs: Readonly<Record<N4mFitInput, N4mInputRequirement>>;
+    params: readonly N4mManifestParam[];
+}
+/** The `n4m_cli --manifest-json` document. */
+export interface N4mManifest {
+    abi: string;
+    methods: readonly N4mManifestMethod[];
+}
+export type NodeType = "preprocessing" | "model" | "filter" | "splitting" | "augmentation";
+export type NodeParameterType = "int" | "float" | "bool" | "select" | "array";
+export interface NodeParameterDefinition {
+    name: string;
+    label: string;
+    type: NodeParameterType;
+    required: boolean;
+    /** Absent when the native default is an unset optional value. */
+    default?: N4mParamValue;
+    /** Numeric bounds; for arrays they bound each item. */
+    min?: number;
+    max?: number;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    itemType?: "int" | "float";
+}
+export interface NodeFitInputRequirement {
+    input: N4mFitInput;
+    requirement: "optional" | "required";
+    label: string;
+}
+/** A pipeline-editor node projected from one n4m method role. */
+export interface NodeDefinition {
+    /** `<type>.n4m_<method_id with "_" for ".">`. */
+    id: string;
+    name: string;
+    type: NodeType;
+    description: string;
+    category: string;
+    /** Portable operator token `n4m:<method_id>`, serialized as the step `class`. */
+    classPath: string;
+    source: "n4m";
+    tags: string[];
+    parameters: NodeParameterDefinition[];
+    n4m: {
+        methodId: string;
+        kind: "estimator" | "procedure";
+        role: Exclude<N4mRole, "generic">;
+        capabilities: readonly string[];
+        fitInputs: NodeFitInputRequirement[];
+    };
+}
+/**
+ * Project the n4m method manifest into pipeline-editor node definitions: one
+ * node per distinct node type a method's roles map to. Generic procedures have
+ * no pipeline node and are omitted.
+ */
+export declare function projectN4mManifest(manifest: N4mManifest): NodeDefinition[];
+//# sourceMappingURL=n4m.d.ts.map

package/dist/nodeRegistry/n4m.d.ts.map

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

package/dist/nodeRegistry/n4m.js

@@ -0,0 +1,131 @@
+export const N4M_OPERATOR_TOKEN_PREFIX = "n4m:";
+const ROLE_NODE_TYPE = {
+    transformer: "preprocessing",
+    selector: "preprocessing",
+    regressor: "model",
+    classifier: "model",
+    sample_filter: "filter",
+    splitter: "splitting",
+    augmenter: "augmentation",
+};
+const ROLE_LABEL = {
+    transformer: "transformer",
+    selector: "feature selector",
+    regressor: "regressor",
+    classifier: "classifier",
+    sample_filter: "sample filter",
+    splitter: "splitter",
+    augmenter: "augmenter",
+};
+const FIT_INPUT_LABEL = {
+    y: "targets",
+    labels: "class labels",
+    sample_weight: "sample weights",
+    groups: "sample groups",
+    feature_groups: "feature groups",
+    blocks: "multiblock",
+    axis: "wavelengths",
+    target_domain: "transfer target",
+    fold_ids: "CV folds",
+};
+const ACRONYMS = new Set([
+    "airpls", "aom", "arpls", "asls", "beads", "bipls", "bve", "cars", "cow", "cppls", "cv", "da", "di", "ds",
+    "dtw", "ecr", "emcuve", "emsc", "epo", "fck", "g", "ga", "gpr", "hpo", "iasls", "ipw", "irf", "iriv", "l1",
+    "lda", "lw", "mb", "mir", "msc", "nipals", "o2pls", "on", "osc", "pca", "pcr", "pds", "pls", "pop", "pso",
+    "q", "qda", "rep", "rosa", "saps", "scars", "simpls", "sipls", "snip", "snv", "so", "spa", "spxy", "st",
+    "svd", "t2", "uve", "vip", "vissa", "vsn", "wvc", "x", "y",
+]);
+function humanize(snake) {
+    return snake
+        .split("_")
+        .filter(Boolean)
+        .map((word) => (ACRONYMS.has(word) ? word.toUpperCase() : `${word.charAt(0).toUpperCase()}${word.slice(1)}`))
+        .join(" ");
+}
+function methodGroup(methodId) {
+    const segments = methodId.split(".");
+    return segments[segments.length - 2] ?? segments[0] ?? methodId;
+}
+const PARAM_TYPE = {
+    int: "int",
+    double: "float",
+    bool: "bool",
+    enum: "select",
+    int_array: "array",
+    double_array: "array",
+};
+function projectParam(param) {
+    const view = {
+        name: param.name,
+        label: humanize(param.name),
+        type: PARAM_TYPE[param.type],
+        required: param.required,
+    };
+    if (param.type === "enum")
+        view.options = param.choices.map((choice) => ({ value: choice, label: choice }));
+    if (param.type === "int_array")
+        view.itemType = "int";
+    if (param.type === "double_array")
+        view.itemType = "float";
+    if (param.default !== null)
+        view.default = param.default;
+    if (param.min !== null)
+        view.min = param.min;
+    if (param.max !== null)
+        view.max = param.max;
+    return view;
+}
+function fitInputRequirements(method) {
+    return Object.keys(FIT_INPUT_LABEL)
+        .map((input) => ({ input, requirement: method.inputs[input] }))
+        .filter((entry) => entry.requirement !== "none")
+        .map(({ input, requirement }) => ({ input, requirement, label: FIT_INPUT_LABEL[input] }));
+}
+function describe(method, role, fitInputs) {
+    const required = fitInputs.filter((entry) => entry.requirement === "required" && entry.input !== "y");
+    const needs = required.length > 0 ? ` Requires ${required.map((entry) => entry.label).join(", ")}.` : "";
+    return `Native nirs4all-methods ${ROLE_LABEL[role]} (${method.method_id}).${needs}`;
+}
+/**
+ * Project the n4m method manifest into pipeline-editor node definitions: one
+ * node per distinct node type a method's roles map to. Generic procedures have
+ * no pipeline node and are omitted.
+ */
+export function projectN4mManifest(manifest) {
+    const nodes = [];
+    for (const method of manifest.methods) {
+        const group = methodGroup(method.method_id);
+        const leaf = method.method_id.split(".").pop() ?? method.method_id;
+        const fitInputs = fitInputRequirements(method);
+        const parameters = method.params.map(projectParam);
+        const seen = new Set();
+        for (const role of method.roles) {
+            if (role === "generic")
+                continue;
+            const type = ROLE_NODE_TYPE[role];
+            if (seen.has(type))
+                continue;
+            seen.add(type);
+            nodes.push({
+                id: `${type}.n4m_${method.method_id.replaceAll(".", "_")}`,
+                name: humanize(leaf),
+                type,
+                description: describe(method, role, fitInputs),
+                category: humanize(group),
+                classPath: `${N4M_OPERATOR_TOKEN_PREFIX}${method.method_id}`,
+                source: "n4m",
+                tags: ["n4m", role, group],
+                parameters,
+                n4m: {
+                    methodId: method.method_id,
+                    kind: method.kind,
+                    role,
+                    capabilities: method.capabilities,
+                    fitInputs,
+                },
+            });
+        }
+    }
+    return nodes;
+}
+//# sourceMappingURL=n4m.js.map

package/dist/nodeRegistry/n4m.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nirs4all-ui",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Shared React UI components, visual assets, and pure view-model helpers for nirs4all apps.",
   "type": "module",
   "license": "(CECILL-2.1 OR AGPL-3.0-or-later)",
@@ -49,6 +49,10 @@
       "types": "./dist/keywordRegistry/index.d.ts",
       "import": "./dist/keywordRegistry/index.js"
     },
+    "./nodeRegistry": {
+      "types": "./dist/nodeRegistry/index.d.ts",
+      "import": "./dist/nodeRegistry/index.js"
+    },
     "./tuning": {
       "types": "./dist/tuning/index.d.ts",
       "import": "./dist/tuning/index.js"