@adcops/autocore-react 3.3.65 → 3.3.67

package/dist/components/ams/AmsProvider.d.ts

@@ -3,6 +3,25 @@ export type AmsTypeSchema = any;
 export type AmsSchemaRegistry = {
     [assetType: string]: AmsTypeSchema;
 };
+/**
+ * One role an asset_type can play, derived from a `select=by_location`
+ * `asset_ref` in `project.json::test_methods`. Used by the AMS UI to
+ * present a dropdown when registering a new asset, instead of forcing
+ * the operator to type a free-form `location` string.
+ */
+export interface AmsRole {
+    /** The literal `location` string the resolver matches against. */
+    location: string;
+    /** Human-readable label, e.g. "Triaxial Transducer (TSDR)". */
+    label: string | null;
+    /** Optional one-line explanation of what this role does. */
+    description: string | null;
+    /** Test method IDs whose start_test will pick up an asset in this role. */
+    used_by: string[];
+}
+export type AmsRoleRegistry = {
+    [assetType: string]: AmsRole[];
+};
 export interface AmsAlerts {
     assetCount: number;
     calibrationOverdue: number;
@@ -23,6 +42,13 @@ export interface AmsSelection {
 export interface AmsContextValue {
     schemas: AmsSchemaRegistry;
     schemasLoaded: boolean;
+    /**
+     * Roles per asset_type. Empty array means the type isn't picked up
+     * via `by_location` anywhere in this project — registration UIs
+     * should hide the Role field for that type.
+     */
+    roles: AmsRoleRegistry;
+    rolesLoaded: boolean;
     alerts: AmsAlerts;
     assets: AmsAssetEntry[];
     refreshAssets: () => Promise<void>;
@@ -39,6 +65,7 @@ export interface AmsProviderProps {
 export declare const AmsProvider: React.FC<AmsProviderProps>;
 export declare const useAms: () => AmsContextValue;
 export declare const useAmsSchemas: () => AmsSchemaRegistry;
+export declare const useAmsRoles: () => AmsRoleRegistry;
 export declare const useAmsAlerts: () => AmsAlerts;
 export declare const useAmsAssets: () => AmsAssetEntry[];
 export declare const useAmsSelection: () => readonly [AmsSelection, (patch: Partial<AmsSelection>) => void];

package/dist/components/ams/AmsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmsProvider.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AmsProvider.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,EAOV,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAChC,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,SAAS,EAAE,YAAY,CAAC;IACxB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;CACxD;AAwBD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA8GlD,CAAC;AAMF,eAAO,MAAM,MAAM,uBAAwC,CAAC;AAC5D,eAAO,MAAM,aAAa,yBAAyC,CAAC;AACpE,eAAO,MAAM,YAAY,iBAAyC,CAAC;AACnE,eAAO,MAAM,YAAY,uBAAyC,CAAC;AACnE,eAAO,MAAM,eAAe,wCArJF,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAwJvD,CAAC"}
+{"version":3,"file":"AmsProvider.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AmsProvider.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,EAOV,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAChC,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AACD,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,SAAS,EAAE,YAAY,CAAC;IACxB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;CACxD;AA0BD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAmIlD,CAAC;AAMF,eAAO,MAAM,MAAM,uBAAwC,CAAC;AAC5D,eAAO,MAAM,aAAa,yBAAyC,CAAC;AACpE,eAAO,MAAM,WAAW,uBAAyC,CAAC;AAClE,eAAO,MAAM,YAAY,iBAAyC,CAAC;AACnE,eAAO,MAAM,YAAY,uBAAyC,CAAC;AACnE,eAAO,MAAM,eAAe,wCA7KF,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAgLvD,CAAC"}

package/dist/components/ams/AmsProvider.js

@@ -1 +1 @@
-import{jsx as _jsx}from"react/jsx-runtime";import React,{createContext,useCallback,useContext,useEffect,useMemo,useState}from"react";import{EventEmitterContext}from"../../core/EventEmitterContext";import{MessageType}from"../../hub/CommandMessage";const EMPTY_ALERTS={assetCount:0,calibrationOverdue:0,laneUnavailable:0},AmsContext=createContext({schemas:{},schemasLoaded:!1,alerts:EMPTY_ALERTS,assets:[],refreshAssets:async()=>{},readAsset:async()=>null,listCalibrations:async()=>[],readCalibration:async()=>null,readUsage:async()=>null,selection:{assetType:null,assetId:null},setSelection:()=>{}});export const AmsProvider=({children:e})=>{const{invoke:s,subscribe:t,unsubscribe:a}=useContext(EventEmitterContext),[n,r]=useState({}),[c,u]=useState(!1),[l,o]=useState(EMPTY_ALERTS),[i,m]=useState([]),[d,C]=useState({assetType:null,assetId:null}),x=useCallback(e=>{C(s=>({...s,...e}))},[]);useEffect(()=>{let e=!1;return(async()=>{try{const t=await s("ams.list_schemas",MessageType.Request,{});if(e)return;t?.success&&t.data&&(r(t.data.asset_types??{}),u(!0))}catch(e){}})(),()=>{e=!0}},[]);const b=useCallback(async()=>{try{const e=await s("ams.list_assets",MessageType.Request,{include_retired:!0});e?.success&&m(e.data.assets??[])}catch(e){}},[s]);useEffect(()=>{b()},[b]),useEffect(()=>{const e=[t("ams.asset_changed",()=>{b()}),t("ams.calibration_added",()=>{b()}),t("ams.asset_count",e=>o(s=>({...s,assetCount:Number(e)||0}))),t("ams.alert_calibration_overdue",e=>o(s=>({...s,calibrationOverdue:Number(e)||0}))),t("ams.alert_lane_unavailable",e=>o(s=>({...s,laneUnavailable:Number(e)||0})))];return()=>{e.forEach(a)}},[t,a,b]);const y=useCallback(async e=>{try{const t=await s("ams.read_asset",MessageType.Request,{asset_id:e});return t?.success?t.data:null}catch{return null}},[s]),_=useCallback(async e=>{try{const t=await s("ams.list_calibrations",MessageType.Request,{asset_id:e});return t?.success?t.data.cal_ids??[]:[]}catch{return[]}},[s]),A=useCallback(async(e,t)=>{try{const a=await s("ams.read_calibration",MessageType.Request,{asset_id:e,cal_id:t});return a?.success?a.data:null}catch{return null}},[s]),h=useCallback(async e=>{try{const t=await s("ams.read_usage",MessageType.Request,{asset_id:e});return t?.success?t.data:null}catch{return null}},[s]),p=useMemo(()=>({schemas:n,schemasLoaded:c,alerts:l,assets:i,refreshAssets:b,readAsset:y,listCalibrations:_,readCalibration:A,readUsage:h,selection:d,setSelection:x}),[n,c,l,i,b,y,_,A,h,d,x]);return _jsx(AmsContext.Provider,{value:p,children:e})};export const useAms=()=>useContext(AmsContext);export const useAmsSchemas=()=>useContext(AmsContext).schemas;export const useAmsAlerts=()=>useContext(AmsContext).alerts;export const useAmsAssets=()=>useContext(AmsContext).assets;export const useAmsSelection=()=>{const e=useContext(AmsContext);return[e.selection,e.setSelection]};
+import{jsx as _jsx}from"react/jsx-runtime";import React,{createContext,useCallback,useContext,useEffect,useMemo,useState}from"react";import{EventEmitterContext}from"../../core/EventEmitterContext";import{MessageType}from"../../hub/CommandMessage";const EMPTY_ALERTS={assetCount:0,calibrationOverdue:0,laneUnavailable:0},AmsContext=createContext({schemas:{},schemasLoaded:!1,roles:{},rolesLoaded:!1,alerts:EMPTY_ALERTS,assets:[],refreshAssets:async()=>{},readAsset:async()=>null,listCalibrations:async()=>[],readCalibration:async()=>null,readUsage:async()=>null,selection:{assetType:null,assetId:null},setSelection:()=>{}});export const AmsProvider=({children:e})=>{const{invoke:s,subscribe:t,unsubscribe:a}=useContext(EventEmitterContext),[n,r]=useState({}),[c,o]=useState(!1),[u,l]=useState({}),[i,m]=useState(!1),[d,C]=useState(EMPTY_ALERTS),[x,y]=useState([]),[b,_]=useState({assetType:null,assetId:null}),A=useCallback(e=>{_(s=>({...s,...e}))},[]);useEffect(()=>{let e=!1;return(async()=>{try{const t=await s("ams.list_schemas",MessageType.Request,{});if(e)return;t?.success&&t.data&&(r(t.data.asset_types??{}),o(!0))}catch(e){}})(),(async()=>{try{const t=await s("ams.list_roles",MessageType.Request,{});if(e)return;t?.success&&t.data?(l(t.data.roles??{}),m(!0)):m(!0)}catch(e){m(!0)}})(),()=>{e=!0}},[]);const p=useCallback(async()=>{try{const e=await s("ams.list_assets",MessageType.Request,{include_retired:!0});e?.success&&y(e.data.assets??[])}catch(e){}},[s]);useEffect(()=>{p()},[p]),useEffect(()=>{const e=[t("ams.asset_changed",()=>{p()}),t("ams.calibration_added",()=>{p()}),t("ams.asset_count",e=>C(s=>({...s,assetCount:Number(e)||0}))),t("ams.alert_calibration_overdue",e=>C(s=>({...s,calibrationOverdue:Number(e)||0}))),t("ams.alert_lane_unavailable",e=>C(s=>({...s,laneUnavailable:Number(e)||0})))];return()=>{e.forEach(a)}},[t,a,p]);const h=useCallback(async e=>{try{const t=await s("ams.read_asset",MessageType.Request,{asset_id:e});return t?.success?t.data:null}catch{return null}},[s]),f=useCallback(async e=>{try{const t=await s("ams.list_calibrations",MessageType.Request,{asset_id:e});return t?.success?t.data.cal_ids??[]:[]}catch{return[]}},[s]),E=useCallback(async(e,t)=>{try{const a=await s("ams.read_calibration",MessageType.Request,{asset_id:e,cal_id:t});return a?.success?a.data:null}catch{return null}},[s]),S=useCallback(async e=>{try{const t=await s("ams.read_usage",MessageType.Request,{asset_id:e});return t?.success?t.data:null}catch{return null}},[s]),T=useMemo(()=>({schemas:n,schemasLoaded:c,roles:u,rolesLoaded:i,alerts:d,assets:x,refreshAssets:p,readAsset:h,listCalibrations:f,readCalibration:E,readUsage:S,selection:b,setSelection:A}),[n,c,u,i,d,x,p,h,f,E,S,b,A]);return _jsx(AmsContext.Provider,{value:T,children:e})};export const useAms=()=>useContext(AmsContext);export const useAmsSchemas=()=>useContext(AmsContext).schemas;export const useAmsRoles=()=>useContext(AmsContext).roles;export const useAmsAlerts=()=>useContext(AmsContext).alerts;export const useAmsAssets=()=>useContext(AmsContext).assets;export const useAmsSelection=()=>{const e=useContext(AmsContext);return[e.selection,e.setSelection]};

package/dist/components/ams/AssetDetailView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetDetailView.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AssetDetailView.tsx"],"names":[],"mappings":"AAQA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAqFnC,CAAC"}
+{"version":3,"file":"AssetDetailView.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AssetDetailView.tsx"],"names":[],"mappings":"AAQA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EA4FnC,CAAC"}

package/dist/components/ams/AssetDetailView.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useEffect,useState}from"react";import{Button}from"primereact/button";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{useAms}from"./AmsProvider";import{CalibrationEntryDialog}from"./CalibrationEntryDialog";export const AssetDetailView=()=>{const{selection:e,schemas:s,readAsset:t,listCalibrations:a,readCalibration:r,readUsage:i}=useAms(),[l,n]=useState(null),[o,d]=useState([]),[c,m]=useState(null),[_,x]=useState(!1),p=async()=>{if(!e.assetId)return n(null),d([]),void m(null);const s=await t(e.assetId);n(s);const l=await a(e.assetId),o=await Promise.all(l.map(s=>r(e.assetId,s)));d(o.filter(Boolean));const c=await i(e.assetId);m(c)};if(useEffect(()=>{p()},[e.assetId]),!e.assetId)return _jsx("div",{style:{padding:"1rem",color:"#9ca3af"},children:"Select an asset from the registry to see its details."});if(!l)return _jsx("div",{style:{padding:"1rem"},children:"Loading…"});const u=s[l.asset_type]?.label??l.asset_type;return _jsxs("div",{style:{display:"flex",flexDirection:"column",gap:"1rem"},children:[_jsxs("div",{style:{display:"grid",gridTemplateColumns:"auto 1fr auto 1fr",gap:"0.5rem 1.5rem",alignItems:"baseline"},children:[_jsx("strong",{children:"Asset ID"})," ",_jsx("span",{children:l.asset_id}),_jsx("strong",{children:"Type"}),"     ",_jsx("span",{children:u}),_jsx("strong",{children:"Serial"}),"   ",_jsx("span",{children:l.serial||_jsx("em",{style:{color:"#9ca3af"},children:"(none)"})}),_jsx("strong",{children:"Location"})," ",_jsx("span",{children:l.location||_jsx("em",{style:{color:"#9ca3af"},children:"(none)"})}),_jsx("strong",{children:"Status"}),"   ",_jsx("span",{children:l.status}),_jsx("strong",{children:"Installed"}),_jsx("span",{children:l.install_date?new Date(l.install_date).toLocaleString():"—"}),_jsx("strong",{children:"Current Cal"}),_jsx("span",{children:l.current_calibration_id??_jsx("em",{style:{color:"#f59e0b"},children:"none"})}),_jsx("strong",{children:"Cycles"}),"   ",_jsx("span",{children:c?.cycles??0})]}),_jsxs("div",{style:{display:"flex",justifyContent:"space-between",alignItems:"center"},children:[_jsx("h4",{style:{margin:0},children:"Calibration History"}),_jsx(Button,{label:"+ Calibration",icon:"pi pi-plus",onClick:()=>x(!0)})]}),_jsxs(DataTable,{value:o,size:"small",stripedRows:!0,emptyMessage:"No calibrations recorded for this asset.",children:[_jsx(Column,{field:"cal_id",header:"Cal ID"}),_jsx(Column,{field:"performed_at",header:"Performed",body:e=>e.performed_at?new Date(e.performed_at).toLocaleString():"—"}),_jsx(Column,{field:"performed_by",header:"By"}),_jsx(Column,{field:"expires_at",header:"Expires",body:e=>e.expires_at?new Date(e.expires_at).toLocaleDateString():"—"}),_jsx(Column,{field:"cert_ref",header:"Cert"}),_jsx(Column,{header:"Values",body:e=>_jsx("code",{style:{fontSize:"0.75rem"},children:JSON.stringify(e.values)})})]}),_jsx(CalibrationEntryDialog,{visible:_,assetId:l.asset_id,assetType:l.asset_type,onHide:()=>x(!1),onAdded:()=>{p()}})]})};
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useEffect,useState}from"react";import{Button}from"primereact/button";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{useAms}from"./AmsProvider";import{CalibrationEntryDialog}from"./CalibrationEntryDialog";export const AssetDetailView=()=>{const{selection:e,schemas:s,roles:t,readAsset:a,listCalibrations:r,readCalibration:i,readUsage:l}=useAms(),[n,o]=useState(null),[d,c]=useState([]),[_,m]=useState(null),[p,x]=useState(!1),u=async()=>{if(!e.assetId)return o(null),c([]),void m(null);const s=await a(e.assetId);o(s);const t=await r(e.assetId),n=await Promise.all(t.map(s=>i(e.assetId,s)));c(n.filter(Boolean));const d=await l(e.assetId);m(d)};if(useEffect(()=>{u()},[e.assetId]),!e.assetId)return _jsx("div",{style:{padding:"1rem",color:"#9ca3af"},children:"Select an asset from the registry to see its details."});if(!n)return _jsx("div",{style:{padding:"1rem"},children:"Loading…"});const f=s[n.asset_type]?.label??n.asset_type,j=t[n.asset_type]?.find(e=>e.location===n.location),h=j?j.label??j.location:n.location;return _jsxs("div",{style:{display:"flex",flexDirection:"column",gap:"1rem"},children:[_jsxs("div",{style:{display:"grid",gridTemplateColumns:"auto 1fr auto 1fr",gap:"0.5rem 1.5rem",alignItems:"baseline"},children:[_jsx("strong",{children:"Asset ID"})," ",_jsx("span",{children:n.asset_id}),_jsx("strong",{children:"Type"}),"     ",_jsx("span",{children:f}),_jsx("strong",{children:"Serial"}),"   ",_jsx("span",{children:n.serial||_jsx("em",{style:{color:"#9ca3af"},children:"(none)"})}),_jsx("strong",{children:"Role"}),"     ",_jsx("span",{children:h||_jsx("em",{style:{color:"#9ca3af"},children:"(none)"})}),_jsx("strong",{children:"Status"}),"   ",_jsx("span",{children:n.status}),_jsx("strong",{children:"Installed"}),_jsx("span",{children:n.install_date?new Date(n.install_date).toLocaleString():"—"}),_jsx("strong",{children:"Current Cal"}),_jsx("span",{children:n.current_calibration_id??_jsx("em",{style:{color:"#f59e0b"},children:"none"})}),_jsx("strong",{children:"Cycles"}),"   ",_jsx("span",{children:_?.cycles??0})]}),_jsxs("div",{style:{display:"flex",justifyContent:"space-between",alignItems:"center"},children:[_jsx("h4",{style:{margin:0},children:"Calibration History"}),_jsx(Button,{label:"+ Calibration",icon:"pi pi-plus",onClick:()=>x(!0)})]}),_jsxs(DataTable,{value:d,size:"small",stripedRows:!0,emptyMessage:"No calibrations recorded for this asset.",children:[_jsx(Column,{field:"cal_id",header:"Cal ID"}),_jsx(Column,{field:"performed_at",header:"Performed",body:e=>e.performed_at?new Date(e.performed_at).toLocaleString():"—"}),_jsx(Column,{field:"performed_by",header:"By"}),_jsx(Column,{field:"expires_at",header:"Expires",body:e=>e.expires_at?new Date(e.expires_at).toLocaleDateString():"—"}),_jsx(Column,{field:"cert_ref",header:"Cert"}),_jsx(Column,{header:"Values",body:e=>_jsx("code",{style:{fontSize:"0.75rem"},children:JSON.stringify(e.values)})})]}),_jsx(CalibrationEntryDialog,{visible:p,assetId:n.asset_id,assetType:n.asset_type,onHide:()=>x(!1),onAdded:()=>{u()}})]})};

package/dist/components/ams/AssetRegistryTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetRegistryTable.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AssetRegistryTable.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAwC,MAAM,OAAO,CAAC;AAoB7D,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EA+ItC,CAAC"}
+{"version":3,"file":"AssetRegistryTable.d.ts","sourceRoot":"","sources":["../../../src/components/ams/AssetRegistryTable.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAwC,MAAM,OAAO,CAAC;AA+C7D,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAmRtC,CAAC"}

package/dist/components/ams/AssetRegistryTable.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import React,{useContext,useMemo,useState}from"react";import{Button}from"primereact/button";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Dropdown}from"primereact/dropdown";import{InputText}from"primereact/inputtext";import{Dialog}from"primereact/dialog";import{EventEmitterContext}from"../../core/EventEmitterContext";import{MessageType}from"../../hub/CommandMessage";import{useAms}from"./AmsProvider";const EMPTY_ADD={open:!1,assetType:"",serial:"",location:""};export const AssetRegistryTable=()=>{const{schemas:e,assets:t,refreshAssets:s,setSelection:a,selection:l}=useAms(),{invoke:r}=useContext(EventEmitterContext),[o,i]=useState(null),[n,d]=useState(null),[c,p]=useState(EMPTY_ADD),u=useMemo(()=>Object.keys(e).map(t=>({label:e[t]?.label??t,value:t})),[e]),m=useMemo(()=>t.filter(e=>(!o||e.asset_type===o)&&(!n||e.status===n)),[t,o,n]);return _jsxs("div",{style:{display:"flex",flexDirection:"column",gap:"0.5rem"},children:[_jsxs("div",{style:{display:"flex",gap:"0.75rem",alignItems:"center"},children:[_jsx(Dropdown,{value:o,options:[{label:"All Types",value:null},...u],onChange:e=>i(e.value),placeholder:"Filter by type"}),_jsx(Dropdown,{value:n,options:[{label:"All Statuses",value:null},{label:"Active",value:"active"},{label:"Out for Service",value:"out_for_service"},{label:"Retired",value:"retired"}],onChange:e=>d(e.value),placeholder:"Filter by status"}),_jsx("span",{style:{marginLeft:"auto"},children:_jsx(Button,{icon:"pi pi-plus",label:"Add Asset",onClick:()=>p(e=>({...e,open:!0})),disabled:0===u.length})})]}),_jsxs(DataTable,{value:m,selectionMode:"single",selection:m.find(e=>e.asset_id===l.assetId)??null,onSelectionChange:e=>{const t=e.value;t&&a({assetType:t.asset_type,assetId:t.asset_id})},dataKey:"asset_id",emptyMessage:0===u.length?"AMS not enabled in this project (no asset_types declared).":"No assets registered yet.",size:"small",stripedRows:!0,children:[_jsx(Column,{field:"asset_id",header:"Asset ID"}),_jsx(Column,{field:"asset_type",header:"Type",body:t=>e[t.asset_type]?.label??t.asset_type}),_jsx(Column,{field:"serial",header:"Serial"}),_jsx(Column,{field:"location",header:"Location"}),_jsx(Column,{field:"status",header:"Status"}),_jsx(Column,{header:"Calibration",body:e=>e.current_calibration_id?_jsx("span",{title:e.current_calibration_id,children:"✓"}):_jsx("span",{style:{color:"#f59e0b"},children:"none"})})]}),_jsxs(Dialog,{header:"Add New Asset",visible:c.open,style:{width:"32rem"},onHide:()=>p(EMPTY_ADD),footer:_jsxs(_Fragment,{children:[_jsx(Button,{label:"Cancel",severity:"secondary",onClick:()=>p(EMPTY_ADD)}),_jsx(Button,{label:"Create",icon:"pi pi-check",onClick:async()=>{if(c.assetType)try{const e=await r("ams.create_asset",MessageType.Request,{asset_type:c.assetType,serial:c.serial,location:c.location});e?.success&&(p(EMPTY_ADD),await s(),e.data?.asset_id&&a({assetType:c.assetType,assetId:e.data.asset_id}))}catch(e){}},disabled:!c.assetType})]}),children:[_jsxs("div",{style:{display:"grid",gridTemplateColumns:"auto 1fr",gap:"0.5rem 1rem",alignItems:"center"},children:[_jsx("label",{children:"Type *"}),_jsx(Dropdown,{value:c.assetType,options:u,onChange:e=>p(t=>({...t,assetType:e.value})),placeholder:"Choose asset type"}),_jsx("label",{children:"Serial"}),_jsx(InputText,{value:c.serial,onChange:e=>p(t=>({...t,serial:e.target.value}))}),_jsx("label",{children:"Location"}),_jsx(InputText,{value:c.location,onChange:e=>p(t=>({...t,location:e.target.value}))})]}),_jsxs("p",{style:{fontSize:"0.875rem",color:"#9ca3af",marginTop:"1rem"},children:["The asset_id is generated by the server (format: ",_jsxs("code",{children:[c.assetType?e[c.assetType]?.id_prefix??"A-":"A-","YYYYMMDDTHHMMSS"]}),"). Manufacturer serial is recorded for traceability but is not used as the unique key."]})]})]})};
+import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import React,{useContext,useMemo,useState}from"react";import{Button}from"primereact/button";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Dropdown}from"primereact/dropdown";import{InputText}from"primereact/inputtext";import{Dialog}from"primereact/dialog";import{EventEmitterContext}from"../../core/EventEmitterContext";import{MessageType}from"../../hub/CommandMessage";import{useAms}from"./AmsProvider";const ROLE_OTHER="__other__",EMPTY_ADD={open:!1,assetType:"",serial:"",roleSelection:"",location:""};function roleLabel(e){return e.label??e.location}function roleUsageSummary(e){return 0===e.used_by.length?"No test methods reference this role.":1===e.used_by.length?`Used by: ${e.used_by[0]}`:`Used by: ${e.used_by.join(", ")}`}export const AssetRegistryTable=()=>{const{schemas:e,roles:t,assets:s,refreshAssets:l,setSelection:a,selection:o}=useAms(),{invoke:r}=useContext(EventEmitterContext),[n,i]=useState(null),[c,d]=useState(null),[p,u]=useState(EMPTY_ADD),m=useMemo(()=>Object.keys(e).map(t=>({label:e[t]?.label??t,value:t})),[e]),_=useMemo(()=>p.assetType?t[p.assetType]??[]:[],[p.assetType,t]),h=_.length>0,y=useMemo(()=>{const e=_.map(e=>({label:roleLabel(e),value:e.location}));return e.push({label:"Other (advanced — type a custom role)",value:ROLE_OTHER}),e},[_]),x=useMemo(()=>p.roleSelection===ROLE_OTHER?null:_.find(e=>e.location===p.roleSelection)??null,[p.roleSelection,_]),b=useMemo(()=>s.filter(e=>(!n||e.asset_type===n)&&(!c||e.status===c)),[s,n,c]),g=!p.assetType||h&&(""===p.roleSelection||p.roleSelection===ROLE_OTHER&&!p.location.trim());return _jsxs("div",{style:{display:"flex",flexDirection:"column",gap:"0.5rem"},children:[_jsxs("div",{style:{display:"flex",gap:"0.75rem",alignItems:"center"},children:[_jsx(Dropdown,{value:n,options:[{label:"All Types",value:null},...m],onChange:e=>i(e.value),placeholder:"Filter by type"}),_jsx(Dropdown,{value:c,options:[{label:"All Statuses",value:null},{label:"Active",value:"active"},{label:"Out for Service",value:"out_for_service"},{label:"Retired",value:"retired"}],onChange:e=>d(e.value),placeholder:"Filter by status"}),_jsx("span",{style:{marginLeft:"auto"},children:_jsx(Button,{icon:"pi pi-plus",label:"Add Asset",onClick:()=>u(e=>({...e,open:!0})),disabled:0===m.length})})]}),_jsxs(DataTable,{value:b,selectionMode:"single",selection:b.find(e=>e.asset_id===o.assetId)??null,onSelectionChange:e=>{const t=e.value;t&&a({assetType:t.asset_type,assetId:t.asset_id})},dataKey:"asset_id",emptyMessage:0===m.length?"AMS not enabled in this project (no asset_types declared).":"No assets registered yet.",size:"small",stripedRows:!0,children:[_jsx(Column,{field:"asset_id",header:"Asset ID"}),_jsx(Column,{field:"asset_type",header:"Type",body:t=>e[t.asset_type]?.label??t.asset_type}),_jsx(Column,{field:"serial",header:"Serial"}),_jsx(Column,{field:"location",header:"Role",body:e=>e.location?((e,s)=>{const l=(t[e]??[]).find(e=>e.location===s);return l?roleLabel(l):s})(e.asset_type,e.location):_jsx("span",{style:{color:"#9ca3af"},children:"—"})}),_jsx(Column,{field:"status",header:"Status"}),_jsx(Column,{header:"Calibration",body:e=>e.current_calibration_id?_jsx("span",{title:e.current_calibration_id,children:"✓"}):_jsx("span",{style:{color:"#f59e0b"},children:"none"})})]}),_jsxs(Dialog,{header:"Add New Asset",visible:p.open,style:{width:"32rem"},onHide:()=>u(EMPTY_ADD),footer:_jsxs(_Fragment,{children:[_jsx(Button,{label:"Cancel",severity:"secondary",onClick:()=>u(EMPTY_ADD)}),_jsx(Button,{label:"Create",icon:"pi pi-check",onClick:async()=>{if(p.assetType)try{const e=await r("ams.create_asset",MessageType.Request,{asset_type:p.assetType,serial:p.serial,location:p.location});e?.success&&(u(EMPTY_ADD),await l(),e.data?.asset_id&&a({assetType:p.assetType,assetId:e.data.asset_id}))}catch(e){}},disabled:g})]}),children:[_jsxs("div",{style:{display:"grid",gridTemplateColumns:"auto 1fr",gap:"0.5rem 1rem",alignItems:"center"},children:[_jsx("label",{children:"Type *"}),_jsx(Dropdown,{value:p.assetType,options:m,onChange:e=>(e=>{const s=t[e]??[];1===s.length?u(t=>({...t,assetType:e,roleSelection:s[0].location,location:s[0].location})):u(t=>({...t,assetType:e,roleSelection:"",location:""}))})(e.value),placeholder:"Choose asset type"}),_jsx("label",{children:"Serial"}),_jsx(InputText,{value:p.serial,onChange:e=>u(t=>({...t,serial:e.target.value}))}),h&&_jsxs(_Fragment,{children:[_jsx("label",{children:"Role *"}),_jsx(Dropdown,{value:p.roleSelection,options:y,onChange:e=>{return t=e.value,void u(t===ROLE_OTHER?e=>({...e,roleSelection:ROLE_OTHER,location:""}):e=>({...e,roleSelection:t,location:t}));var t},placeholder:"Choose where this asset is mounted"}),p.roleSelection===ROLE_OTHER&&_jsxs(_Fragment,{children:[_jsx("label",{children:"Custom role"}),_jsx(InputText,{value:p.location,placeholder:"e.g. tsdr_secondary",onChange:e=>u(t=>({...t,location:e.target.value}))})]})]})]}),_jsxs("div",{style:{fontSize:"0.875rem",color:"#9ca3af",marginTop:"1rem"},children:[h&&x&&_jsxs(_Fragment,{children:[x.description&&_jsx("p",{style:{margin:"0 0 0.5rem 0"},children:x.description}),_jsxs("p",{style:{margin:"0 0 0.5rem 0",color:"#34d399"},children:["✓ ",roleUsageSummary(x)]})]}),h&&p.roleSelection===ROLE_OTHER&&_jsx("p",{style:{margin:"0 0 0.5rem 0",color:"#f59e0b"},children:"⚠ No test method on this machine references this custom role yet. The asset will be registered but won't be picked up at start_test unless you add an asset_ref to a test method's project.json."}),!h&&p.assetType&&_jsx("p",{style:{margin:"0 0 0.5rem 0"},children:"This asset type isn't selected by physical role on this machine — test methods reference it by ID instead. Just register the asset and pick it by ID on the Test Setup form when running a test."}),_jsxs("p",{style:{margin:0},children:["The asset_id is generated by the server (format:"," ",_jsxs("code",{children:[p.assetType?e[p.assetType]?.id_prefix??"A-":"A-","YYYYMMDDTHHMMSS"]}),"). Manufacturer serial is recorded for traceability but is not used as the unique key."]})]})]})]})};

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

