codicent-app-sdk 0.5.7 → 0.6.0

package/dist/cjs/pages/Snap.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),t=require("@fluentui/react-components"),o=require("react-router-dom");require("../components/Markdown.js"),require("../components/Textarea.js"),require("../components/Button.js"),require("../components/CompoundButton.js");var s=require("../components/Text.js");require("../components/Spinner.js"),require("../components/TextHeader.js"),require("../components/TypingIndicator.js"),require("../components/Dialog.js"),require("../components/ChatInput.js");var i=require("../components/CombinedPlaceholderDialog.js");require("../components/ChatMessage.js"),require("../components/Header.js"),require("@fluentui/react-icons"),require("../services/codicent.js"),require("../utils/MessageContent.js"),require("../node_modules/tinycolor2/esm/tinycolor.js"),require("../_virtual/index.js"),require("../config/index.js"),require("../utils/cacheManager.js"),require("../lib/wavtools/lib/wav_packer.js"),require("../lib/wavtools/lib/analysis/audio_analysis.js"),require("../lib/wavtools/lib/wav_stream_player.js"),require("../lib/wavtools/lib/wav_recorder.js"),require("exceljs"),require("./AppFrame.js"),require("./Canvas.js"),require("./Chat.js"),require("./Compose.js"),require("./Search.js"),require("./Menu.js"),require("./Log.js"),require("./Login.js"),require("./Home.js"),require("./ListPage.js"),require("./CrmPage.js"),require("./CrmPagePersistent.js"),require("./ImageView.js"),require("./FormInvite.js"),require("./FormAccept.js"),require("./Sales.js"),require("./Purchase.js"),require("../components/Content.js"),require("../components/Page.js"),require("./QrScan.js");var n=require("../hooks/useLocalization.js");require("../components/FileThumbnail.js"),require("react-dom/client"),require("../node_modules/@auth0/auth0-react/dist/auth0-react.esm.js");var a=require("../hooks/useTemplateVariables.js");require("../hooks/useAppStyles.js");var u=require("../components/MessageInput.js");require("../components/UploadFile.js");var c=require("../components/SnapFooter.js");require("../components/Profile.js"),require("../components/MessageItem.js"),require("../components/AiInput.js"),require("../components/SearchBox.js"),require("../components/DataMessagePicker.js"),require("../components/HtmlView.js"),require("../components/Footer.js"),require("../components/QrCodeDialog.js"),require("../components/QrScanner.js"),require("../components/OfflineMessage.js"),require("../components/LanguageSelector.js"),require("../components/ListView.js"),require("../components/RecordModal.js"),require("../components/BulkUploadDialog.js"),require("../components/CookieBanner.js");const l=t.makeStyles({container:{position:"relative",height:"100vh",width:"100vw",overflow:"auto"},flashOverlay:{position:"fixed",top:0,left:0,width:"100%",height:"100%",backgroundColor:"transparent",transition:"background-color 0.2s ease-out",pointerEvents:"none",zIndex:3},video:{position:"absolute",top:0,left:0,width:"100%",height:"100%",objectFit:"cover",zIndex:1},canvas:{display:"none"},bottomControls:{position:"fixed",bottom:"100px",width:"100%",display:"flex",justifyContent:"center",alignItems:"center",zIndex:2,boxSizing:"border-box"},controlContainer:{width:"100%",maxWidth:"600px",position:"relative"},sendButton:{position:"absolute",right:"10px",bottom:"10px",width:"50px",height:"50px",borderRadius:"50%",backgroundColor:"#0078d4",color:"white",border:"none",cursor:"pointer",display:"flex",justifyContent:"center",alignItems:"center"},topControls:{position:"fixed",top:"20px",width:"100%",display:"flex",justifyContent:"space-between",alignItems:"center",zIndex:2,padding:"0 10px",boxSizing:"border-box"},backButton:{width:"60px",height:"60px",borderRadius:"50%",backgroundColor:"transparent",color:"white",border:"none",cursor:"pointer"},input:{padding:"5px",width:"200px",fontSize:"larger",backgroundColor:"#fff8"},bottomButtons:{position:"fixed",bottom:"0px",width:"100%",display:"flex",justifyContent:"space-around",alignItems:"center",zIndex:2,boxSizing:"border-box"},iconButton:{width:"60px",height:"60px",borderRadius:"50%",backgroundColor:"transparent",color:"white",border:"none",cursor:"pointer"},centerText:{position:"fixed",top:"30%",left:"50%",transform:"translate(-50%, -50%)",zIndex:2,textAlign:"center"}});exports.default=({state:t,audio:d})=>{const p=l(),{service:m}=t,[h,j]=r.useState(null),[g,q]=r.useState(!0),x=r.useRef(null),f=r.useRef(null),[w]=o.useSearchParams(),v=w.get("extra"),b=w.get("template"),[C,y]=r.useState(""),[S]=r.useState("log"),k=r.useMemo((()=>new Audio("/audio/camera.mp3")),[]),[I,F]=r.useState(!1),M=o.useNavigate(),{t:P}=n.default(),{extractTemplateVariables:T}=a.useTemplateVariables(m.uploadFile),[z,V]=r.useState(T(b||"")),[B,E]=r.useState(z.length>0),[$,_]=r.useState(""),[N,D]=r.useState(100),L=r.useCallback((()=>z.map((e=>`#${e.value}`)).join(" ")),[z]);r.useEffect((()=>{const e=L();_(`${v?" #"+v:""}${e.length>0?" "+e:""}`.trim())}),[z,v,L]),r.useEffect((()=>{if(window.visualViewport){const e=()=>{const e=window.visualViewport?window.innerHeight-window.visualViewport.height:0;D(e>150?e+20:100)};return window.visualViewport.addEventListener("resize",e),e(),()=>{window.visualViewport&&window.visualViewport.removeEventListener("resize",e)}}}),[]);const H=async e=>{try{const r=new FormData;r.append("file",e);const t=await m.uploadFile(e.name,r),o=L(),s=`${S?" #"+S:""}${v?" #"+v:""}${o.length>0?" "+o:""} #photo #file:${t}`;await m.sendMessage(s)}catch(e){alert(P("Failed to send image:")+" "+e)}};return r.useEffect((()=>()=>{h&&h.getTracks().forEach((e=>e.stop()))}),[h]),e.jsxs("div",{className:p.container,children:[e.jsx("div",{className:p.flashOverlay,style:{backgroundColor:I?"#ffffff":"transparent"}}),e.jsx("video",{ref:x,autoPlay:!0,playsInline:!0,className:p.video}),e.jsx("canvas",{ref:f,width:"640",height:"480",className:p.canvas}),!h&&e.jsx(s.Text,{weight:"semibold",size:400,className:p.centerText,children:P("Klicka på Byt kamera för att starta!")}),e.jsx("div",{className:p.bottomControls,style:{bottom:`${N}px`},children:e.jsx("div",{className:p.controlContainer,children:e.jsx(u.default,{onSend:async()=>{if(""===C.trim())return;const e=L(),r=`${S?" #"+S:""}${v?" #"+v:""}${e.length>0?" "+e:""} ${C}`;try{await m.sendMessage(r),y("")}catch(e){alert(P("Failed to send message: ")+e)}},rows:4,onChange:y})})}),e.jsx("div",{className:p.bottomButtons,children:e.jsx(c.default,{audio:d,onHome:()=>M("/"),onTakePhoto:()=>{const e=f.current,r=x.current;if(e&&r){e.width=r.videoWidth,e.height=r.videoHeight;const t=e.getContext("2d");t&&(k.play(),F(!0),setTimeout((()=>F(!1)),100),t.drawImage(r,0,0,e.width,e.height),e.toBlob((e=>{if(e){const r=new File([e],"snapshot.png",{type:"image/png"});H(r)}})))}},onSwichCamera:()=>{q((e=>!e)),(async()=>{h&&h.getTracks().forEach((e=>e.stop()));const e={video:{facingMode:g?"user":"environment"},audio:!1};try{const r=await navigator.mediaDevices.getUserMedia(e);j(r),x.current&&(x.current.srcObject=r,x.current.play())}catch(e){console.error("Error accessing the camera: ",e),e instanceof Error?alert(P("Error accessing the camera:")+" "+e.message):alert(P("Error accessing the camera"))}})()},tag:$})}),e.jsx(i.CombinedPlaceholderDialog,{open:B,templateVariables:z,filePlaceholders:[],onTemplateVariablesChange:V,onFilePlaceholdersChange:()=>{},onConfirm:()=>E(!1),onCancel:()=>{E(!1),M(-1)},uploadFile:m.uploadFile})]})};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("react"),t=require("@fluentui/react-components"),o=require("react-router-dom");require("../components/Markdown.js"),require("../components/Textarea.js"),require("../components/Button.js"),require("../components/CompoundButton.js");var i=require("../components/Text.js");require("../components/Spinner.js"),require("../components/TextHeader.js"),require("../components/TypingIndicator.js"),require("../components/Dialog.js"),require("../components/ChatInput.js");var s=require("../components/CombinedPlaceholderDialog.js");require("../components/ChatMessage.js"),require("../components/Header.js"),require("@fluentui/react-icons"),require("../services/codicent.js"),require("../utils/MessageContent.js"),require("../node_modules/tinycolor2/esm/tinycolor.js"),require("../_virtual/index.js"),require("../config/index.js"),require("../utils/cacheManager.js"),require("../lib/wavtools/lib/wav_packer.js"),require("../lib/wavtools/lib/analysis/audio_analysis.js"),require("../lib/wavtools/lib/wav_stream_player.js"),require("../lib/wavtools/lib/wav_recorder.js"),require("exceljs"),require("./AppFrame.js"),require("./Canvas.js"),require("./Chat.js"),require("./Compose.js"),require("./Search.js"),require("./Menu.js"),require("./Log.js"),require("./Login.js"),require("./Home.js"),require("./ListPage.js"),require("./CrmPage.js"),require("./CrmPagePersistent.js"),require("./ImageView.js"),require("./FormInvite.js"),require("./FormAccept.js"),require("./Sales.js"),require("./Purchase.js"),require("../components/Content.js"),require("../components/Page.js"),require("./QrScan.js");var n=require("../hooks/useLocalization.js");require("../components/FileThumbnail.js"),require("react-dom/client"),require("../node_modules/@auth0/auth0-react/dist/auth0-react.esm.js");var a=require("../hooks/useTemplateVariables.js");require("../hooks/useAppStyles.js");var u=require("../components/MessageInput.js");require("../components/UploadFile.js");var c=require("../components/SnapFooter.js");require("../components/Profile.js"),require("../components/MessageItem.js"),require("../components/AiInput.js"),require("../components/SearchBox.js"),require("../components/DataMessagePicker.js"),require("../components/HtmlView.js"),require("../components/Footer.js"),require("../components/QrCodeDialog.js"),require("../components/QrScanner.js"),require("../components/OfflineMessage.js"),require("../components/LanguageSelector.js"),require("../components/ListView.js"),require("../components/RecordModal.js"),require("../components/BulkUploadDialog.js"),require("../components/CookieBanner.js"),require("../components/audit/AuditCircularProgress.js"),require("../components/audit/AuditHorizontalProgress.js"),require("../components/audit/AuditRoleIndicator.js"),require("../components/audit/AuditUnitSwitcher.js"),require("../components/audit/AuditAnswerCell.js"),require("../components/audit/AuditSearchBar.js"),require("../components/audit/AuditFilterChips.js"),require("../components/audit/AuditFilterBar.js"),require("../components/audit/AuditGroupsProgress.js"),require("../components/audit/AuditSummaryDashboard.js"),require("../components/audit/AuditRequirementDialog.js"),require("../components/audit/AuditUnitExportDialog.js"),require("../components/audit/AuditUnitImportDialog.js"),require("../components/audit/AuditBulkExportDialog.js"),require("../components/audit/AuditBulkUploadDialog.js"),require("../components/audit/AuditSortPresets.js");const l=t.makeStyles({container:{position:"relative",height:"100vh",width:"100vw",overflow:"auto"},flashOverlay:{position:"fixed",top:0,left:0,width:"100%",height:"100%",backgroundColor:"transparent",transition:"background-color 0.2s ease-out",pointerEvents:"none",zIndex:3},video:{position:"absolute",top:0,left:0,width:"100%",height:"100%",objectFit:"cover",zIndex:1},canvas:{display:"none"},bottomControls:{position:"fixed",bottom:"100px",width:"100%",display:"flex",justifyContent:"center",alignItems:"center",zIndex:2,boxSizing:"border-box"},controlContainer:{width:"100%",maxWidth:"600px",position:"relative"},sendButton:{position:"absolute",right:"10px",bottom:"10px",width:"50px",height:"50px",borderRadius:"50%",backgroundColor:"#0078d4",color:"white",border:"none",cursor:"pointer",display:"flex",justifyContent:"center",alignItems:"center"},topControls:{position:"fixed",top:"20px",width:"100%",display:"flex",justifyContent:"space-between",alignItems:"center",zIndex:2,padding:"0 10px",boxSizing:"border-box"},backButton:{width:"60px",height:"60px",borderRadius:"50%",backgroundColor:"transparent",color:"white",border:"none",cursor:"pointer"},input:{padding:"5px",width:"200px",fontSize:"larger",backgroundColor:"#fff8"},bottomButtons:{position:"fixed",bottom:"0px",width:"100%",display:"flex",justifyContent:"space-around",alignItems:"center",zIndex:2,boxSizing:"border-box"},iconButton:{width:"60px",height:"60px",borderRadius:"50%",backgroundColor:"transparent",color:"white",border:"none",cursor:"pointer"},centerText:{position:"fixed",top:"30%",left:"50%",transform:"translate(-50%, -50%)",zIndex:2,textAlign:"center"}});exports.default=({state:t,audio:d})=>{const p=l(),{service:m}=t,[j,g]=r.useState(null),[h,q]=r.useState(!0),x=r.useRef(null),f=r.useRef(null),[w]=o.useSearchParams(),b=w.get("extra"),v=w.get("template"),[C,y]=r.useState(""),[S]=r.useState("log"),k=r.useMemo((()=>new Audio("/audio/camera.mp3")),[]),[A,I]=r.useState(!1),P=o.useNavigate(),{t:F}=n.default(),{extractTemplateVariables:B}=a.useTemplateVariables(m.uploadFile),[M,T]=r.useState(B(v||"")),[z,D]=r.useState(M.length>0),[E,V]=r.useState(""),[$,_]=r.useState(100),N=r.useCallback((()=>M.map((e=>`#${e.value}`)).join(" ")),[M]);r.useEffect((()=>{const e=N();V(`${b?" #"+b:""}${e.length>0?" "+e:""}`.trim())}),[M,b,N]),r.useEffect((()=>{if(window.visualViewport){const e=()=>{const e=window.visualViewport?window.innerHeight-window.visualViewport.height:0;_(e>150?e+20:100)};return window.visualViewport.addEventListener("resize",e),e(),()=>{window.visualViewport&&window.visualViewport.removeEventListener("resize",e)}}}),[]);const H=async e=>{try{const r=new FormData;r.append("file",e);const t=await m.uploadFile(e.name,r),o=N(),i=`${S?" #"+S:""}${b?" #"+b:""}${o.length>0?" "+o:""} #photo #file:${t}`;await m.sendMessage(i)}catch(e){alert(F("Failed to send image:")+" "+e)}};return r.useEffect((()=>()=>{j&&j.getTracks().forEach((e=>e.stop()))}),[j]),e.jsxs("div",{className:p.container,children:[e.jsx("div",{className:p.flashOverlay,style:{backgroundColor:A?"#ffffff":"transparent"}}),e.jsx("video",{ref:x,autoPlay:!0,playsInline:!0,className:p.video}),e.jsx("canvas",{ref:f,width:"640",height:"480",className:p.canvas}),!j&&e.jsx(i.Text,{weight:"semibold",size:400,className:p.centerText,children:F("Klicka på Byt kamera för att starta!")}),e.jsx("div",{className:p.bottomControls,style:{bottom:`${$}px`},children:e.jsx("div",{className:p.controlContainer,children:e.jsx(u.default,{onSend:async()=>{if(""===C.trim())return;const e=N(),r=`${S?" #"+S:""}${b?" #"+b:""}${e.length>0?" "+e:""} ${C}`;try{await m.sendMessage(r),y("")}catch(e){alert(F("Failed to send message: ")+e)}},rows:4,onChange:y})})}),e.jsx("div",{className:p.bottomButtons,children:e.jsx(c.default,{audio:d,onHome:()=>P("/"),onTakePhoto:()=>{const e=f.current,r=x.current;if(e&&r){e.width=r.videoWidth,e.height=r.videoHeight;const t=e.getContext("2d");t&&(k.play(),I(!0),setTimeout((()=>I(!1)),100),t.drawImage(r,0,0,e.width,e.height),e.toBlob((e=>{if(e){const r=new File([e],"snapshot.png",{type:"image/png"});H(r)}})))}},onSwichCamera:()=>{q((e=>!e)),(async()=>{j&&j.getTracks().forEach((e=>e.stop()));const e={video:{facingMode:h?"user":"environment"},audio:!1};try{const r=await navigator.mediaDevices.getUserMedia(e);g(r),x.current&&(x.current.srcObject=r,x.current.play())}catch(e){console.error("Error accessing the camera: ",e),e instanceof Error?alert(F("Error accessing the camera:")+" "+e.message):alert(F("Error accessing the camera"))}})()},tag:E})}),e.jsx(s.CombinedPlaceholderDialog,{open:z,templateVariables:M,filePlaceholders:[],onTemplateVariablesChange:T,onFilePlaceholdersChange:()=>{},onConfirm:()=>D(!1),onCancel:()=>{D(!1),P(-1)},uploadFile:m.uploadFile})]})};

