@adcops/autocore-react 3.3.57 → 3.3.59

package/dist/components/index.d.ts

@@ -2,6 +2,10 @@ export { TisProvider, TisContext, useTis, useTisSchemas, useTisState, useTisSele
 export type { TisProviderProps, TisContextValue, TisLiveState, TisSelection, TisSelectionPatch, TisRunCacheEntry, SchemaRegistry, TisMethodSchema, } from './tis/TisProvider';
 export { TestSetupForm } from './tis/TestSetupForm';
 export type { TestSetupFormProps } from './tis/TestSetupForm';
+export { ProjectInfoDialog } from './tis/ProjectInfoDialog';
+export type { ProjectInfoDialogProps, ProjectInfoMode } from './tis/ProjectInfoDialog';
+export { TestMethodDialog } from './tis/TestMethodDialog';
+export type { TestMethodDialogProps } from './tis/TestMethodDialog';
 export { ResultHistoryTable } from './tis/ResultHistoryTable';
 export type { ResultHistoryTableProps } from './tis/ResultHistoryTable';
 export { TestDataView } from './tis/TestDataView';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,SAAS,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAY,qBAAqB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAO,0BAA0B,CAAC;AAC/D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAa,oBAAoB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7G,OAAO,EAAE,eAAe,EAAE,MAAU,uBAAuB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,SAAS,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAY,qBAAqB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAQ,yBAAyB,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAS,wBAAwB,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAO,0BAA0B,CAAC;AAC/D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAa,oBAAoB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7G,OAAO,EAAE,eAAe,EAAE,MAAU,uBAAuB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/index.js

@@ -1 +1 @@
-export{TisProvider,TisContext,useTis,useTisSchemas,useTisState,useTisSelection,useTisRuns,useTisRun}from"./tis/TisProvider";export{TestSetupForm}from"./tis/TestSetupForm";export{ResultHistoryTable}from"./tis/ResultHistoryTable";export{TestDataView}from"./tis/TestDataView";export{TestRawDataView}from"./tis/TestRawDataView";
+export{TisProvider,TisContext,useTis,useTisSchemas,useTisState,useTisSelection,useTisRuns,useTisRun}from"./tis/TisProvider";export{TestSetupForm}from"./tis/TestSetupForm";export{ProjectInfoDialog}from"./tis/ProjectInfoDialog";export{TestMethodDialog}from"./tis/TestMethodDialog";export{ResultHistoryTable}from"./tis/ResultHistoryTable";export{TestDataView}from"./tis/TestDataView";export{TestRawDataView}from"./tis/TestRawDataView";

package/dist/components/tis/ProjectInfoDialog.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { TestFieldDef } from './TestSetupForm';
+export type ProjectInfoMode = 'create' | 'edit';
+export interface ProjectInfoDialogProps {
+    visible: boolean;
+    onHide: () => void;
+    mode: ProjectInfoMode;
+    /** Project ID being created (`create` mode) or edited (`edit`). */
+    projectId: string;
+    /** Schema field defs for `project_fields` (from the selected method). */
+    projectFields: TestFieldDef[];
+    /**
+     * Called after a successful create/update with the values that
+     * landed on the server. Used by the parent form to refresh its
+     * known-projects list and to fold the new fields into subsequent
+     * `tis.stage_test` payloads without an extra round-trip.
+     */
+    onSubmitted: (projectId: string, projectFields: Record<string, any>) => void;
+}
+export declare const ProjectInfoDialog: React.FC<ProjectInfoDialogProps>;
+//# sourceMappingURL=ProjectInfoDialog.d.ts.map

package/dist/components/tis/ProjectInfoDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectInfoDialog.d.ts","sourceRoot":"","sources":["../../../src/components/tis/ProjectInfoDialog.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAShF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,eAAe,CAAC;IACtB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CAChF;AAUD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA+O9D,CAAC"}

package/dist/components/tis/ProjectInfoDialog.js

@@ -0,0 +1 @@
+import{jsx as _jsx,Fragment as _Fragment,jsxs as _jsxs}from"react/jsx-runtime";import React,{useContext,useEffect,useMemo,useRef,useState}from"react";import{Button}from"primereact/button";import{Dialog}from"primereact/dialog";import{Tooltip}from"primereact/tooltip";import{EventEmitterContext}from"../../core/EventEmitterContext";import{AutoCoreTagContext}from"../../core/AutoCoreTagContext";import{MessageType}from"../../hub/CommandMessage";import{ValueInput}from"../ValueInput";import{TextInput}from"../TextInput";const labelOf=e=>{const t=e.label&&e.label.length>0?e.label:e.name;return e.units?`${t} [${e.units}]`:t},hasDescription=e=>"string"==typeof e.description&&e.description.length>0;export const ProjectInfoDialog=({visible:e,onHide:t,mode:r,projectId:o,projectFields:n,onSubmitted:s})=>{const{invoke:i,write:a}=useContext(EventEmitterContext),{rawValues:c,findTagByFqdn:l}=useContext(AutoCoreTagContext),[m,p]=useState({}),[u,d]=useState(!1),[f,j]=useState(null),x=useRef("");useEffect(()=>{if(!e)return;const t=`${r}:${o}`;if(x.current===t)return;x.current=t;let s=!1;j(null);const a={};for(const e of n){if(!e.source)continue;const t=l(e.source);if(!t)continue;const r=c[t.tagName];null!=r&&(a[e.name]=r)}return"create"===r?s||p(a):(async()=>{try{const e=await i("tis.read_project",MessageType.Request,{project_id:o});if(s)return;if(e?.success){const t={...e.data?.project_fields??{}};for(const e of n)e.source&&void 0!==a[e.name]&&(t[e.name]=a[e.name]);p(t)}else j(e?.error_message??"Failed to read project")}catch(e){s||j(String(e instanceof Error?e.message:e))}})(),()=>{s=!0}},[e,o,r]),useEffect(()=>{e||(x.current="")},[e]);const g=(e,t)=>{p(r=>({...r,[e.name]:t}))},h=useMemo(()=>{for(const e of n){if(!e.required)continue;const t=m[e.name];if(null==t||""===t)return!1}return!0},[n,m]),_=_jsxs("div",{style:{display:"flex",justifyContent:"flex-end",gap:"0.5rem"},children:[_jsx(Button,{label:"Cancel",icon:"pi pi-times",onClick:t,disabled:u,text:!0}),_jsx(Button,{label:"create"===r?"Create Project":"Save",icon:u?"pi pi-spin pi-spinner":"create"===r?"pi pi-plus":"pi pi-check",onClick:async()=>{if(h&&!u){d(!0);try{for(const e of n){if(!e.source)continue;const t=m[e.name];if(null!=t)try{await a(e.source,t)}catch(e){}}const e={};for(const t of n)void 0!==m[t.name]&&(e[t.name]=m[t.name]);const c="create"===r?"tis.create_project":"tis.update_project",l=await i(c,MessageType.Request,{project_id:o,project_fields:e});l?.success?(s(o,e),t()):alert(`Failed: ${l?.error_message??"unknown error"}`)}catch(e){alert(`Failed: ${e instanceof Error?e.message:String(e)}`)}finally{d(!1)}}},disabled:!h||u})]});return _jsxs(Dialog,{header:"create"===r?`Create project: ${o||"(no ID)"}`:`Edit project information: ${o}`,visible:e,onHide:t,footer:_,modal:!0,style:{width:"min(640px, 90vw)"},closable:!u,children:[f&&_jsx("div",{style:{color:"var(--red-500)",marginBottom:"1rem"},children:f}),0===n.length?_jsx("p",{style:{color:"var(--text-secondary-color)"},children:"create"===r?`Click "Create Project" to create the empty project "${o}". This method declares no project_fields, so there's nothing to fill in.`:"This method declares no project_fields, so there's nothing to edit."}):_jsx("div",{className:"ac-form-grid",style:{padding:"0.25rem 0",gridTemplateColumns:"auto 1fr 1.75rem 1.75rem"},children:n.map(e=>{const t=(e=>{if(!e.required)return!0;const t=m[e.name];return null!=t&&""!==t})(e),r="string"!==e.type&&"bool"!==e.type,o=`acProjInfo_${e.name}`;return _jsxs(React.Fragment,{children:[_jsx("span",{className:"ac-form-label",children:labelOf(e)}),r?_jsx(ValueInput,{label:void 0,value:null!=m[e.name]?Number(m[e.name]):null,onValueChanged:t=>g(e,t),className:t?"":"p-invalid"}):_jsx(TextInput,{label:void 0,value:null!=m[e.name]?String(m[e.name]):"",onValueChanged:t=>g(e,t),className:t?"":"p-invalid"}),hasDescription(e)?_jsxs(_Fragment,{children:[_jsx(Tooltip,{target:`#${o}`,position:"left"}),_jsx("span",{id:o,"data-pr-tooltip":e.description,style:{display:"inline-flex",alignItems:"center",justifyContent:"center",cursor:"help"},children:_jsx("i",{className:"pi pi-info-circle",style:{color:"var(--text-secondary-color)"}})})]}):_jsx("span",{"aria-hidden":"true"}),_jsx("span",{style:{color:t?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:t?"pi pi-check":"pi pi-times"})})]},e.name)})})]})};

package/dist/components/tis/TestDataView.d.ts