@@ -1,4 +1,5 @@
-export { AmsProvider, useAms, useAmsSchemas, useAmsAlerts, useAmsAssets, useAmsSelection } from './AmsProvider';
+export { AmsProvider, useAms, useAmsSchemas, useAmsRoles, useAmsAlerts, useAmsAssets, useAmsSelection } from './AmsProvider';
+export type { AmsRole, AmsRoleRegistry } from './AmsProvider';
 export { AssetRegistryTable } from './AssetRegistryTable';
 export { AssetDetailView } from './AssetDetailView';
 export { CalibrationEntryDialog } from './CalibrationEntryDialog';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ams/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ams/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7H,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/components/ams/index.js

@@ -1 +1 @@
-export{AmsProvider,useAms,useAmsSchemas,useAmsAlerts,useAmsAssets,useAmsSelection}from"./AmsProvider";export{AssetRegistryTable}from"./AssetRegistryTable";export{AssetDetailView}from"./AssetDetailView";export{CalibrationEntryDialog}from"./CalibrationEntryDialog";export{SubLocationPicker}from"./SubLocationPicker";
+export{AmsProvider,useAms,useAmsSchemas,useAmsRoles,useAmsAlerts,useAmsAssets,useAmsSelection}from"./AmsProvider";export{AssetRegistryTable}from"./AssetRegistryTable";export{AssetDetailView}from"./AssetDetailView";export{CalibrationEntryDialog}from"./CalibrationEntryDialog";export{SubLocationPicker}from"./SubLocationPicker";