package/dist/cjs/types/audit.d.ts

@@ -0,0 +1,365 @@
+/**
+ * @fileoverview Generic audit feature type definitions for codicent-app-sdk.
+ * Supports dealer audits, safety rounds (skyddsrond), HR audits, development reviews, etc.
+ * All domain-specific terminology is configurable via AuditConfig.
+ * @module codicent-app-sdk/types/audit
+ * @public
+ */
+/** Determines how compliance is captured for each requirement. */
+export type AuditAnswerMode = "checkbox" | "enum";
+/**
+ * One selectable answer option used when answerMode === "enum".
+ * Each option declares whether selecting it counts as compliant.
+ */
+export interface AuditAnswerOption {
+    /** Stored value (e.g. "yes", "no", "na") */
+    value: string;
+    /** Display label (e.g. "Ja", "Nej", "Ej tillämpligt") */
+    label: string;
+    /** Whether this option is considered compliant for statistics */
+    isCompliant: boolean;
+}
+/**
+ * Optional overrides for domain-specific terminology.
+ * All fields default to generic English terms if not provided.
+ * Examples: "Dealer" / "Unit" / "Station" / "Employee"
+ */
+export interface AuditTerminology {
+    /** Display title for the audit application (default: "Audit") */
+    appTitle?: string;
+    /** Singular term for the audited entity (default: "Unit") */
+    unit?: string;
+    /** Plural term for the audited entity (default: "Units") */
+    unitPlural?: string;
+    /** Singular term for the oversight role's managed scope (default: "Manager Area") */
+    managerArea?: string;
+    /** Singular term for a requirement group (default: "Group") */
+    group?: string;
+    /** Plural term for requirement groups (default: "Groups") */
+    groupPlural?: string;
+    /** Singular term for a group sub-category (default: "Category") */
+    category?: string;
+    /** Plural term for group sub-categories (default: "Categories") */
+    categoryPlural?: string;
+    /** Singular term for a single requirement (default: "Requirement") */
+    requirement?: string;
+    /** Plural term for requirements (default: "Requirements") */
+    requirementPlural?: string;
+    /** Label for the compliance answer column (default: "Compliant") */
+    compliantLabel?: string;
+    /** Label for non-compliant state (default: "Non-compliant") */
+    nonCompliantLabel?: string;
+}
+/**
+ * Optional custom display labels for the three fixed role tiers.
+ */
+export interface AuditRoleLabels {
+    /** Display label for Admin tier (default: "Admin") */
+    admin?: string;
+    /** Display label for Manager tier (default: "Manager") */
+    manager?: string;
+    /** Display label for Auditor tier (default: "Auditor") */
+    auditor?: string;
+}
+/**
+ * Codicent message tag names used by the audit feature.
+ * Override any field to use custom tag names for isolation between audit types
+ * in the same Codicent project.
+ */
+export interface AuditTagConfig {
+    /** Tag for requirement definitions (default: "audit_req") */
+    requirement: string;
+    /** Tag for audit answers (default: "audit_answer") */
+    answer: string;
+    /** Tag for unit/entity records (default: "audit_unit") */
+    unit: string;
+    /** Tag for user role assignments (default: "user_role") */
+    role: string;
+    /** Tag for runtime topology overrides (default: "audit_topology") */
+    topology: string;
+}
+/**
+ * Mapping of JSON field names within unit records.
+ * Allows using existing data structures (e.g. penta_audit's #audit_bpm) without migration.
+ */
+export interface AuditUnitFieldMapping {
+    /** Field containing the unit's display name (default: "Name") */
+    nameField: string;
+    /** Field containing the unit's unique ID / handle (default: "UnitId") */
+    idField: string;
+    /** Field containing the market/manager area this unit belongs to (default: "MarketArea") */
+    marketAreaField: string;
+    /** Field containing the tags/categories assigned to this unit for requirement allocation (default: "Tags") */
+    tagsField: string;
+}
+/**
+ * Mapping of field names within requirement records.
+ */
+export interface AuditRequirementFieldMapping {
+    /** Field for the requirement group / top-level category (default: "Standard") */
+    groupField: string;
+    /** Field for the sub-category within a group (default: "Area") */
+    categoryField: string;
+    /** Field for the requirement title/name (default: "Requirement") */
+    titleField: string;
+    /** Field for description/background text (default: "Description") */
+    descriptionField: string;
+    /** Field for the compliance level 1-3 (default: "Level") */
+    levelField: string;
+    /** Field for validity period in months (default: "ValidityPeriodMonths") */
+    validityField: string;
+    /** Field for lifecycle status Draft/Active/Inactive (default: "Status") */
+    statusField: string;
+}
+/**
+ * Top-level configuration for the audit feature module.
+ * Pass this into AuditPage, AuditRequirementsPage, AuditOverviewPage, and all audit hooks.
+ */
+export interface AuditConfig {
+    /**
+     * How compliance is captured:
+     * - "checkbox": binary yes/no toggle (default, compatible with penta_audit)
+     * - "enum": dropdown with custom options, each flagged as compliant or not
+     * Defaults to "checkbox" when not specified.
+     */
+    answerMode?: AuditAnswerMode;
+    /**
+     * Required when answerMode === "enum".
+     * Defines all selectable answer options and which count as compliant.
+     * When answerMode === "checkbox" this is auto-generated as [{value:"yes",...},{value:"no",...}].
+     */
+    answerOptions?: AuditAnswerOption[];
+    /**
+     * Group → sub-category hierarchy defining the requirement taxonomy.
+     * Can be loaded at runtime from a tagged message (AuditTagConfig.topology);
+     * this value serves as the fallback / default.
+     * Example: { "Safety": ["Fire", "Electrical"], "HR": ["Onboarding", "Annual Review"] }
+     */
+    topology?: Record<string, string[]>;
+    /** Optional terminology overrides. Falls back to generic English labels. */
+    terminology?: AuditTerminology;
+    /** Optional display labels for the three role tiers. */
+    roleLabels?: AuditRoleLabels;
+    /** Tag names for Codicent messages. Override to isolate audit types. */
+    tags?: Partial<AuditTagConfig>;
+    /** Field names within unit records. Override when using existing data schemas. */
+    unitFieldMapping?: Partial<AuditUnitFieldMapping>;
+    /** Field names within requirement records. Override to match existing schemas. */
+    requirementFieldMapping?: Partial<AuditRequirementFieldMapping>;
+    /** Default validity period in months for new requirements (default: 24) */
+    defaultValidityPeriodMonths?: number;
+}
+/**
+ * Resolved (fully merged) audit config with all defaults applied.
+ * Produced by resolveAuditConfig() in auditUtils.ts.
+ */
+export interface ResolvedAuditConfig {
+    answerMode: AuditAnswerMode;
+    answerOptions: AuditAnswerOption[];
+    topology: Record<string, string[]>;
+    terminology: Required<AuditTerminology>;
+    roleLabels: Required<AuditRoleLabels>;
+    tags: AuditTagConfig;
+    unitFieldMapping: AuditUnitFieldMapping;
+    requirementFieldMapping: AuditRequirementFieldMapping;
+    defaultValidityPeriodMonths: number;
+}
+/**
+ * The three fixed role tiers for the audit system.
+ * Display labels are configurable via AuditConfig.roleLabels.
+ */
+export type AuditRole = "Admin" | "Manager" | "Auditor";
+/**
+ * Capabilities granted to each audit role tier.
+ */
+export interface AuditRoleCapabilities {
+    /** Can view all units regardless of market area */
+    canViewAllUnits: boolean;
+    /** Can switch the active unit view (impersonate) */
+    canSwitchUnits: boolean;
+    /** Can create, edit, and delete requirement definitions */
+    canEditRequirements: boolean;
+    /** Can assign roles to users */
+    canManageUsers: boolean;
+    /** Can edit the tags assigned to a unit */
+    canEditUnitTags: boolean;
+    /** Can only view their own unit */
+    viewOwnUnitOnly: boolean;
+    /** Can submit / update audit answers for their own unit */
+    canEditOwnAudit: boolean;
+    /** Can view all units within their assigned manager area */
+    canViewManagerAreaUnits: boolean;
+    /** Read-only access (cannot submit answers) */
+    readOnly: boolean;
+    /** Can export their own unit as a package */
+    canExportUnit: boolean;
+    /** Can import an audit package into their own unit */
+    canImportUnit: boolean;
+    /** Can bulk-export multiple units */
+    canBulkExport: boolean;
+}
+/** Lifecycle status of a requirement definition. */
+export type AuditRequirementStatus = "Draft" | "Active" | "Inactive";
+/**
+ * A single requirement definition (independent of any specific unit/audit instance).
+ */
+export interface AuditRequirement {
+    /** Stable message ID — use this for parent references in answers (does not change on edit) */
+    id: string;
+    /** Original message ID for history-safe immutable reference */
+    originalMessageId?: string;
+    /** Requirement title / short description */
+    title: string;
+    /** Group this requirement belongs to (maps to config terminology.group) */
+    group: string;
+    /** Sub-category within the group (maps to config terminology.category) */
+    category: string;
+    /** Full description / background text */
+    description: string;
+    /** Compliance level 1–3 */
+    level: number;
+    /** How long compliance is valid in months; null = no expiry */
+    validityPeriodMonths: number | null;
+    /** Lifecycle status */
+    status: AuditRequirementStatus;
+    /** Tag combinations used to allocate this requirement to units */
+    tags: string[][];
+}
+/**
+ * A single audit answer (per unit, per requirement), enriched with requirement details.
+ */
+export interface AuditAnswer {
+    /** Unique answer message ID */
+    id: string;
+    /** ID of the linked requirement */
+    requirementId: string;
+    /** Requirement title (denormalized) */
+    title: string;
+    /** Requirement group (denormalized) */
+    group: string;
+    /** Requirement sub-category (denormalized) */
+    category: string;
+    /** Requirement description (denormalized) */
+    description: string;
+    /** Compliance level 1–3 (denormalized) */
+    level: number;
+    /** Formatted validity display string (e.g. "24 MONTHS" or "NO EXPIRY") */
+    validFor: string;
+    /**
+     * The selected answer value.
+     * - checkbox mode: "yes" | "no" | "" (empty = not yet answered)
+     * - enum mode: any answerOptions[n].value, or "" for unanswered
+     */
+    answer: string;
+    /** Optional free-text comment attached to the answer */
+    comment?: string;
+    /** Comma-separated list of uploaded evidence file IDs */
+    photos?: string;
+    /** ISO 8601 timestamp when this requirement was first answered as compliant */
+    complianceDate?: string;
+    /** ISO 8601 timestamp when this compliance expires */
+    validUntil?: string;
+    /** Validity period in months this answer was recorded with */
+    validityPeriodMonths?: number;
+}
+/**
+ * Aggregated compliance statistics for a single audited unit.
+ */
+export interface AuditUnitStats {
+    unitId: string;
+    unitName: string;
+    marketArea?: string;
+    totalRequirements: number;
+    compliantRequirements: number;
+    nonCompliantRequirements: number;
+    /** Compliance percentage 0–100 */
+    complianceRate: number;
+    /** Requirements expiring within 30 days */
+    expiringSoon: number;
+    /** Requirements already expired */
+    expired: number;
+}
+/**
+ * Aggregated compliance statistics across all units in a manager area.
+ */
+export interface AuditManagerStats {
+    totalUnits: number;
+    totalRequirements: number;
+    /** Average compliance percentage across all units */
+    overallComplianceRate: number;
+    unitsFullyCompliant: number;
+    unitsNeedingAttention: number;
+    totalExpiringSoon: number;
+    totalExpired: number;
+}
+/** Filter state for the main audit page (per-unit requirement list). */
+export interface AuditFilterState {
+    /** Selected group names to show */
+    groups: string[];
+    /** Selected category names to show */
+    categories: string[];
+    /**
+     * Compliance status filters.
+     * In checkbox mode: "compliant" | "non-compliant"
+     * In enum mode: any answerOptions[n].value, plus "compliant" | "non-compliant" (derived)
+     */
+    complianceStatuses: string[];
+    /** Validity / expiry filters */
+    validityStatuses: ("expired" | "expiring-soon" | "urgent" | "valid")[];
+    /** Additional filter: only show requirements with comments */
+    withComments: boolean;
+    /** Additional filter: only show requirements with photos */
+    withPhotos: boolean;
+    /** Free-text search string */
+    search: string;
+}
+/** Filter state for the requirements editor (admin page). */
+export interface AuditRequirementsFilterState {
+    groups: string[];
+    categories: string[];
+    /** Tag-based filter (dealer-type tags) */
+    tags: string[];
+    statuses: AuditRequirementStatus[];
+    search: string;
+}
+/** Filter state for the manager overview dashboard. */
+export interface AuditManagerFilterState {
+    /** Compliance rate bands */
+    complianceRates: ("100" | "75-99" | "50-74" | "0-49")[];
+    statuses: ("fully-compliant" | "needing-attention")[];
+    marketAreas: string[];
+    search: string;
+}
+/**
+ * Portable audit data package for offline use and import/export.
+ */
+export interface AuditPackage {
+    version: string;
+    exportDate: string;
+    unit: {
+        id: string;
+        name: string;
+        marketArea?: string;
+    };
+    requirements: AuditRequirement[];
+    answers: AuditAnswer[];
+    metadata: {
+        requirementCount: number;
+        answerCount: number;
+        unitId: string;
+        unitName?: string;
+        configSnapshot?: Pick<AuditConfig, "answerMode" | "answerOptions" | "terminology">;
+    };
+}
+/** Time remaining until a compliance requirement expires. */
+export interface AuditTimeRemaining {
+    days: number;
+    months: number;
+    years: number;
+    isExpired: boolean;
+    /** < 3 months remaining */
+    isExpiringSoon: boolean;
+    /** < 1 month remaining */
+    isUrgent: boolean;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/cjs/types/audit.d.ts.map

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

package/dist/cjs/types/index.d.ts

@@ -25,6 +25,7 @@ export interface ButtonConfig {
     /** Sub-buttons for multi-option buttons */
     options?: ButtonConfig[];
 }
+export * from "./audit";
 import type { ColumnAction, ColumnDefinition } from "../components/ListView";
 export type { ColumnAction, ColumnDefinition };
 /**

package/dist/cjs/types/index.d.ts.map

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

package/dist/cjs/utils/auditExport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Audit package export/import utilities for offline use.
+ * @module codicent-app-sdk/utils/auditExport
+ * @public
+ */
+import type { AuditAnswer, AuditConfig, AuditPackage, AuditRequirement } from "../types/audit";
+/**
+ * Builds an AuditPackage from unit data, requirements and answers.
+ */
+export declare function buildAuditPackage(unit: {
+    id: string;
+    name: string;
+    marketArea?: string;
+}, requirements: AuditRequirement[], answers: AuditAnswer[], config: Pick<AuditConfig, "answerMode" | "answerOptions" | "terminology">): AuditPackage;
+/**
+ * Serializes an AuditPackage to a JSON string.
+ */
+export declare function exportAuditPackageAsJson(pkg: AuditPackage): string;
+/**
+ * Parses an AuditPackage from a JSON string.
+ * Throws if the string is not a valid package.
+ */
+export declare function importAuditPackageFromJson(json: string): AuditPackage;
+/**
+ * Generates a self-contained HTML file that embeds the audit package as JSON
+ * and renders a read-only view with basic styling so auditors can fill it in offline.
+ *
+ * Note: The offline form renders answer fields but cannot post to Codicent.
+ * Import the resulting file via importAuditPackageFromHtml() when back online.
+ */
+export declare function exportAuditPackageAsHtml(pkg: AuditPackage): string;
+/**
+ * Extracts an AuditPackage from an HTML file previously generated by exportAuditPackageAsHtml.
+ * Falls back to importAuditPackageFromJson if the input is raw JSON.
+ */
+export declare function importAuditPackageFromHtml(content: string): AuditPackage;
+//# sourceMappingURL=auditExport.d.ts.map

package/dist/cjs/utils/auditExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditExport.d.ts","sourceRoot":"","sources":["../../../src/utils/auditExport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQ/F;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,YAAY,EAAE,gBAAgB,EAAE,EAChC,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,eAAe,GAAG,aAAa,CAAC,GACxE,YAAY,CAed;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAMrE;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAwFlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAQxE"}

package/dist/cjs/utils/auditExport.js

@@ -0,0 +1 @@
+"use strict";function e(e){const t=JSON.parse(e);if(!(t.version&&t.unit&&Array.isArray(t.requirements)&&Array.isArray(t.answers)))throw new Error("Invalid audit package format");return t}function t(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}exports.buildAuditPackage=function(e,t,n,r){return{version:"1.0",exportDate:(new Date).toISOString(),unit:e,requirements:t,answers:n,metadata:{requirementCount:t.length,answerCount:n.length,unitId:e.id,unitName:e.name,configSnapshot:r}}},exports.exportAuditPackageAsHtml=function(e){const n=JSON.stringify(e),r=`Audit — ${e.unit.name} — ${new Date(e.exportDate).toLocaleDateString()}`,a=(e.metadata.configSnapshot?.answerOptions??[{value:"yes",label:"Yes"},{value:"no",label:"No"}]).map((e=>`<option value="${t(e.value)}">${t(e.label)}</option>`)).join("");return`<!DOCTYPE html>\n<html lang="en">\n<head>\n<meta charset="UTF-8"/>\n<meta name="viewport" content="width=device-width,initial-scale=1.0"/>\n<title>${t(r)}</title>\n<style>\n  body{font-family:system-ui,sans-serif;background:#f8fafc;color:#1e293b;margin:0;padding:24px}\n  h1{font-size:1.4rem;margin-bottom:4px}\n  .meta{color:#64748b;font-size:.875rem;margin-bottom:24px}\n  table{width:100%;border-collapse:collapse;background:#fff;border-radius:8px;overflow:hidden;box-shadow:0 1px 3px rgba(0,0,0,.1)}\n  th{background:#1e3a5f;color:#fff;text-align:left;padding:10px 14px;font-size:.8rem;text-transform:uppercase;letter-spacing:.05em}\n  td{padding:10px 14px;border-bottom:1px solid #e2e8f0;font-size:.875rem;vertical-align:top}\n  tr:last-child td{border-bottom:none}\n  select{padding:4px 8px;border:1px solid #cbd5e1;border-radius:4px;background:#fff}\n  textarea{width:100%;box-sizing:border-box;padding:4px 8px;border:1px solid #cbd5e1;border-radius:4px;font-family:inherit;font-size:.875rem;resize:vertical}\n  .group-header td{background:#f1f5f9;font-weight:600;color:#475569}\n  button#export{margin-top:20px;padding:10px 20px;background:#1e3a5f;color:#fff;border:none;border-radius:6px;cursor:pointer;font-size:.9rem}\n  button#export:hover{background:#2d5499}\n  #msg{margin-top:12px;color:#065f46;font-weight:500}\n</style>\n</head>\n<body>\n<h1>${t(r)}</h1>\n<p class="meta">Unit: ${t(e.unit.name)} &nbsp;|&nbsp; Exported: ${new Date(e.exportDate).toLocaleString()}</p>\n<table id="tbl">\n  <thead>\n    <tr>\n      <th>Group</th><th>Category</th><th>Requirement</th><th>Level</th>\n      <th>Answer</th><th>Comment</th>\n    </tr>\n  </thead>\n  <tbody id="tbody"></tbody>\n</table>\n<button id="export">Download updated package (JSON)</button>\n<p id="msg"></p>\n<script>\n(function(){\n  var pkg=${n};\n  var answers=pkg.answers.map(function(a){return Object.assign({},a);});\n  var tbody=document.getElementById('tbody');\n  var optionsHtml='<option value="">— unanswered —</option>${a.replace(/'/g,"\\'")}';\n  answers.forEach(function(a,i){\n    var tr=document.createElement('tr');\n    tr.innerHTML='<td>'+esc(a.group)+'</td><td>'+esc(a.category)+'</td><td>'+esc(a.title)+'</td><td>'+esc(String(a.level))+'</td>'\n      +'<td><select data-i="'+i+'">'+optionsHtml+'</select></td>'\n      +'<td><textarea data-i="'+i+'" rows="2" placeholder="Comment…">'+esc(a.comment||'')+'</textarea></td>';\n    tbody.appendChild(tr);\n    tr.querySelector('select').value=a.answer||'';\n  });\n  tbody.addEventListener('change',function(e){\n    var i=e.target.dataset.i;if(i===undefined)return;\n    answers[i].answer=e.target.value;\n  });\n  tbody.addEventListener('input',function(e){\n    if(e.target.tagName!=='TEXTAREA')return;\n    var i=e.target.dataset.i;if(i===undefined)return;\n    answers[i].comment=e.target.value;\n  });\n  document.getElementById('export').addEventListener('click',function(){\n    pkg.answers=answers;\n    var blob=new Blob([JSON.stringify(pkg,null,2)],{type:'application/json'});\n    var url=URL.createObjectURL(blob);\n    var a=document.createElement('a');\n    a.href=url;a.download='audit_${e.unit.id}_updated.json';\n    document.body.appendChild(a);a.click();document.body.removeChild(a);\n    URL.revokeObjectURL(url);\n    document.getElementById('msg').textContent='Package downloaded. Import it back into the system when online.';\n  });\n  function esc(s){var d=document.createElement('div');d.textContent=s;return d.innerHTML;}\n})();\n<\/script>\n</body>\n</html>`},exports.exportAuditPackageAsJson=function(e){return JSON.stringify(e,null,2)},exports.importAuditPackageFromHtml=function(t){const n=t.match(/var pkg=(\{[\s\S]*?\});\s*var answers=/);return e(n?n[1]:t)},exports.importAuditPackageFromJson=e;

package/dist/cjs/utils/auditUtils.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Utility functions for the generic audit feature.
+ * Handles compliance date calculations, urgency colors, compliance rate calc,
+ * and config resolution.
+ * @module codicent-app-sdk/utils/auditUtils
+ * @public
+ */
+import type { AuditAnswer, AuditAnswerOption, AuditConfig, AuditRoleCapabilities, AuditRole, AuditTimeRemaining, ResolvedAuditConfig } from "../types/audit";
+export declare const DEFAULT_AUDIT_VALIDITY_PERIOD_MONTHS = 24;
+export declare const AUDIT_CHECKBOX_OPTIONS: AuditAnswerOption[];
+/**
+ * Merges a partial AuditConfig with defaults to produce a fully resolved config.
+ * Call this once at app startup and pass the result to all audit hooks/components.
+ */
+export declare function resolveAuditConfig(config: AuditConfig | Partial<AuditConfig>): ResolvedAuditConfig;
+/**
+ * Calculates time remaining until a compliance requirement expires.
+ * @param validUntil - ISO 8601 expiration timestamp
+ */
+export declare function calculateAuditTimeRemaining(validUntil: string | undefined): AuditTimeRemaining | null;
+/**
+ * Returns CSS color values based on urgency level.
+ */
+export declare function getAuditUrgencyColor(timeRemaining: AuditTimeRemaining | null): {
+    background: string;
+    text: string;
+    border: string;
+};
+/**
+ * Calculates the ISO 8601 ValidUntil date from a compliance date and validity period.
+ */
+export declare function calcValidUntil(complianceDate: string | undefined, validityPeriodMonths: number | null | undefined): string | undefined;
+/**
+ * Formats a validity period for display.
+ */
+export declare function formatValidityPeriod(months: number | null | undefined): string;
+/**
+ * Parses validity period from raw string data.
+ * Returns null for 0/falsy (= no expiry), defaults to defaultMonths.
+ */
+export declare function parseValidityPeriod(raw: string | undefined | null, defaultMonths: number): number | null;
+/**
+ * Determines whether an answer value counts as compliant given the config.
+ */
+export declare function isAnswerCompliant(answerValue: string, config: ResolvedAuditConfig): boolean;
+/**
+ * Calculates the compliance rate (0–100) for a set of answers.
+ * Unanswered (empty) items are counted as non-compliant.
+ */
+export declare function getAuditComplianceRate(answers: AuditAnswer[], config: ResolvedAuditConfig): number;
+/**
+ * Returns the full capabilities object for a given audit role.
+ */
+export declare function getAuditRoleCapabilities(role: AuditRole): AuditRoleCapabilities;
+/**
+ * Returns the effective answer options for a config (normalizes checkbox mode).
+ */
+export declare function getEffectiveAnswerOptions(config: ResolvedAuditConfig): AuditAnswerOption[];
+//# sourceMappingURL=auditUtils.d.ts.map

package/dist/cjs/utils/auditUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/auditUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EAEX,qBAAqB,EACrB,SAAS,EAGT,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAMxB,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,iBAAiB,EAIrD,CAAC;AA8CF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,mBAAmB,CAsBlG;AAMD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,IAAI,CAkBrG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,kBAAkB,GAAG,IAAI,GAAG;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAiBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,GAAG,SAAS,CAOpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxG;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAM3F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAIlG;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAgD/E;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,EAAE,CAQ1F"}

package/dist/cjs/utils/auditUtils.js

@@ -0,0 +1 @@
+"use strict";const e=[{value:"yes",label:"Yes",isCompliant:!0},{value:"no",label:"No",isCompliant:!1},{value:"",label:"—",isCompliant:!1}],n={requirement:"audit_req",answer:"audit_answer",unit:"audit_unit",role:"user_role",topology:"audit_topology"},t={nameField:"Name",idField:"UnitId",marketAreaField:"MarketArea",tagsField:"Tags"},i={groupField:"Standard",categoryField:"Area",titleField:"Requirement",descriptionField:"Description",levelField:"Level",validityField:"ValidityPeriodMonths",statusField:"Status"},a={appTitle:"Audit",unit:"Unit",unitPlural:"Units",managerArea:"Manager Area",group:"Group",groupPlural:"Groups",category:"Category",categoryPlural:"Categories",requirement:"Requirement",requirementPlural:"Requirements",compliantLabel:"Compliant",nonCompliantLabel:"Non-compliant"};function r(e,n){if("checkbox"===n.answerMode)return"yes"===e;const t=n.answerOptions.find((n=>n.value===e));return t?.isCompliant??!1}exports.AUDIT_CHECKBOX_OPTIONS=e,exports.DEFAULT_AUDIT_VALIDITY_PERIOD_MONTHS=24,exports.calcValidUntil=function(e,n){if(!e||null==n||0===n)return;const t=new Date(e);return t.setMonth(t.getMonth()+n),t.toISOString()},exports.calculateAuditTimeRemaining=function(e){if(!e)return null;const n=new Date,t=new Date(e).getTime()-n.getTime(),i=Math.floor(t/864e5),a=Math.floor(i/30);return{days:i,months:a,years:Math.floor(a/12),isExpired:i<0,isUrgent:i>=0&&i<30,isExpiringSoon:i>=0&&i<90}},exports.formatValidityPeriod=function(e){return null==e||0===e?"NO EXPIRY":`${e} MONTHS`},exports.getAuditComplianceRate=function(e,n){if(0===e.length)return 0;const t=e.filter((e=>r(e.answer,n))).length;return Math.round(t/e.length*100)},exports.getAuditRoleCapabilities=function(e){switch(e){case"Admin":return{canViewAllUnits:!0,canSwitchUnits:!0,canEditRequirements:!0,canManageUsers:!0,canEditUnitTags:!0,viewOwnUnitOnly:!1,canEditOwnAudit:!0,canViewManagerAreaUnits:!0,readOnly:!1,canExportUnit:!0,canImportUnit:!0,canBulkExport:!0};case"Manager":return{canViewAllUnits:!1,canSwitchUnits:!1,canEditRequirements:!1,canManageUsers:!1,canEditUnitTags:!1,viewOwnUnitOnly:!1,canEditOwnAudit:!1,canViewManagerAreaUnits:!0,readOnly:!0,canExportUnit:!1,canImportUnit:!1,canBulkExport:!0};default:return{canViewAllUnits:!1,canSwitchUnits:!1,canEditRequirements:!1,canManageUsers:!1,canEditUnitTags:!1,viewOwnUnitOnly:!0,canEditOwnAudit:!0,canViewManagerAreaUnits:!1,readOnly:!1,canExportUnit:!0,canImportUnit:!0,canBulkExport:!1}}},exports.getAuditUrgencyColor=function(e){return e?e.isExpired?{background:"#FEE2E2",text:"#991B1B",border:"#FCA5A5"}:e.isUrgent?{background:"#FED7AA",text:"#9A3412",border:"#FB923C"}:e.isExpiringSoon?{background:"#FEF3C7",text:"#92400E",border:"#FCD34D"}:e.months<=6?{background:"#FEF9C3",text:"#854D0E",border:"#FDE047"}:{background:"#ECFDF5",text:"#065F46",border:"#D1FAE5"}:{background:"#F3F4F6",text:"#6B7280",border:"#E5E7EB"}},exports.getEffectiveAnswerOptions=function(e){return"checkbox"===e.answerMode?[{value:"yes",label:e.terminology.compliantLabel,isCompliant:!0},{value:"no",label:e.terminology.nonCompliantLabel,isCompliant:!1}]:e.answerOptions},exports.isAnswerCompliant=r,exports.parseValidityPeriod=function(e,n){if(!e)return n;const t=parseInt(e,10);return isNaN(t)?n:0===t?null:t},exports.resolveAuditConfig=function(r){const o=r.answerOptions&&r.answerOptions.length>0?r.answerOptions:e;return{answerMode:r.answerMode??"checkbox",answerOptions:o,topology:r.topology??{},terminology:{...a,...r.terminology??{}},roleLabels:{admin:r.roleLabels?.admin??"Admin",manager:r.roleLabels?.manager??"Manager",auditor:r.roleLabels?.auditor??"Auditor"},tags:{...n,...r.tags??{}},unitFieldMapping:{...t,...r.unitFieldMapping??{}},requirementFieldMapping:{...i,...r.requirementFieldMapping??{}},defaultValidityPeriodMonths:r.defaultValidityPeriodMonths??24}};

package/dist/cjs/utils/index.d.ts

@@ -14,4 +14,6 @@ export type { AppStateDefinition } from "./appState";
 export { getTimeString } from "./helpers";
 export { CacheManager, stateMachineCacheManager } from "./cacheManager";
 export type { CacheEntry, CachedUserSession } from "./cacheManager";
+export { resolveAuditConfig, calculateAuditTimeRemaining, getAuditUrgencyColor, calcValidUntil, formatValidityPeriod, parseValidityPeriod, isAnswerCompliant, getAuditComplianceRate, getAuditRoleCapabilities, getEffectiveAnswerOptions, DEFAULT_AUDIT_VALIDITY_PERIOD_MONTHS, AUDIT_CHECKBOX_OPTIONS, } from "./auditUtils";
+export { buildAuditPackage, exportAuditPackageAsJson, importAuditPackageFromJson, exportAuditPackageAsHtml, importAuditPackageFromHtml, } from "./auditExport";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,eAAe,CAAC"}