@@ -39,6 +39,10 @@ export interface TestMethod {
     views?: {
         [name: string]: ChartView;
     };
+    /** Optional pretty label for the Test Method picker. */
+    label?: string;
+    /** Optional long-form description for the picker. */
+    description?: string;
 }
 export interface TestDataViewProps {
     /** Optional override; defaults to `useTisSelection().projectId`. */

package/dist/components/tis/TestDataView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestDataView.d.ts","sourceRoot":"","sources":["../../../src/components/tis/TestDataView.tsx"],"names":[],"mappings":"AAUA,OAAO,KAA2D,MAAM,OAAO,CAAC;AA6BhF,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IAAI,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AAChF,MAAM,WAAW,WAAW;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAAE;AAC5G,MAAM,WAAW,SAAS;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IACpC,CAAC,EAAE,SAAS,CAAC;IACb,CAAC,EAAE,WAAW,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC;AACD,MAAM,WAAW,UAAU;IACvB,cAAc,EAAG,YAAY,EAAE,CAAC;IAChC,aAAa,EAAI,YAAY,EAAE,CAAC;IAChC,YAAY,EAAK,YAAY,EAAE,CAAC;IAChC,cAAc,EAAG,YAAY,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAQ,YAAY,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAW;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAC9B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAG,MAAM,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAK,UAAU,CAAC;IACvB,8EAA8E;IAC9E,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAgPpD,CAAC"}
+{"version":3,"file":"TestDataView.d.ts","sourceRoot":"","sources":["../../../src/components/tis/TestDataView.tsx"],"names":[],"mappings":"AAUA,OAAO,KAA2D,MAAM,OAAO,CAAC;AA6BhF,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IAAI,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AAChF,MAAM,WAAW,WAAW;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAAE;AAC5G,MAAM,WAAW,SAAS;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IACpC,CAAC,EAAE,SAAS,CAAC;IACb,CAAC,EAAE,WAAW,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC;AACD,MAAM,WAAW,UAAU;IACvB,cAAc,EAAG,YAAY,EAAE,CAAC;IAChC,aAAa,EAAI,YAAY,EAAE,CAAC;IAChC,YAAY,EAAK,YAAY,EAAE,CAAC;IAChC,cAAc,EAAG,YAAY,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAQ,YAAY,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAW;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC/C,wDAAwD;IACxD,KAAK,CAAC,EAAW,MAAM,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAK,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAC9B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAG,MAAM,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAK,UAAU,CAAC;IACvB,8EAA8E;IAC9E,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAgPpD,CAAC"}

package/dist/components/tis/TestMethodDialog.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+export interface TestMethodDialogProps {
+    visible: boolean;
+    onHide: () => void;
+    /** Method ID currently selected on the form. The dropdown opens
+     *  pointing at this value so the dialog reflects current state. */
+    currentMethodId: string;
+    /**
+     * Called with the chosen method_id when the operator clicks OK.
+     * Cancel does not fire this callback. The parent is responsible
+     * for actually applying the new selection (e.g., updating the
+     * provider's selection or local state).
+     */
+    onSelected: (methodId: string) => void;
+}
+export declare const TestMethodDialog: React.FC<TestMethodDialogProps>;
+//# sourceMappingURL=TestMethodDialog.d.ts.map

package/dist/components/tis/TestMethodDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestMethodDialog.d.ts","sourceRoot":"","sources":["../../../src/components/tis/TestMethodDialog.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAO5D,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;uEACmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAOD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsG5D,CAAC"}

package/dist/components/tis/TestMethodDialog.js

@@ -0,0 +1 @@
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useEffect,useMemo,useState}from"react";import{Button}from"primereact/button";import{Dialog}from"primereact/dialog";import{Dropdown}from"primereact/dropdown";import{useTisSchemas}from"./TisProvider";const methodLabelOf=(e,t)=>t?.label&&t.label.length>0?t.label:e;export const TestMethodDialog=({visible:e,onHide:t,currentMethodId:o,onSelected:r})=>{const s=useTisSchemas(),[l,i]=useState(o);useEffect(()=>{e&&i(o)},[e,o]);const d=useMemo(()=>Object.keys(s).map(e=>({label:methodLabelOf(e,s[e]),value:e})),[s]),a=s[l],n=a?.description&&a.description.length>0?a.description:null,c=_jsxs("div",{style:{display:"flex",justifyContent:"flex-end",gap:"0.5rem"},children:[_jsx(Button,{label:"Cancel",icon:"pi pi-times",onClick:t,text:!0}),_jsx(Button,{label:"OK",icon:"pi pi-check",onClick:()=>{l&&l!==o&&r(l),t()},disabled:!l})]});return _jsx(Dialog,{header:"Select Test Method",visible:e,onHide:t,footer:c,modal:!0,style:{width:"min(560px, 90vw)"},children:0===d.length?_jsxs("p",{style:{color:"var(--text-secondary-color)"},children:["No test methods are declared in this project's ",_jsx("code",{children:"test_methods"})," block."]}):_jsxs("div",{style:{display:"flex",flexDirection:"column",gap:"1rem"},children:[_jsxs("div",{style:{display:"flex",alignItems:"center",gap:"0.75rem"},children:[_jsx("label",{htmlFor:"acTestMethodDropdown",style:{flexShrink:0},children:"Test Method:"}),_jsx(Dropdown,{inputId:"acTestMethodDropdown",value:l,options:d,onChange:e=>i(e.value),placeholder:"Select a method",style:{flex:1}})]}),_jsx("div",{style:{padding:"0.75rem 1rem",background:"var(--surface-100)",borderRadius:"6px",minHeight:"4.5rem",color:n?"var(--text-color)":"var(--text-secondary-color)",fontStyle:n?"normal":"italic",whiteSpace:"pre-wrap"},children:n??"No description provided for this test method."})]})})};

package/dist/components/tis/TestSetupForm.d.ts