package/package.json

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

package/src/components/ams/AmsProvider.tsx

@@ -33,6 +33,24 @@ import { MessageType } from '../../hub/CommandMessage';
 export type AmsTypeSchema = any;
 export type AmsSchemaRegistry = { [assetType: string]: AmsTypeSchema };
 
+/**
+ * One role an asset_type can play, derived from a `select=by_location`
+ * `asset_ref` in `project.json::test_methods`. Used by the AMS UI to
+ * present a dropdown when registering a new asset, instead of forcing
+ * the operator to type a free-form `location` string.
+ */
+export interface AmsRole {
+    /** The literal `location` string the resolver matches against. */
+    location: string;
+    /** Human-readable label, e.g. "Triaxial Transducer (TSDR)". */
+    label: string | null;
+    /** Optional one-line explanation of what this role does. */
+    description: string | null;
+    /** Test method IDs whose start_test will pick up an asset in this role. */
+    used_by: string[];
+}
+export type AmsRoleRegistry = { [assetType: string]: AmsRole[] };
+
 export interface AmsAlerts {
     assetCount: number;
     calibrationOverdue: number;
@@ -56,6 +74,13 @@ export interface AmsSelection {
 export interface AmsContextValue {
     schemas: AmsSchemaRegistry;
     schemasLoaded: boolean;
+    /**
+     * Roles per asset_type. Empty array means the type isn't picked up
+     * via `by_location` anywhere in this project — registration UIs
+     * should hide the Role field for that type.
+     */
+    roles: AmsRoleRegistry;
+    rolesLoaded: boolean;
     alerts: AmsAlerts;
     assets: AmsAssetEntry[];
     refreshAssets: () => Promise<void>;
@@ -74,6 +99,8 @@ const EMPTY_ALERTS: AmsAlerts = {
 const AmsContext = createContext<AmsContextValue>({
     schemas: {},
     schemasLoaded: false,
+    roles: {},
+    rolesLoaded: false,
     alerts: EMPTY_ALERTS,
     assets: [],
     refreshAssets: async () => {},
@@ -98,6 +125,8 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
 
     const [schemas, setSchemas] = useState<AmsSchemaRegistry>({});
     const [schemasLoaded, setSchemasLoaded] = useState(false);
+    const [roles, setRoles] = useState<AmsRoleRegistry>({});
+    const [rolesLoaded, setRolesLoaded] = useState(false);
     const [alerts, setAlerts] = useState<AmsAlerts>(EMPTY_ALERTS);
     const [assets, setAssets] = useState<AmsAssetEntry[]>([]);
     const [selection, setSelectionState] = useState<AmsSelection>({ assetType: null, assetId: null });
@@ -107,7 +136,7 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
     }, []);
 
     // -----------------------------------------------------------------
-    // Schema load — once on mount.
+    // Schema + role load — once on mount.
     // -----------------------------------------------------------------
     useEffect(() => {
         let cancelled = false;
@@ -125,6 +154,23 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
                 console.error('[AmsProvider] ams.list_schemas threw:', e);
             }
         })();
+        (async () => {
+            try {
+                const resp: any = await invoke('ams.list_roles' as any, MessageType.Request, {} as any);
+                if (cancelled) return;
+                if (resp?.success && resp.data) {
+                    setRoles((resp.data.roles ?? {}) as AmsRoleRegistry);
+                    setRolesLoaded(true);
+                } else {
+                    // Server may not yet support list_roles — degrade gracefully.
+                    console.warn('[AmsProvider] ams.list_roles failed:', resp?.error_message);
+                    setRolesLoaded(true);
+                }
+            } catch (e) {
+                console.error('[AmsProvider] ams.list_roles threw:', e);
+                setRolesLoaded(true);
+            }
+        })();
         return () => { cancelled = true; };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
@@ -191,6 +237,8 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
     const value = useMemo<AmsContextValue>(() => ({
         schemas,
         schemasLoaded,
+        roles,
+        rolesLoaded,
         alerts,
         assets,
         refreshAssets,
@@ -200,7 +248,7 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
         readUsage,
         selection,
         setSelection,
-    }), [schemas, schemasLoaded, alerts, assets, refreshAssets, readAsset, listCalibrations, readCalibration, readUsage, selection, setSelection]);
+    }), [schemas, schemasLoaded, roles, rolesLoaded, alerts, assets, refreshAssets, readAsset, listCalibrations, readCalibration, readUsage, selection, setSelection]);
 
     return <AmsContext.Provider value={value}>{children}</AmsContext.Provider>;
 };