@@ -1,27 +1,32 @@
 import React from 'react';
 export interface TestFieldDef {
+    /** Canonical key — wire format, generated code, on-disk JSON. */
     name: string;
     type: string;
     units?: string;
     required?: boolean;
     source?: string;
+    /** Pretty label rendered by the form. Falls back to `name`. Units
+     *  are appended automatically; don't pre-format `[mm]` into label. */
+    label?: string;
+    /** Long-form guidance surfaced as a hover tooltip on an info icon. */
+    description?: string;
 }
 export interface TestMethod {
     project_fields: TestFieldDef[];
     config_fields: TestFieldDef[];
     cycle_fields: TestFieldDef[];
     results_fields: TestFieldDef[];
+    /** Optional pretty label for the Test Method picker. Falls back
+     *  to the canonical method_id key. */
+    label?: string;
+    /** Optional long-form description shown in the picker dialog
+     *  when this method is highlighted. */
+    description?: string;
 }
 /**
  * Props are all optional overrides — by default the form drives itself
- * from the surrounding `<TisProvider>`. Pass any of these to lock that
- * particular axis.
- *
- * - `schema`: bypass `useTisSchemas()` for the selected method.
- * - `defaultProjectId` / `defaultMethodId`: seed the form's local
- *    state when the corresponding TIS-context fields are blank.
- * - `onProjectChange` / `onMethodChange` / `onValidationChange`:
- *    receive callbacks in addition to the provider's selection state.
+ * from the surrounding `<TisProvider>`.
  */
 export interface TestSetupFormProps {
     schema?: TestMethod;

package/dist/components/tis/TestSetupForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestSetupForm.d.ts","sourceRoot":"","sources":["../../../src/components/tis/TestSetupForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAWxE,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,cAAc,EAAE,YAAY,EAAE,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAChE;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2QtD,CAAC"}
+{"version":3,"file":"TestSetupForm.d.ts","sourceRoot":"","sources":["../../../src/components/tis/TestSetupForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAehF,MAAM,WAAW,YAAY;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;0EACsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B;0CACsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;2CACuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAChE;AA4BD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAsdtD,CAAC"}

package/dist/components/tis/TestSetupForm.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import React,{useState,useEffect,useContext,useMemo}from"react";import{AutoComplete}from"primereact/autocomplete";import{SelectButton}from"primereact/selectbutton";import{EventEmitterContext}from"../../core/EventEmitterContext";import{AutoCoreTagContext}from"../../core/AutoCoreTagContext";import{MessageType}from"../../hub/CommandMessage";import{ValueInput}from"../ValueInput";import{TextInput}from"../TextInput";import{useTis}from"./TisProvider";export const TestSetupForm=({schema:e,defaultProjectId:t,defaultMethodId:s,onProjectChange:a,onMethodChange:n,onValidationChange:o})=>{const r=useTis(),{invoke:i,write:c}=useContext(EventEmitterContext),{rawValues:l,findTagByFqdn:m}=useContext(AutoCoreTagContext),d=useMemo(()=>Object.keys(r.schemas),[r.schemas]),[p,u]=useState(r.selection.projectId||t||""),[f,h]=useState(r.selection.methodId||s||r.defaultMethodId||""),[x,g]=useState(""),[j,_]=useState({}),v=e??(f?r.schemas[f]:void 0);useEffect(()=>{r.selection.projectId!==p&&r.setSelection({projectId:p}),a&&a(p)},[p]),useEffect(()=>{r.selection.methodId!==f&&f&&r.setSelection({methodId:f}),n&&n(f)},[f]),useEffect(()=>{r.selection.sampleId!==x&&r.setSelection({sampleId:x})},[x]),useEffect(()=>{r.state.stagedSampleId&&r.state.stagedSampleId!==x&&g(r.state.stagedSampleId)},[r.state.stagedSampleId]);const[I,C]=useState([]),[y,N]=useState([]),[S,T]=useState(!1);useEffect(()=>{if(!v)return;const e=[...v.project_fields,...v.config_fields];_(t=>{let s=t;for(const a of e){if("sample_id"===a.name)continue;if(!a.source)continue;const e=m(a.source);if(!e)continue;const n=l[e.tagName];null!=n&&(s[a.name]!==n&&(s===t&&(s={...t}),s[a.name]=n))}return s})},[v,l,m]),useEffect(()=>{(async()=>{try{const e=await i("tis.list_projects",MessageType.Request,{});e.success&&e.data&&e.data.projects&&C(e.data.projects)}catch(e){}})()},[i]);useEffect(()=>{if(!v)return void T(!1);let e=!0;p.trim()||(e=!1),f.trim()||(e=!1),x.trim()||(e=!1);const t=[...v.project_fields,...v.config_fields];for(const s of t)if("sample_id"!==s.name&&s.required){const t=j[s.name];if(void 0===t||""===t||null===t){e=!1;break}}if(T(e),o&&o(e,j),e){const{sample_id:e,...t}=j??{};i("tis.stage_test",MessageType.Request,{project_id:p,method_id:f,sample_id:x,config:t}).catch(e=>{})}},[j,v,p,f,x,o,i]);const E=async(e,t)=>{if(_({...j,[e.name]:t}),e.source)try{await c(e.source,t)}catch(e){}},b=e=>{if("sample_id"===e.name)return null;const t=(e=>{if(!e.required)return!0;const t=j[e.name];return void 0!==t&&""!==t&&null!==t})(e),s="string"!==e.type&&"bool"!==e.type;return _jsxs(React.Fragment,{children:[_jsx("span",{className:"ac-form-label",children:e.name}),s?_jsx(ValueInput,{label:void 0,value:null!=j[e.name]?Number(j[e.name]):null,onValueChanged:t=>E(e,t),className:t?"":"p-invalid"}):_jsx(TextInput,{label:void 0,value:null!=j[e.name]?String(j[e.name]):"",onValueChanged:t=>E(e,t),className:t?"":"p-invalid"}),_jsx("span",{className:"ac-form-units",children:e.units??""}),_jsx("span",{style:{color:t?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:t?"pi pi-check":"pi pi-times"})})]},e.name)};return v?_jsxs("div",{className:"ac-form-grid",style:{padding:"1.25rem"},children:[_jsxs("h3",{className:"ac-form-section",style:{display:"flex",alignItems:"center",gap:"10px"},children:["Project & Method",_jsx("span",{style:{color:S?"var(--green-500)":"var(--red-500)"},children:_jsx("i",{className:S?"pi pi-check-circle":"pi pi-exclamation-circle"})})]}),_jsx("span",{className:"ac-form-label",children:"Project ID"}),_jsx(AutoComplete,{value:p,suggestions:y,completeMethod:e=>{const t=e.query.toLowerCase();N(I.filter(e=>e.toLowerCase().includes(t)))},onChange:e=>(e=>{const t=(e||"").replace(/[^a-zA-Z0-9_]/g,"");u(t)})(e.value),dropdown:!0,placeholder:"Enter or select Project ID",className:p.trim()?"":"p-invalid"}),_jsx("span",{}),_jsx("span",{style:{color:p.trim()?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:p.trim()?"pi pi-check":"pi pi-times"})}),_jsx("span",{className:"ac-form-label",children:"Sample ID"}),_jsx(TextInput,{label:void 0,value:x,onValueChanged:e=>{g(e)},className:x.trim()?"":"p-invalid"}),_jsx("span",{}),_jsx("span",{style:{color:x.trim()?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:x.trim()?"pi pi-check":"pi pi-times"})}),d.length>1&&_jsxs(_Fragment,{children:[_jsx("span",{className:"ac-form-label",children:"Test Method"}),_jsx(SelectButton,{value:f,options:d.map(e=>({label:e,value:e})),onChange:e=>e.value&&h(e.value)}),_jsx("span",{}),_jsx("span",{})]}),_jsx("h3",{className:"ac-form-section",style:{marginTop:"1rem"},children:"Project Information"}),v.project_fields.map(b),_jsx("h3",{className:"ac-form-section",style:{marginTop:"1rem"},children:"Test Configuration"}),v.config_fields.map(b)]}):_jsx("div",{className:"ac-form-grid",style:{padding:"1.25rem"},children:_jsx("h3",{className:"ac-form-section",children:r.schemasLoaded?"No Test Method Selected":"Loading test methods…"})})};
+import{jsx as _jsx,Fragment as _Fragment,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useEffect,useContext,useMemo,useRef}from"react";import{AutoComplete}from"primereact/autocomplete";import{Button}from"primereact/button";import{InputText}from"primereact/inputtext";import{Tooltip}from"primereact/tooltip";import{EventEmitterContext}from"../../core/EventEmitterContext";import{AutoCoreTagContext}from"../../core/AutoCoreTagContext";import{MessageType}from"../../hub/CommandMessage";import{ValueInput}from"../ValueInput";import{TextInput}from"../TextInput";import{useTis}from"./TisProvider";import{ProjectInfoDialog}from"./ProjectInfoDialog";import{TestMethodDialog}from"./TestMethodDialog";const labelOf=e=>{const t=e.label&&e.label.length>0?e.label:e.name;return e.units?`${t} [${e.units}]`:t},hasDescription=e=>"string"==typeof e.description&&e.description.length>0,methodLabelOf=(e,t)=>t?.label&&t.label.length>0?t.label:e,PROJECT_ID_RE=/^[A-Za-z0-9_-]+$/,isValidProjectIdFormat=e=>PROJECT_ID_RE.test(e);export const TestSetupForm=({schema:e,defaultProjectId:t,defaultMethodId:s,onProjectChange:i,onMethodChange:o,onValidationChange:a})=>{const r=useTis(),{invoke:n,write:l}=useContext(EventEmitterContext),{rawValues:c,findTagByFqdn:d}=useContext(AutoCoreTagContext),p=useMemo(()=>Object.keys(r.schemas),[r.schemas]),[m,u]=useState(r.selection.projectId||t||""),[f,h]=useState(r.selection.methodId||s||r.defaultMethodId||""),[x,j]=useState(""),[g,_]=useState({}),y=e??(f?r.schemas[f]:void 0);useEffect(()=>{r.selection.projectId!==m&&r.setSelection({projectId:m}),i&&i(m)},[m]),useEffect(()=>{r.selection.methodId!==f&&f&&r.setSelection({methodId:f}),o&&o(f)},[f]),useEffect(()=>{r.selection.sampleId!==x&&r.setSelection({sampleId:x})},[x]),useEffect(()=>{r.state.stagedSampleId&&r.state.stagedSampleId!==x&&j(r.state.stagedSampleId)},[r.state.stagedSampleId]);const[I,v]=useState([]),[b,C]=useState([]),S=useRef(new Set),[T,N]=useState(0),[E,M]=useState(!1),[D,P]=useState({}),k=D[m]??{},[w,F]=useState(!1),[O,R]=useState(!1),[V,q]=useState(!1),A=async()=>{try{const e=await n("tis.list_projects",MessageType.Request,{});e.success&&e.data&&e.data.projects&&v(e.data.projects)}catch(e){}};useEffect(()=>{A()},[n]);const L=useMemo(()=>{const e=new Set(I);for(const t of S.current)e.add(t);return e},[I,T]),$=""!==m.trim()&&L.has(m.trim()),B=isValidProjectIdFormat(m.trim()),H=""!==m.trim()&&B&&!L.has(m.trim());useEffect(()=>{const e=m.trim();if(!e||!$)return;if(void 0!==D[e])return;let t=!1;return(async()=>{try{const s=await n("tis.read_project",MessageType.Request,{project_id:e});if(t)return;if(s?.success){const t=s.data?.project_fields??{};P(s=>({...s,[e]:t}))}}catch(e){}})(),()=>{t=!0}},[m,$]),useEffect(()=>{y&&_(e=>{let t=e;for(const s of y.config_fields){if("sample_id"===s.name)continue;if(!s.source)continue;const i=d(s.source);if(!i)continue;const o=c[i.tagName];null!=o&&(t[s.name]!==o&&(t===e&&(t={...e}),t[s.name]=o))}return t})},[y,c,d]);useEffect(()=>{if(!y)return void M(!1);let e=!0;$||(e=!1),f.trim()||(e=!1),x.trim()||(e=!1);for(const t of y.config_fields)if("sample_id"!==t.name&&t.required){const s=g[t.name];if(void 0===s||""===s||null===s){e=!1;break}}if(e&&$&&void 0===D[m.trim()]&&(e=!1),M(e),a&&a(e,g),e){const{sample_id:e,...t}=g??{},s={...k,...t};n("tis.stage_test",MessageType.Request,{project_id:m,method_id:f,sample_id:x,config:s}).catch(e=>{})}},[g,y,m,f,x,$,D,a,n]);const z=async(e,t)=>{if(_({...g,[e.name]:t}),e.source)try{await l(e.source,t)}catch(e){}},J=(e,t)=>{S.current.add(e),N(e=>e+1),P(s=>({...s,[e]:t})),A(),m.trim()!==e&&u(e)};if(!y)return _jsx("div",{className:"ac-form-grid",style:{padding:"1.25rem"},children:_jsx("h3",{className:"ac-form-section",children:r.schemasLoaded?"No Test Method Selected":"Loading test methods…"})});const Z=$;return _jsxs("div",{className:"ac-form-grid",style:{padding:"1.25rem",gridTemplateColumns:"auto 1fr 1.75rem 1.75rem"},children:[_jsxs("h3",{className:"ac-form-section",style:{display:"flex",alignItems:"center",gap:"10px"},children:["Project & Method",_jsx("span",{style:{color:E?"var(--green-500)":"var(--red-500)"},children:_jsx("i",{className:E?"pi pi-check-circle":"pi pi-exclamation-circle"})})]}),_jsx("span",{className:"ac-form-label",children:"Project ID"}),_jsxs("div",{className:"p-inputgroup",style:{flex:1},children:[_jsx(AutoComplete,{value:m,suggestions:b,completeMethod:e=>{const t=e.query.toLowerCase();C(I.filter(e=>e.toLowerCase().includes(t)))},onChange:e=>(e=>{const t=(e||"").replace(/[^a-zA-Z0-9_-]/g,"");u(t)})(e.value),dropdown:!0,placeholder:"Select an existing Project ID, or type a new one and click +",className:Z?"":"p-invalid",style:{flex:1}}),_jsx(Button,{icon:"pi pi-plus",type:"button",onClick:()=>F(!0),disabled:!H,tooltip:m.trim()?B?L.has(m.trim())?"Project already exists":`Create project "${m.trim()}"`:"Letters, digits, _ and - only":"Type a project ID first",tooltipOptions:{position:"top"}}),_jsx(Button,{icon:"pi pi-pencil",type:"button",onClick:()=>R(!0),disabled:!$,tooltip:$?`Edit information for "${m.trim()}"`:"Select an existing project to edit",tooltipOptions:{position:"top"}})]}),_jsx("span",{"aria-hidden":"true"}),_jsx("span",{style:{color:Z?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:Z?"pi pi-check":"pi pi-times"})}),_jsx("span",{className:"ac-form-label",children:"Sample ID"}),_jsx(TextInput,{label:void 0,value:x,onValueChanged:e=>{j(e)},className:x.trim()?"":"p-invalid"}),_jsx("span",{"aria-hidden":"true"}),_jsx("span",{style:{color:x.trim()?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:x.trim()?"pi pi-check":"pi pi-times"})}),p.length>0&&_jsxs(_Fragment,{children:[_jsx("span",{className:"ac-form-label",children:"Test Method"}),_jsxs("div",{className:"p-inputgroup",style:{flex:1},children:[_jsx(InputText,{value:methodLabelOf(f,y),readOnly:!0,style:{flex:1},tabIndex:-1}),_jsx(Button,{icon:"pi pi-pencil",type:"button",onClick:()=>q(!0),tooltip:p.length>1?"Change test method":"View test method details",tooltipOptions:{position:"top"}})]}),_jsx("span",{"aria-hidden":"true"}),_jsx("span",{style:{color:f?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:f?"pi pi-check":"pi pi-times"})})]}),_jsx("h3",{className:"ac-form-section",style:{marginTop:"1rem"},children:"Test Configuration"}),y.config_fields.map(e=>{if("sample_id"===e.name)return null;const t=(e=>{if(!e.required)return!0;const t=g[e.name];return void 0!==t&&""!==t&&null!==t})(e),s="string"!==e.type&&"bool"!==e.type,i=`acFormInfo_${e.name}`;return _jsxs(React.Fragment,{children:[_jsx("span",{className:"ac-form-label",children:labelOf(e)}),s?_jsx(ValueInput,{label:void 0,value:null!=g[e.name]?Number(g[e.name]):null,onValueChanged:t=>z(e,t),className:t?"":"p-invalid"}):_jsx(TextInput,{label:void 0,value:null!=g[e.name]?String(g[e.name]):"",onValueChanged:t=>z(e,t),className:t?"":"p-invalid"}),hasDescription(e)?_jsxs(_Fragment,{children:[_jsx(Tooltip,{target:`#${i}`,position:"left"}),_jsx("span",{id:i,"data-pr-tooltip":e.description,style:{display:"inline-flex",alignItems:"center",justifyContent:"center",cursor:"help"},children:_jsx("i",{className:"pi pi-info-circle",style:{color:"var(--text-secondary-color)"}})})]}):_jsx("span",{"aria-hidden":"true"}),_jsx("span",{style:{color:t?"var(--green-500)":"var(--red-500)",display:"flex",alignItems:"center"},children:_jsx("i",{className:t?"pi pi-check":"pi pi-times"})})]},e.name)}),_jsx(ProjectInfoDialog,{visible:w,onHide:()=>F(!1),mode:"create",projectId:m.trim(),projectFields:y.project_fields,onSubmitted:J}),_jsx(ProjectInfoDialog,{visible:O,onHide:()=>R(!1),mode:"edit",projectId:m.trim(),projectFields:y.project_fields,onSubmitted:J}),_jsx(TestMethodDialog,{visible:V,onHide:()=>q(!1),currentMethodId:f,onSelected:e=>h(e)})]})};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adcops/autocore-react",
-    "version": "3.3.57",
+    "version": "3.3.59",
     "description": "A React component library for industrial user interfaces.",
     "private": false,
     "type": "module",

package/src/components/index.ts

@@ -30,6 +30,12 @@ export type {
 export { TestSetupForm }       from './tis/TestSetupForm';
 export type { TestSetupFormProps } from './tis/TestSetupForm';
 
+export { ProjectInfoDialog }   from './tis/ProjectInfoDialog';
+export type { ProjectInfoDialogProps, ProjectInfoMode } from './tis/ProjectInfoDialog';
+
+export { TestMethodDialog }    from './tis/TestMethodDialog';
+export type { TestMethodDialogProps } from './tis/TestMethodDialog';
+
 export { ResultHistoryTable }  from './tis/ResultHistoryTable';
 export type { ResultHistoryTableProps } from './tis/ResultHistoryTable';
 

package/src/components/tis/ProjectInfoDialog.tsx

@@ -0,0 +1,307 @@
+/*
+ * Copyright (C) 2026 Automated Design Corp. All Rights Reserved.
+ *
+ * <ProjectInfoDialog> — operator-facing setup for a project's
+ * `project_fields`. Used in two modes:
+ *
+ *   - `create`: opened by the `+` button on <TestSetupForm>. The
+ *     project doesn't exist yet; on submit we call `tis.create_project`
+ *     with the user-entered fields baked into the request payload, so
+ *     the directory and project.json materialise atomically. The form
+ *     pre-fills source-bound fields from live GM values via the
+ *     surrounding AutoCoreTagProvider so the operator isn't typing
+ *     things the rig already knows.
+ *
+ *   - `edit`: opened by the pencil button on <TestSetupForm>. The
+ *     project already exists; we fetch project.json via
+ *     `tis.read_project` and pre-fill from it, with source-bound
+ *     fields preferring the live GM value over the persisted one (so
+ *     "edit" reflects current reality). On submit we
+ *     `tis.update_project` and `write()` source-bound fields back to
+ *     GM in the same pass.
+ *
+ * The dialog never stages or starts a test — it only manages
+ * project-level metadata. The future per-user permission gate that
+ * locks "create/edit project" away from the operator role hangs off
+ * the visibility of the two buttons in <TestSetupForm>; this dialog
+ * is agnostic to who opened it.
+ */
+
+import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { Button } from 'primereact/button';
+import { Dialog } from 'primereact/dialog';
+import { Tooltip } from 'primereact/tooltip';
+import { EventEmitterContext } from '../../core/EventEmitterContext';
+import { AutoCoreTagContext } from '../../core/AutoCoreTagContext';
+import { MessageType } from '../../hub/CommandMessage';
+import { ValueInput } from '../ValueInput';
+import { TextInput } from '../TextInput';
+import type { TestFieldDef } from './TestSetupForm';
+
+export type ProjectInfoMode = 'create' | 'edit';
+
+export interface ProjectInfoDialogProps {
+    visible: boolean;
+    onHide: () => void;
+    mode: ProjectInfoMode;
+    /** Project ID being created (`create` mode) or edited (`edit`). */
+    projectId: string;
+    /** Schema field defs for `project_fields` (from the selected method). */
+    projectFields: TestFieldDef[];
+    /**
+     * Called after a successful create/update with the values that
+     * landed on the server. Used by the parent form to refresh its
+     * known-projects list and to fold the new fields into subsequent
+     * `tis.stage_test` payloads without an extra round-trip.
+     */
+    onSubmitted: (projectId: string, projectFields: Record<string, any>) => void;
+}
+
+const labelOf = (f: TestFieldDef): string => {
+    const base = f.label && f.label.length > 0 ? f.label : f.name;
+    return f.units ? `${base} [${f.units}]` : base;
+};
+
+const hasDescription = (f: TestFieldDef): boolean =>
+    typeof f.description === 'string' && f.description.length > 0;
+
+export const ProjectInfoDialog: React.FC<ProjectInfoDialogProps> = ({
+    visible, onHide, mode, projectId, projectFields, onSubmitted,
+}) => {
+    const { invoke, write } = useContext(EventEmitterContext);
+    const { rawValues, findTagByFqdn } = useContext(AutoCoreTagContext);
+
+    const [values, setValues] = useState<Record<string, any>>({});
+    const [submitting, setSubmitting] = useState(false);
+    const [loadError, setLoadError] = useState<string | null>(null);
+    const lastLoadedIdRef = useRef<string>('');
+
+    // Whenever the dialog opens (or the target project changes while
+    // open), reset state and re-load. We DON'T do this in a single
+    // useEffect on `[visible, projectId, mode]` because the load is
+    // async and we want to drop stale results.
+    useEffect(() => {
+        if (!visible) return;
+        const loadKey = `${mode}:${projectId}`;
+        if (lastLoadedIdRef.current === loadKey) return;
+        lastLoadedIdRef.current = loadKey;
+
+        let cancelled = false;
+        setLoadError(null);
+
+        // Build the initial value map. For source-bound fields, seed
+        // from live GM via the AutoCoreTagProvider's rawValues. For
+        // non-source fields the seed is empty in `create` mode and
+        // gets overwritten by the persisted value in `edit` mode.
+        const seed: Record<string, any> = {};
+        for (const f of projectFields) {
+            if (!f.source) continue;
+            const tag = findTagByFqdn(f.source);
+            if (!tag) continue;
+            const v = rawValues[tag.tagName];
+            if (v !== undefined && v !== null) seed[f.name] = v;
+        }
+
+        if (mode === 'create') {
+            if (!cancelled) setValues(seed);
+        } else {
+            (async () => {
+                try {
+                    const resp: any = await invoke(
+                        'tis.read_project' as any, MessageType.Request,
+                        { project_id: projectId } as any,
+                    );
+                    if (cancelled) return;
+                    if (resp?.success) {
+                        const persisted = (resp.data?.project_fields ?? {}) as Record<string, any>;
+                        // Seed (source-bound from GM) + persisted +
+                        // GM wins on conflicts for source fields,
+                        // because GM is the live source of truth.
+                        const merged: Record<string, any> = { ...persisted };
+                        for (const f of projectFields) {
+                            if (f.source && seed[f.name] !== undefined) {
+                                merged[f.name] = seed[f.name];
+                            }
+                        }
+                        setValues(merged);
+                    } else {
+                        setLoadError(resp?.error_message ?? 'Failed to read project');
+                    }
+                } catch (e) {
+                    if (!cancelled) setLoadError(String(e instanceof Error ? e.message : e));
+                }
+            })();
+        }
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [visible, projectId, mode]);
+
+    // When the dialog closes, clear the loaded-marker so a subsequent
+    // open re-fetches fresh state.
+    useEffect(() => {
+        if (!visible) lastLoadedIdRef.current = '';
+    }, [visible]);
+
+    const handleFieldChange = (field: TestFieldDef, val: any) => {
+        setValues(prev => ({ ...prev, [field.name]: val }));
+    };
+
+    // All required project_fields must be non-empty before we let the
+    // operator submit. Source-bound fields are validated the same way
+    // — they should already have a value from GM, but the dialog is
+    // honest about it if they don't.
+    const isValid = useMemo(() => {
+        for (const f of projectFields) {
+            if (!f.required) continue;
+            const v = values[f.name];
+            if (v === undefined || v === null || v === '') return false;
+        }
+        return true;
+    }, [projectFields, values]);
+
+    const handleSubmit = async () => {
+        if (!isValid || submitting) return;
+        setSubmitting(true);
+        try {
+            // For source-bound fields, push the value into GM in the
+            // same pass. We do this whether `create` or `edit` because
+            // the persisted project.json copy is just a snapshot —
+            // GM is the live source of truth and we want the rig to
+            // see the operator's changes immediately.
+            for (const f of projectFields) {
+                if (!f.source) continue;
+                const v = values[f.name];
+                if (v === undefined || v === null) continue;
+                try { await write(f.source, v); }
+                catch (e) { console.warn(`[ProjectInfoDialog] write to ${f.source} failed:`, e); }
+            }
+
+            // The persisted blob carries every project_field we
+            // present, including source-bound ones; this lets the
+            // form fold them into stage_test even if the live tag
+            // hasn't broadcast a value yet at staging time.
+            const projectFieldsPayload: Record<string, any> = {};
+            for (const f of projectFields) {
+                if (values[f.name] !== undefined) projectFieldsPayload[f.name] = values[f.name];
+            }
+
+            const topic = mode === 'create' ? 'tis.create_project' : 'tis.update_project';
+            const resp: any = await invoke(topic as any, MessageType.Request, {
+                project_id:     projectId,
+                project_fields: projectFieldsPayload,
+            } as any);
+            if (resp?.success) {
+                onSubmitted(projectId, projectFieldsPayload);
+                onHide();
+            } else {
+                alert(`Failed: ${resp?.error_message ?? 'unknown error'}`);
+            }
+        } catch (e) {
+            alert(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        } finally {
+            setSubmitting(false);
+        }
+    };
+
+    const isFieldValid = (f: TestFieldDef) => {
+        if (!f.required) return true;
+        const v = values[f.name];
+        return v !== undefined && v !== null && v !== '';
+    };
+
+    const renderField = (field: TestFieldDef) => {
+        const valid = isFieldValid(field);
+        const isNum = field.type !== 'string' && field.type !== 'bool';
+        const tooltipId = `acProjInfo_${field.name}`;
+        return (
+            <React.Fragment key={field.name}>
+                <span className="ac-form-label">{labelOf(field)}</span>
+                {isNum ? (
+                    <ValueInput
+                        label={undefined}
+                        value={values[field.name] != null ? Number(values[field.name]) : null}
+                        onValueChanged={(val) => handleFieldChange(field, val)}
+                        className={!valid ? 'p-invalid' : ''}
+                    />
+                ) : (
+                    <TextInput
+                        label={undefined}
+                        value={values[field.name] != null ? String(values[field.name]) : ''}
+                        onValueChanged={(val) => handleFieldChange(field, val)}
+                        className={!valid ? 'p-invalid' : ''}
+                    />
+                )}
+                {hasDescription(field) ? (
+                    <>
+                        <Tooltip target={`#${tooltipId}`} position="left" />
+                        <span
+                            id={tooltipId}
+                            data-pr-tooltip={field.description}
+                            style={{ display: 'inline-flex', alignItems: 'center', justifyContent: 'center', cursor: 'help' }}
+                        >
+                            <i className="pi pi-info-circle" style={{ color: 'var(--text-secondary-color)' }} />
+                        </span>
+                    </>
+                ) : (
+                    <span aria-hidden="true" />
+                )}
+                <span style={{ color: valid ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
+                    <i className={valid ? 'pi pi-check' : 'pi pi-times'} />
+                </span>
+            </React.Fragment>
+        );
+    };
+
+    const footer = (
+        <div style={{ display: 'flex', justifyContent: 'flex-end', gap: '0.5rem' }}>
+            <Button label="Cancel" icon="pi pi-times" onClick={onHide} disabled={submitting} text />
+            <Button
+                label={mode === 'create' ? 'Create Project' : 'Save'}
+                icon={submitting ? 'pi pi-spin pi-spinner' : (mode === 'create' ? 'pi pi-plus' : 'pi pi-check')}
+                onClick={handleSubmit}
+                disabled={!isValid || submitting}
+            />
+        </div>
+    );
+
+    const header = mode === 'create'
+        ? `Create project: ${projectId || '(no ID)'}`
+        : `Edit project information: ${projectId}`;
+
+    return (
+        <Dialog
+            header={header}
+            visible={visible}
+            onHide={onHide}
+            footer={footer}
+            modal
+            style={{ width: 'min(640px, 90vw)' }}
+            // PrimeReact's `closable` X — same as Cancel.
+            closable={!submitting}
+        >
+            {loadError && (
+                <div style={{ color: 'var(--red-500)', marginBottom: '1rem' }}>
+                    {loadError}
+                </div>
+            )}
+            {projectFields.length === 0 ? (
+                <p style={{ color: 'var(--text-secondary-color)' }}>
+                    {mode === 'create'
+                        ? `Click "Create Project" to create the empty project "${projectId}". `
+                        + `This method declares no project_fields, so there's nothing to fill in.`
+                        : `This method declares no project_fields, so there's nothing to edit.`}
+                </p>
+            ) : (
+                <div
+                    className="ac-form-grid"
+                    style={{
+                        padding: '0.25rem 0',
+                        gridTemplateColumns: 'auto 1fr 1.75rem 1.75rem',
+                    }}
+                >
+                    {projectFields.map(renderField)}
+                </div>
+            )}
+        </Dialog>
+    );
+};

package/src/components/tis/TestDataView.tsx

@@ -65,6 +65,10 @@ export interface TestMethod {
     results_fields:  TestFieldDef[];
     raw_data?:       RawDataShape | null;
     views?:          { [name: string]: ChartView };
+    /** Optional pretty label for the Test Method picker. */
+    label?:          string;
+    /** Optional long-form description for the picker. */
+    description?:    string;
 }
 
 export interface TestDataViewProps {

package/src/components/tis/TestMethodDialog.tsx

@@ -0,0 +1,147 @@
+/*
+ * Copyright (C) 2026 Automated Design Corp. All Rights Reserved.
+ *
+ * <TestMethodDialog> — picker UI for swapping the active test method.
+ *
+ * The main form displays a single "Test Method: <label>" row with an
+ * edit button. Clicking edit opens this dialog. The dialog shows a
+ * dropdown of every method declared in the current project's
+ * `test_methods` block, plus the long-form description for whichever
+ * method the operator has the dropdown highlighted on. OK commits the
+ * choice via the supplied callback; Cancel discards.
+ *
+ * This pattern scales past three or four methods where a SelectButton
+ * starts wrapping or eating horizontal space, and gives every method
+ * room to ship a description that disambiguates similar names.
+ */
+
+import React, { useEffect, useMemo, useState } from 'react';
+import { Button } from 'primereact/button';
+import { Dialog } from 'primereact/dialog';
+import { Dropdown } from 'primereact/dropdown';
+import type { TestMethod } from './TestSetupForm';
+import { useTisSchemas } from './TisProvider';
+
+export interface TestMethodDialogProps {
+    visible: boolean;
+    onHide: () => void;
+    /** Method ID currently selected on the form. The dropdown opens
+     *  pointing at this value so the dialog reflects current state. */
+    currentMethodId: string;
+    /**
+     * Called with the chosen method_id when the operator clicks OK.
+     * Cancel does not fire this callback. The parent is responsible
+     * for actually applying the new selection (e.g., updating the
+     * provider's selection or local state).
+     */
+    onSelected: (methodId: string) => void;
+}
+
+/** Display name for one method: prefer the schema's `label`, fall
+ *  back to the canonical `method_id` key. */
+const methodLabelOf = (methodId: string, schema: TestMethod | undefined): string =>
+    (schema?.label && schema.label.length > 0) ? schema.label : methodId;
+
+export const TestMethodDialog: React.FC<TestMethodDialogProps> = ({
+    visible, onHide, currentMethodId, onSelected,
+}) => {
+    const schemas = useTisSchemas();
+
+    // Local "draft" selection — the dropdown writes to this; OK
+    // applies it. We deliberately don't update the provider's
+    // selection on every dropdown change, so a Cancel really cancels.
+    const [draftMethodId, setDraftMethodId] = useState<string>(currentMethodId);
+
+    // Re-sync the draft whenever the dialog opens so a stale value
+    // from a previous open doesn't ghost the current selection.
+    useEffect(() => {
+        if (visible) setDraftMethodId(currentMethodId);
+    }, [visible, currentMethodId]);
+
+    const options = useMemo(() => {
+        return Object.keys(schemas).map(methodId => ({
+            label: methodLabelOf(methodId, schemas[methodId]),
+            value: methodId,
+        }));
+    }, [schemas]);
+
+    const draftSchema = schemas[draftMethodId];
+    const draftDescription =
+        (draftSchema?.description && draftSchema.description.length > 0)
+            ? draftSchema.description
+            : null;
+
+    const handleOk = () => {
+        if (draftMethodId && draftMethodId !== currentMethodId) {
+            onSelected(draftMethodId);
+        }
+        onHide();
+    };
+
+    const footer = (
+        <div style={{ display: 'flex', justifyContent: 'flex-end', gap: '0.5rem' }}>
+            <Button label="Cancel" icon="pi pi-times" onClick={onHide} text />
+            <Button
+                label="OK"
+                icon="pi pi-check"
+                onClick={handleOk}
+                disabled={!draftMethodId}
+            />
+        </div>
+    );
+
+    return (
+        <Dialog
+            header="Select Test Method"
+            visible={visible}
+            onHide={onHide}
+            footer={footer}
+            modal
+            style={{ width: 'min(560px, 90vw)' }}
+        >
+            {options.length === 0 ? (
+                <p style={{ color: 'var(--text-secondary-color)' }}>
+                    No test methods are declared in this project's <code>test_methods</code> block.
+                </p>
+            ) : (
+                <div style={{ display: 'flex', flexDirection: 'column', gap: '1rem' }}>
+                    <div style={{ display: 'flex', alignItems: 'center', gap: '0.75rem' }}>
+                        <label htmlFor="acTestMethodDropdown" style={{ flexShrink: 0 }}>
+                            Test Method:
+                        </label>
+                        <Dropdown
+                            inputId="acTestMethodDropdown"
+                            value={draftMethodId}
+                            options={options}
+                            onChange={(e) => setDraftMethodId(e.value)}
+                            placeholder="Select a method"
+                            style={{ flex: 1 }}
+                        />
+                    </div>
+                    {/*
+                     * Show the description region whenever we have a
+                     * draft selection — keeps layout stable even when
+                     * the operator picks a method without one (we just
+                     * render a muted placeholder rather than collapsing
+                     * the dialog by ~3rem).
+                     */}
+                    <div
+                        style={{
+                            padding: '0.75rem 1rem',
+                            background: 'var(--surface-100)',
+                            borderRadius: '6px',
+                            minHeight: '4.5rem',
+                            color: draftDescription
+                                ? 'var(--text-color)'
+                                : 'var(--text-secondary-color)',
+                            fontStyle: draftDescription ? 'normal' : 'italic',
+                            whiteSpace: 'pre-wrap',
+                        }}
+                    >
+                        {draftDescription ?? 'No description provided for this test method.'}
+                    </div>
+                </div>
+            )}
+        </Dialog>
+    );
+};

package/src/components/tis/TestSetupForm.tsx

@@ -1,20 +1,30 @@
-import React, { useState, useEffect, useContext, useMemo } from 'react';
+import React, { useState, useEffect, useContext, useMemo, useRef } from 'react';
 import { AutoComplete } from 'primereact/autocomplete';
 import type { AutoCompleteCompleteEvent } from 'primereact/autocomplete';
-import { SelectButton } from 'primereact/selectbutton';
+import { Button } from 'primereact/button';
+import { InputText } from 'primereact/inputtext';
+import { Tooltip } from 'primereact/tooltip';
 import { EventEmitterContext } from '../../core/EventEmitterContext';
 import { AutoCoreTagContext } from '../../core/AutoCoreTagContext';
 import { MessageType } from '../../hub/CommandMessage';
 import { ValueInput } from '../ValueInput';
 import { TextInput } from '../TextInput';
 import { useTis } from './TisProvider';
+import { ProjectInfoDialog } from './ProjectInfoDialog';
+import { TestMethodDialog } from './TestMethodDialog';
 
 export interface TestFieldDef {
+    /** Canonical key — wire format, generated code, on-disk JSON. */
     name: string;
     type: string;
     units?: string;
     required?: boolean;
     source?: string;
+    /** Pretty label rendered by the form. Falls back to `name`. Units
+     *  are appended automatically; don't pre-format `[mm]` into label. */
+    label?: string;
+    /** Long-form guidance surfaced as a hover tooltip on an info icon. */
+    description?: string;
 }
 
 export interface TestMethod {
@@ -22,18 +32,17 @@ export interface TestMethod {
     config_fields: TestFieldDef[];
     cycle_fields: TestFieldDef[];
     results_fields: TestFieldDef[];
+    /** Optional pretty label for the Test Method picker. Falls back
+     *  to the canonical method_id key. */
+    label?: string;
+    /** Optional long-form description shown in the picker dialog
+     *  when this method is highlighted. */
+    description?: string;
 }
 
 /**
  * Props are all optional overrides — by default the form drives itself
- * from the surrounding `<TisProvider>`. Pass any of these to lock that
- * particular axis.
- *
- * - `schema`: bypass `useTisSchemas()` for the selected method.
- * - `defaultProjectId` / `defaultMethodId`: seed the form's local
- *    state when the corresponding TIS-context fields are blank.
- * - `onProjectChange` / `onMethodChange` / `onValidationChange`:
- *    receive callbacks in addition to the provider's selection state.
+ * from the surrounding `<TisProvider>`.
  */
 export interface TestSetupFormProps {
     schema?: TestMethod;
@@ -44,6 +53,32 @@ export interface TestSetupFormProps {
     onValidationChange?: (isValid: boolean, config: any) => void;
 }
 
+// -------------------------------------------------------------------------
+// Helpers
+// -------------------------------------------------------------------------
+
+const labelOf = (f: TestFieldDef): string => {
+    const base = f.label && f.label.length > 0 ? f.label : f.name;
+    return f.units ? `${base} [${f.units}]` : base;
+};
+
+const hasDescription = (f: TestFieldDef): boolean =>
+    typeof f.description === 'string' && f.description.length > 0;
+
+/** Display name for one method: prefer schema's `label`, fall back
+ *  to the canonical method_id. Mirrors the helper in TestMethodDialog
+ *  so the row label stays in sync with what the dialog shows. */
+const methodLabelOf = (methodId: string, schema: TestMethod | undefined): string =>
+    (schema?.label && schema.label.length > 0) ? schema.label : methodId;
+
+// Project IDs follow the same character class as the server's
+// `tis.create_project` validator. Keep these in sync — see
+// `src/tis_servelet.rs::create_project`.
+const PROJECT_ID_RE = /^[A-Za-z0-9_-]+$/;
+const isValidProjectIdFormat = (id: string) => PROJECT_ID_RE.test(id);
+
+// -------------------------------------------------------------------------
+
 export const TestSetupForm: React.FC<TestSetupFormProps> = ({
     schema: schemaOverride,
     defaultProjectId,
@@ -58,9 +93,6 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
 
     const methodIds = useMemo(() => Object.keys(tis.schemas), [tis.schemas]);
 
-    // Seed the form's local project/method state from the provider's
-    // selection. Direct edits update the provider via setSelection so
-    // the History tab and Data tab follow along.
     const [projectId, setProjectIdLocal] = useState<string>(
         tis.selection.projectId || defaultProjectId || ''
     );
@@ -70,13 +102,8 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
     const [sampleId, setSampleIdLocal] = useState<string>('');
     const [config, setConfig] = useState<any>({});
 
-    // Resolve the schema for the active method. The override beats the
-    // registry; if neither is available, render the empty state.
     const schema = schemaOverride ?? (methodId ? tis.schemas[methodId] : undefined);
 
-    // Push local edits back into the provider's selection so other
-    // components react. Only push when the value actually differs to
-    // avoid feedback loops.
     useEffect(() => {
         if (tis.selection.projectId !== projectId) {
             tis.setSelection({ projectId });
@@ -100,10 +127,6 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [sampleId]);
 
-    // Track the live broadcast scalars — when the form is staged for
-    // a different sample externally (e.g., the operator types in
-    // another tab), reflect that here. Only react on a true change
-    // to avoid stomping local edits.
     useEffect(() => {
         if (tis.state.stagedSampleId && tis.state.stagedSampleId !== sampleId) {
             setSampleIdLocal(tis.state.stagedSampleId);
@@ -113,16 +136,90 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
 
     const [existingProjects, setExistingProjects] = useState<string[]>([]);
     const [filteredProjects, setFilteredProjects] = useState<string[]>([]);
+    const justCreatedRef = useRef<Set<string>>(new Set());
+    const [justCreatedTick, setJustCreatedTick] = useState(0);
     const [isValid, setIsValid] = useState(false);
 
-    // Seed and live-update fields that declare a `source` (FQDN).
+    // Cache of `project_fields` for the currently-selected project,
+    // fetched once on project selection. Folded into every
+    // `tis.stage_test` payload so the recorded test.json carries the
+    // project-level metadata even though the operator no longer sees
+    // those fields in the main form. Keyed by projectId so switching
+    // projects mid-session refetches cleanly.
+    const [projectFieldsCache, setProjectFieldsCache] = useState<Record<string, any>>({});
+    const projectFieldsForCurrent = projectFieldsCache[projectId] ?? {};
+
+    // Dialog state for create + edit + method-picker.
+    const [newProjectOpen, setNewProjectOpen] = useState(false);
+    const [editProjectOpen, setEditProjectOpen] = useState(false);
+    const [methodPickerOpen, setMethodPickerOpen] = useState(false);
+
+    const fetchProjects = async () => {
+        try {
+            const resp: any = await invoke('tis.list_projects' as any, MessageType.Request as any, {} as any);
+            if (resp.success && resp.data && resp.data.projects) {
+                setExistingProjects(resp.data.projects);
+            }
+        } catch (err) {
+            console.error('Failed to list projects', err);
+        }
+    };
+
+    useEffect(() => {
+        fetchProjects();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [invoke]);
+
+    const knownProjects = useMemo(() => {
+        const s = new Set<string>(existingProjects);
+        for (const id of justCreatedRef.current) s.add(id);
+        return s;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [existingProjects, justCreatedTick]);
+
+    const projectExists = projectId.trim() !== '' && knownProjects.has(projectId.trim());
+    const projectIdFormatValid = isValidProjectIdFormat(projectId.trim());
+    const canCreateProject =
+        projectId.trim() !== ''
+        && projectIdFormatValid
+        && !knownProjects.has(projectId.trim());
+
+    // Whenever the user selects a known project (or the project
+    // gets created in-session), pull its persisted project_fields
+    // so we can fold them into stage_test. We don't refetch on
+    // every keystroke — only when projectId actually lands on an
+    // existing project we don't yet have cached.
+    useEffect(() => {
+        const pid = projectId.trim();
+        if (!pid || !projectExists) return;
+        if (projectFieldsCache[pid] !== undefined) return; // already cached
+        let cancelled = false;
+        (async () => {
+            try {
+                const resp: any = await invoke(
+                    'tis.read_project' as any, MessageType.Request,
+                    { project_id: pid } as any,
+                );
+                if (cancelled) return;
+                if (resp?.success) {
+                    const pf = (resp.data?.project_fields ?? {}) as Record<string, any>;
+                    setProjectFieldsCache(prev => ({ ...prev, [pid]: pf }));
+                }
+            } catch (e) {
+                console.warn('[TestSetupForm] read_project failed:', e);
+            }
+        })();
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [projectId, projectExists]);
+
+    // Seed and live-update config_fields that declare a `source`.
     useEffect(() => {
         if (!schema) return;
-        const allFields = [...schema.project_fields, ...schema.config_fields];
         setConfig((prev: any) => {
             let next = prev;
-            for (const field of allFields) {
-                if (field.name === 'sample_id') continue; // sample_id is top-level now
+            for (const field of schema.config_fields) {
+                if (field.name === 'sample_id') continue;
                 if (!field.source) continue;
                 const tag = findTagByFqdn(field.source);
                 if (!tag) continue;
@@ -136,61 +233,64 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
         });
     }, [schema, rawValues, findTagByFqdn]);
 
-    useEffect(() => {
-        const fetchProjects = async () => {
-            try {
-                const resp: any = await invoke('tis.list_projects' as any, MessageType.Request as any, {} as any);
-                if (resp.success && resp.data && resp.data.projects) {
-                    setExistingProjects(resp.data.projects);
-                }
-            } catch (err) {
-                console.error('Failed to list projects', err);
-            }
-        };
-        fetchProjects();
-    }, [invoke]);
-
     const searchProjects = (event: AutoCompleteCompleteEvent) => {
         const query = event.query.toLowerCase();
         setFilteredProjects(existingProjects.filter(p => p.toLowerCase().includes(query)));
     };
 
-    // Validation drives both the local UI and the auto-stage. We only
-    // call `tis.stage_test` when every required piece is present —
-    // otherwise the operator's edge-triggered Start button could fire
-    // a half-baked stage.
+    // Validation drives both the local UI and the auto-stage. Project
+    // ID must be a known project — typing an unknown name is invalid
+    // until the operator goes through the New Project dialog. Each
+    // required *config_field* must also be filled in; project_fields
+    // are validated by the dialog at create/edit time, not here.
     useEffect(() => {
         if (!schema) { setIsValid(false); return; }
         let valid = true;
-        if (!projectId.trim()) valid = false;
+        if (!projectExists) valid = false;
         if (!methodId.trim()) valid = false;
         if (!sampleId.trim()) valid = false;
 
-        const allFields = [...schema.project_fields, ...schema.config_fields];
-        for (const field of allFields) {
-            if (field.name === 'sample_id') continue; // tracked separately
+        for (const field of schema.config_fields) {
+            if (field.name === 'sample_id') continue;
             if (field.required) {
                 const v = config[field.name];
                 if (v === undefined || v === '' || v === null) { valid = false; break; }
             }
         }
+
+        // We also gate validity on having loaded the project_fields
+        // for the selected project — staging *without* them would
+        // record a test.json that's missing project-level metadata
+        // for the lifetime of the run. The fetch happens automatically
+        // when the project is selected, so this is a tight transient
+        // window in practice.
+        if (valid && projectExists && projectFieldsCache[projectId.trim()] === undefined) {
+            valid = false;
+        }
+
         setIsValid(valid);
         if (onValidationChange) onValidationChange(valid, config);
 
-        // Auto-stage when everything is valid. Stripping sample_id from
-        // config (it's a top-level peer of project_id/method_id now;
-        // the legacy nested form is server-side hoisted with a
-        // deprecation warning, but new code shouldn't rely on it).
         if (valid) {
-            const { sample_id: _drop, ...rest } = (config ?? {}) as any;
+            const { sample_id: _drop, ...configRest } = (config ?? {}) as any;
+            // Combine persisted project_fields (managerial setup) with
+            // the per-test config_fields the operator just filled in.
+            // Keys collide in pathological project.json, in which case
+            // the per-test value wins — operators are closer to the
+            // run than the project metadata.
+            const mergedConfig = {
+                ...projectFieldsForCurrent,
+                ...configRest,
+            };
             void invoke('tis.stage_test' as any, MessageType.Request, {
                 project_id: projectId,
                 method_id:  methodId,
                 sample_id:  sampleId,
-                config:     rest,
+                config:     mergedConfig,
             } as any).catch(e => console.error('[TestSetupForm] stage_test failed:', e));
         }
-    }, [config, schema, projectId, methodId, sampleId, onValidationChange, invoke]);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [config, schema, projectId, methodId, sampleId, projectExists, projectFieldsCache, onValidationChange, invoke]);
 
     const isFieldValid = (field: TestFieldDef) => {
         if (!field.required) return true;
@@ -199,7 +299,7 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
     };
 
     const handleProjectIdChange = (value: string | null | undefined) => {
-        const sanitized = (value || '').replace(/[^a-zA-Z0-9_]/g, '');
+        const sanitized = (value || '').replace(/[^a-zA-Z0-9_-]/g, '');
         setProjectIdLocal(sanitized);
     };
 
@@ -215,13 +315,34 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
         }
     };
 
-    const renderField = (field: TestFieldDef) => {
+    // Called by ProjectInfoDialog after a successful create/update.
+    // Populates the local cache + known-projects set so the main form
+    // is immediately valid without requiring a refresh.
+    const handleProjectInfoSubmitted = (pid: string, projectFields: Record<string, any>) => {
+        justCreatedRef.current.add(pid);
+        setJustCreatedTick(t => t + 1);
+        setProjectFieldsCache(prev => ({ ...prev, [pid]: projectFields }));
+        // Refresh the dropdown so the new project shows up for any
+        // future searches in this session.
+        void fetchProjects();
+        // If the dialog created a brand-new project, also surface it
+        // as the current selection — the operator's intent is clearly
+        // "set up this project and start working on it."
+        if (projectId.trim() !== pid) setProjectIdLocal(pid);
+    };
+
+    // -----------------------------------------------------------------
+    // Per-config-field row renderer — same four-column layout as before:
+    //   label[units]  |  input  |  info-icon  |  validity-icon
+    // -----------------------------------------------------------------
+    const renderConfigField = (field: TestFieldDef) => {
         if (field.name === 'sample_id') return null;
         const valid = isFieldValid(field);
         const isNum = field.type !== 'string' && field.type !== 'bool';
+        const tooltipId = `acFormInfo_${field.name}`;
         return (
             <React.Fragment key={field.name}>
-                <span className="ac-form-label">{field.name}</span>
+                <span className="ac-form-label">{labelOf(field)}</span>
                 {isNum ? (
                     <ValueInput
                         label={undefined}
@@ -237,7 +358,20 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
                         className={!valid ? 'p-invalid' : ''}
                     />
                 )}
-                <span className="ac-form-units">{field.units ?? ''}</span>
+                {hasDescription(field) ? (
+                    <>
+                        <Tooltip target={`#${tooltipId}`} position="left" />
+                        <span
+                            id={tooltipId}
+                            data-pr-tooltip={field.description}
+                            style={{ display: 'inline-flex', alignItems: 'center', justifyContent: 'center', cursor: 'help' }}
+                        >
+                            <i className="pi pi-info-circle" style={{ color: 'var(--text-secondary-color)' }} />
+                        </span>
+                    </>
+                ) : (
+                    <span aria-hidden="true" />
+                )}
                 <span style={{ color: valid ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
                     <i className={valid ? 'pi pi-check' : 'pi pi-times'} />
                 </span>
@@ -255,8 +389,15 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
         );
     }
 
+    const gridStyle: React.CSSProperties = {
+        padding: '1.25rem',
+        gridTemplateColumns: 'auto 1fr 1.75rem 1.75rem',
+    };
+
+    const projectRowValid = projectExists;
+
     return (
-        <div className="ac-form-grid" style={{ padding: '1.25rem' }}>
+        <div className="ac-form-grid" style={gridStyle}>
             <h3 className="ac-form-section" style={{ display: 'flex', alignItems: 'center', gap: '10px' }}>
                 Project &amp; Method
                 <span style={{ color: isValid ? 'var(--green-500)' : 'var(--red-500)' }}>
@@ -265,18 +406,62 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
             </h3>
 
             <span className="ac-form-label">Project ID</span>
-            <AutoComplete
-                value={projectId}
-                suggestions={filteredProjects}
-                completeMethod={searchProjects}
-                onChange={(e) => handleProjectIdChange(e.value)}
-                dropdown
-                placeholder="Enter or select Project ID"
-                className={!projectId.trim() ? 'p-invalid' : ''}
-            />
-            <span />
-            <span style={{ color: projectId.trim() ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
-                <i className={projectId.trim() ? 'pi pi-check' : 'pi pi-times'} />
+            <div className="p-inputgroup" style={{ flex: 1 }}>
+                <AutoComplete
+                    value={projectId}
+                    suggestions={filteredProjects}
+                    completeMethod={searchProjects}
+                    onChange={(e) => handleProjectIdChange(e.value)}
+                    dropdown
+                    placeholder="Select an existing Project ID, or type a new one and click +"
+                    className={!projectRowValid ? 'p-invalid' : ''}
+                    style={{ flex: 1 }}
+                />
+                {/*
+                 * + button → opens the New Project dialog where the
+                 * operator (or manager) fills in project_fields.
+                 * Enabled only when the typed ID is a fresh, valid
+                 * candidate. Once the dialog completes, the project
+                 * is created on the server and added to our local
+                 * known-projects set so the main form becomes valid
+                 * immediately.
+                 */}
+                <Button
+                    icon="pi pi-plus"
+                    type="button"
+                    onClick={() => setNewProjectOpen(true)}
+                    disabled={!canCreateProject}
+                    tooltip={
+                        !projectId.trim() ? 'Type a project ID first' :
+                        !projectIdFormatValid ? 'Letters, digits, _ and - only' :
+                        knownProjects.has(projectId.trim()) ? 'Project already exists' :
+                        `Create project "${projectId.trim()}"`
+                    }
+                    tooltipOptions={{ position: 'top' }}
+                />
+                {/*
+                 * ✏️ button → opens the Edit Project Information
+                 * dialog. Enabled only when the selected project
+                 * actually exists. This is the only way to mutate
+                 * project_fields after creation; the operator can't
+                 * stumble into editing project metadata while running
+                 * a sample, which keeps the future per-user permission
+                 * gate (manager vs operator) clean.
+                 */}
+                <Button
+                    icon="pi pi-pencil"
+                    type="button"
+                    onClick={() => setEditProjectOpen(true)}
+                    disabled={!projectExists}
+                    tooltip={projectExists
+                        ? `Edit information for "${projectId.trim()}"`
+                        : 'Select an existing project to edit'}
+                    tooltipOptions={{ position: 'top' }}
+                />
+            </div>
+            <span aria-hidden="true" />
+            <span style={{ color: projectRowValid ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
+                <i className={projectRowValid ? 'pi pi-check' : 'pi pi-times'} />
             </span>
 
             <span className="ac-form-label">Sample ID</span>
@@ -286,29 +471,82 @@ export const TestSetupForm: React.FC<TestSetupFormProps> = ({
                 onValueChanged={handleSampleIdChange}
                 className={!sampleId.trim() ? 'p-invalid' : ''}
             />
-            <span />
+            <span aria-hidden="true" />
             <span style={{ color: sampleId.trim() ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
                 <i className={sampleId.trim() ? 'pi pi-check' : 'pi pi-times'} />
             </span>
 
-            {methodIds.length > 1 && (
+            {/*
+             * Test Method row. Shows the current method's pretty
+             * label (or its canonical method_id when no label is
+             * declared) read-only, with an edit button that opens
+             * the picker dialog. The dialog scales past three or
+             * four methods where a SelectButton would wrap, and
+             * surfaces the per-method description so the operator
+             * can disambiguate similarly-named methods at the
+             * point of choice. The row is rendered even when only
+             * one method is declared so the operator can still open
+             * the picker and read its description.
+             */}
+            {methodIds.length > 0 && (
                 <>
                     <span className="ac-form-label">Test Method</span>
-                    <SelectButton
-                        value={methodId}
-                        options={methodIds.map(id => ({ label: id, value: id }))}
-                        onChange={(e) => e.value && setMethodIdLocal(e.value)}
-                    />
-                    <span />
-                    <span />
+                    <div className="p-inputgroup" style={{ flex: 1 }}>
+                        <InputText
+                            value={methodLabelOf(methodId, schema)}
+                            readOnly
+                            style={{ flex: 1 }}
+                            tabIndex={-1}
+                        />
+                        <Button
+                            icon="pi pi-pencil"
+                            type="button"
+                            onClick={() => setMethodPickerOpen(true)}
+                            tooltip={methodIds.length > 1
+                                ? 'Change test method'
+                                : 'View test method details'}
+                            tooltipOptions={{ position: 'top' }}
+                        />
+                    </div>
+                    <span aria-hidden="true" />
+                    <span style={{ color: methodId ? 'var(--green-500)' : 'var(--red-500)', display: 'flex', alignItems: 'center' }}>
+                        <i className={methodId ? 'pi pi-check' : 'pi pi-times'} />
+                    </span>
                 </>
             )}
 
-            <h3 className="ac-form-section" style={{ marginTop: '1rem' }}>Project Information</h3>
-            {schema.project_fields.map(renderField)}
-
             <h3 className="ac-form-section" style={{ marginTop: '1rem' }}>Test Configuration</h3>
-            {schema.config_fields.map(renderField)}
+            {schema.config_fields.map(renderConfigField)}
+
+            {/*
+             * Project Information no longer renders inline. Use the
+             * + and ✏️ buttons in the Project ID row above to create
+             * or edit it. The dialogs persist project_fields on the
+             * server and the form folds them into stage_test
+             * automatically.
+             */}
+            <ProjectInfoDialog
+                visible={newProjectOpen}
+                onHide={() => setNewProjectOpen(false)}
+                mode="create"
+                projectId={projectId.trim()}
+                projectFields={schema.project_fields}
+                onSubmitted={handleProjectInfoSubmitted}
+            />
+            <ProjectInfoDialog
+                visible={editProjectOpen}
+                onHide={() => setEditProjectOpen(false)}
+                mode="edit"
+                projectId={projectId.trim()}
+                projectFields={schema.project_fields}
+                onSubmitted={handleProjectInfoSubmitted}
+            />
+            <TestMethodDialog
+                visible={methodPickerOpen}
+                onHide={() => setMethodPickerOpen(false)}
+                currentMethodId={methodId}
+                onSelected={(picked) => setMethodIdLocal(picked)}
+            />
         </div>
     );
 };