@@ -211,6 +259,7 @@ export const AmsProvider: React.FC<AmsProviderProps> = ({ children }) => {
 
 export const useAms          = () => useContext(AmsContext);
 export const useAmsSchemas   = () => useContext(AmsContext).schemas;
+export const useAmsRoles     = () => useContext(AmsContext).roles;
 export const useAmsAlerts    = () => useContext(AmsContext).alerts;
 export const useAmsAssets    = () => useContext(AmsContext).assets;
 export const useAmsSelection = () => {

package/src/components/ams/AssetDetailView.tsx

@@ -14,7 +14,7 @@ import { useAms } from './AmsProvider';
 import { CalibrationEntryDialog } from './CalibrationEntryDialog';
 
 export const AssetDetailView: React.FC = () => {
-    const { selection, schemas, readAsset, listCalibrations, readCalibration, readUsage } = useAms();
+    const { selection, schemas, roles, readAsset, listCalibrations, readCalibration, readUsage } = useAms();
     const [asset, setAsset] = useState<any | null>(null);
     const [cals, setCals]   = useState<any[]>([]);
     const [usage, setUsage] = useState<any | null>(null);
@@ -48,6 +48,13 @@ export const AssetDetailView: React.FC = () => {
     }
 
     const typeLabel = schemas[asset.asset_type]?.label ?? asset.asset_type;
+    // Resolve the asset's location string back to a human-readable role
+    // label when one is declared in project.json — e.g. "Triaxial
+    // Transducer (TSDR)" instead of `tsdr`. Falls back to the raw
+    // location string for assets registered with custom roles or
+    // running against an older project.
+    const roleHit = roles[asset.asset_type]?.find(r => r.location === asset.location);
+    const roleLabel = roleHit ? (roleHit.label ?? roleHit.location) : asset.location;
 
     return (
         <div style={{ display: 'flex', flexDirection: 'column', gap: '1rem' }}>
@@ -56,7 +63,7 @@ export const AssetDetailView: React.FC = () => {
                 <strong>Type</strong>     <span>{typeLabel}</span>
 
                 <strong>Serial</strong>   <span>{asset.serial || <em style={{ color: '#9ca3af' }}>(none)</em>}</span>
-                <strong>Location</strong> <span>{asset.location || <em style={{ color: '#9ca3af' }}>(none)</em>}</span>
+                <strong>Role</strong>     <span>{roleLabel || <em style={{ color: '#9ca3af' }}>(none)</em>}</span>
 
                 <strong>Status</strong>   <span>{asset.status}</span>
                 <strong>Installed</strong>

package/src/components/ams/AssetRegistryTable.tsx

@@ -14,19 +14,46 @@ import { InputText } from 'primereact/inputtext';
 import { Dialog } from 'primereact/dialog';
 import { EventEmitterContext } from '../../core/EventEmitterContext';
 import { MessageType } from '../../hub/CommandMessage';
-import { useAms, type AmsAssetEntry } from './AmsProvider';
+import { useAms, type AmsAssetEntry, type AmsRole } from './AmsProvider';
+
+// Sentinel value for the "Other..." dropdown option, which lets the
+// operator type a free-form role for the rare case (custom builds,
+// future test methods not yet declared in project.json).
+const ROLE_OTHER = '__other__';
 
 interface AddDialogState {
     open: boolean;
     assetType: string;
     serial: string;
+    /** Currently-selected role from the dropdown, or ROLE_OTHER when typing. */
+    roleSelection: string;
+    /** Free-form text — used directly when roleSelection===ROLE_OTHER, or
+     *  matches `roleSelection` for known roles. This is what gets sent
+     *  to the server as `location`. */
     location: string;
 }
 
-const EMPTY_ADD: AddDialogState = { open: false, assetType: '', serial: '', location: '' };
+const EMPTY_ADD: AddDialogState = {
+    open: false, assetType: '', serial: '', roleSelection: '', location: '',
+};
+
+/** Pretty label for one role in the dropdown. */
+function roleLabel(r: AmsRole): string {
+    return r.label ?? r.location;
+}
+
+/** Human-readable summary of which test methods will pick up an asset
+ *  in this role at start_test. Drives the match-indicator below the
+ *  Role dropdown so the operator can see they're configuring the right
+ *  thing before saving. */
+function roleUsageSummary(r: AmsRole): string {
+    if (r.used_by.length === 0) return 'No test methods reference this role.';
+    if (r.used_by.length === 1) return `Used by: ${r.used_by[0]}`;
+    return `Used by: ${r.used_by.join(', ')}`;
+}
 
 export const AssetRegistryTable: React.FC = () => {
-    const { schemas, assets, refreshAssets, setSelection, selection } = useAms();
+    const { schemas, roles, assets, refreshAssets, setSelection, selection } = useAms();
     const { invoke } = useContext(EventEmitterContext);
 
     const [filterType, setFilterType] = useState<string | null>(null);
@@ -38,6 +65,42 @@ export const AssetRegistryTable: React.FC = () => {
         [schemas],
     );
 
+    /** Roles available for the type currently picked in the Add dialog,
+     *  plus the "Other..." escape hatch. Empty when the type isn't
+     *  referenced by `by_location` anywhere — in that case we hide the
+     *  Role field entirely. */
+    const rolesForType: AmsRole[] = useMemo(
+        () => (addState.assetType ? roles[addState.assetType] ?? [] : []),
+        [addState.assetType, roles],
+    );
+
+    const typeHasRoles = rolesForType.length > 0;
+
+    const roleDropdownOptions = useMemo(() => {
+        const opts = rolesForType.map(r => ({
+            label: roleLabel(r),
+            value: r.location,
+        }));
+        opts.push({ label: 'Other (advanced — type a custom role)', value: ROLE_OTHER });
+        return opts;
+    }, [rolesForType]);
+
+    /** The role descriptor (if any) backing the current selection. Used
+     *  to render the description and match-indicator under the dropdown. */
+    const selectedRole: AmsRole | null = useMemo(() => {
+        if (addState.roleSelection === ROLE_OTHER) return null;
+        return rolesForType.find(r => r.location === addState.roleSelection) ?? null;
+    }, [addState.roleSelection, rolesForType]);
+
+    /** Resolve label-for-display against the role registry. Used in the
+     *  table's Role column body to show "Triaxial Transducer (TSDR)"
+     *  instead of `tsdr` when there's a matching role. */
+    const resolveRoleLabel = (assetType: string, location: string): string => {
+        const list = roles[assetType] ?? [];
+        const hit = list.find(r => r.location === location);
+        return hit ? roleLabel(hit) : location;
+    };
+
     const filtered = useMemo(() => {
         return assets.filter(a => {
             if (filterType && a.asset_type !== filterType) return false;
@@ -68,6 +131,38 @@ export const AssetRegistryTable: React.FC = () => {
         }
     };
 
+    /** When the operator changes asset type in the dialog, pre-select
+     *  the only role if there's exactly one (the common case for fixed
+     *  hardware), or leave it empty so they make an explicit choice
+     *  when there are multiple. Hide the field entirely when none. */
+    const onAssetTypeChange = (newType: string) => {
+        const list = roles[newType] ?? [];
+        if (list.length === 1) {
+            setAddState(s => ({ ...s, assetType: newType, roleSelection: list[0].location, location: list[0].location }));
+        } else {
+            setAddState(s => ({ ...s, assetType: newType, roleSelection: '', location: '' }));
+        }
+    };
+
+    /** Role dropdown change handler. ROLE_OTHER puts us into free-form
+     *  mode where the operator types into a text field. */
+    const onRoleChange = (value: string) => {
+        if (value === ROLE_OTHER) {
+            setAddState(s => ({ ...s, roleSelection: ROLE_OTHER, location: '' }));
+        } else {
+            setAddState(s => ({ ...s, roleSelection: value, location: value }));
+        }
+    };
+
+    /** Disable Create until the operator has picked a role (or supplied
+     *  free-form text). Asset types with no roles bypass this check. */
+    const createDisabled =
+        !addState.assetType ||
+        (typeHasRoles && (
+            addState.roleSelection === '' ||
+            (addState.roleSelection === ROLE_OTHER && !addState.location.trim())
+        ));
+
     return (
         <div style={{ display: 'flex', flexDirection: 'column', gap: '0.5rem' }}>
             <div style={{ display: 'flex', gap: '0.75rem', alignItems: 'center' }}>
@@ -120,7 +215,13 @@ export const AssetRegistryTable: React.FC = () => {
                     body={(r: AmsAssetEntry) => schemas[r.asset_type]?.label ?? r.asset_type}
                 />
                 <Column field="serial"     header="Serial" />
-                <Column field="location"   header="Location" />
+                <Column field="location"   header="Role"
+                    body={(r: AmsAssetEntry) =>
+                        r.location
+                            ? resolveRoleLabel(r.asset_type, r.location)
+                            : <span style={{ color: '#9ca3af' }}>—</span>
+                    }
+                />
                 <Column field="status"     header="Status" />
                 <Column header="Calibration"
                     body={(r: AmsAssetEntry) =>
@@ -141,7 +242,7 @@ export const AssetRegistryTable: React.FC = () => {
                         <Button label="Cancel" severity="secondary" onClick={() => setAddState(EMPTY_ADD)} />
                         <Button label="Create" icon="pi pi-check"
                             onClick={onCreate}
-                            disabled={!addState.assetType}
+                            disabled={createDisabled}
                         />
                     </>
                 }
@@ -151,20 +252,78 @@ export const AssetRegistryTable: React.FC = () => {
                     <Dropdown
                         value={addState.assetType}
                         options={typeOptions}
-                        onChange={(e) => setAddState(s => ({ ...s, assetType: e.value }))}
+                        onChange={(e) => onAssetTypeChange(e.value)}
                         placeholder="Choose asset type"
                     />
                     <label>Serial</label>
                     <InputText value={addState.serial}
                         onChange={(e) => setAddState(s => ({ ...s, serial: e.target.value }))} />
-                    <label>Location</label>
-                    <InputText value={addState.location}
-                        onChange={(e) => setAddState(s => ({ ...s, location: e.target.value }))} />
+
+                    {/* Role field: only shown when this asset_type has at
+                        least one declared role in project.json. Asset
+                        types referenced only by_id_field (e.g. surfaces
+                        picked per test by ID) skip this entirely. */}
+                    {typeHasRoles && (
+                        <>
+                            <label>Role *</label>
+                            <Dropdown
+                                value={addState.roleSelection}
+                                options={roleDropdownOptions}
+                                onChange={(e) => onRoleChange(e.value)}
+                                placeholder="Choose where this asset is mounted"
+                            />
+                            {addState.roleSelection === ROLE_OTHER && (
+                                <>
+                                    <label>Custom role</label>
+                                    <InputText
+                                        value={addState.location}
+                                        placeholder="e.g. tsdr_secondary"
+                                        onChange={(e) => setAddState(s => ({ ...s, location: e.target.value }))}
+                                    />
+                                </>
+                            )}
+                        </>
+                    )}
+                </div>
+
+                {/* Help text + match indicator. Updates as the operator
+                    picks a role so they see exactly which test methods
+                    will pick up the asset they're about to register. */}
+                <div style={{ fontSize: '0.875rem', color: '#9ca3af', marginTop: '1rem' }}>
+                    {typeHasRoles && selectedRole && (
+                        <>
+                            {selectedRole.description && (
+                                <p style={{ margin: '0 0 0.5rem 0' }}>{selectedRole.description}</p>
+                            )}
+                            <p style={{ margin: '0 0 0.5rem 0', color: '#34d399' }}>
+                                ✓ {roleUsageSummary(selectedRole)}
+                            </p>
+                        </>
+                    )}
+                    {typeHasRoles && addState.roleSelection === ROLE_OTHER && (
+                        <p style={{ margin: '0 0 0.5rem 0', color: '#f59e0b' }}>
+                            ⚠ No test method on this machine references this custom role yet.
+                            The asset will be registered but won't be picked up at start_test
+                            unless you add an asset_ref to a test method's project.json.
+                        </p>
+                    )}
+                    {!typeHasRoles && addState.assetType && (
+                        <p style={{ margin: '0 0 0.5rem 0' }}>
+                            This asset type isn't selected by physical role on this machine —
+                            test methods reference it by ID instead. Just register the asset
+                            and pick it by ID on the Test Setup form when running a test.
+                        </p>
+                    )}
+                    <p style={{ margin: 0 }}>
+                        The asset_id is generated by the server (format:{' '}
+                        <code>
+                            {addState.assetType ? (schemas[addState.assetType]?.id_prefix ?? 'A-') : 'A-'}
+                            YYYYMMDDTHHMMSS
+                        </code>
+                        ). Manufacturer serial is recorded for traceability but is not used
+                        as the unique key.
+                    </p>
                 </div>
-                <p style={{ fontSize: '0.875rem', color: '#9ca3af', marginTop: '1rem' }}>
-                    The asset_id is generated by the server (format: <code>{addState.assetType ? (schemas[addState.assetType]?.id_prefix ?? 'A-') : 'A-'}YYYYMMDDTHHMMSS</code>).
-                    Manufacturer serial is recorded for traceability but is not used as the unique key.
-                </p>
             </Dialog>
         </div>
     );

package/src/components/ams/index.ts

@@ -5,7 +5,8 @@
  * See autocore-server/doc/ams_product_plan.md for the full design.
  */
 
-export { AmsProvider, useAms, useAmsSchemas, useAmsAlerts, useAmsAssets, useAmsSelection } from './AmsProvider';
+export { AmsProvider, useAms, useAmsSchemas, useAmsRoles, useAmsAlerts, useAmsAssets, useAmsSelection } from './AmsProvider';
+export type { AmsRole, AmsRoleRegistry } from './AmsProvider';
 export { AssetRegistryTable } from './AssetRegistryTable';
 export { AssetDetailView } from './AssetDetailView';
 export { CalibrationEntryDialog } from './CalibrationEntryDialog';