@portnet/ui 6.0.1 → 6.0.3

package/dist/esm/v2/__tests__/fileValidation.test.js

@@ -0,0 +1,134 @@
+import { describeAcceptedTypes, getFileRejection, isAcceptedFile, isForbiddenExecutable, toAcceptAttribute } from "../utils/fileValidation";
+/** The policy of the module this capability was raised from, verbatim. */
+const DAAC = {
+  extensions: ["pdf", "png", "jpg", "jpeg", "doc", "docx"]
+};
+const file = (name, type = "") => new File(["contenu"], name, {
+  type
+});
+describe("isForbiddenExecutable", () => {
+  it("recognises executables, scripts and installers", () => {
+    for (const name of ["setup.exe", "run.bat", "x.ps1", "pkg.msi", "a.hta"]) {
+      expect(isForbiddenExecutable(file(name))).toBe(true);
+    }
+  });
+  it("is case-insensitive", () => {
+    expect(isForbiddenExecutable(file("SETUP.EXE"))).toBe(true);
+  });
+  it("leaves ordinary documents alone", () => {
+    expect(isForbiddenExecutable(file("titre.pdf"))).toBe(false);
+  });
+
+  /* Callers pass items straight out of a FileList; nothing may throw. */
+  it("tolerates a missing file", () => {
+    expect(isForbiddenExecutable(null)).toBe(false);
+    expect(isForbiddenExecutable(undefined)).toBe(false);
+  });
+});
+describe("getFileRejection", () => {
+  it("accepts a file the policy allows", () => {
+    expect(getFileRejection(file("titre.pdf", "application/pdf"), DAAC)).toBeNull();
+    expect(isAcceptedFile(file("scan.PNG", "image/png"), DAAC)).toBe(true);
+  });
+
+  /* THE ORDER IS THE POINT: a dangerous file is named as such, not reported as
+   * an unsupported type — those are not the same information for the user. */
+  it("refuses an executable BEFORE any type consideration", () => {
+    const rejection = getFileRejection(file("setup.exe"), DAAC);
+    expect(rejection?.reason).toBe("executable");
+    expect(rejection?.message).toBe("Les fichiers exécutables, scripts et installeurs ne sont pas autorisés.");
+  });
+
+  /* The deny-list is the LIBRARY's, not the host's: a host cannot opt into
+   * accepting executables by listing the extension. */
+  it("refuses an executable even when the policy lists it", () => {
+    const reckless = {
+      extensions: ["pdf", "exe"]
+    };
+    expect(getFileRejection(file("setup.exe"), reckless)?.reason).toBe("executable");
+  });
+  it("refuses an extension outside the policy", () => {
+    const rejection = getFileRejection(file("archive.zip"), DAAC);
+    expect(rejection?.reason).toBe("extension");
+    expect(rejection?.message).toBe("Types autorisés : PDF, PNG, JPG, JPEG, DOC, DOCX.");
+  });
+
+  /* "rapport" has NO extension; a bare split().pop() would read the whole name
+   * as one, and "rapport" is not in any allow-list, so the bug would hide. */
+  it("refuses a name with no extension", () => {
+    expect(getFileRejection(file("rapport"), DAAC)?.reason).toBe("extension");
+  });
+  it("refuses a MIME type that contradicts the extension", () => {
+    const rejection = getFileRejection(file("titre.pdf", "text/html"), DAAC);
+    expect(rejection?.reason).toBe("mime");
+  });
+
+  /* Some browsers report no type at all, and the extension has just been
+   * checked against the host's list. */
+  it("accepts an empty MIME type", () => {
+    expect(getFileRejection(file("titre.pdf", ""), DAAC)).toBeNull();
+  });
+
+  /* WITHOUT THIS, A LEGITIMATE .docx IS REFUSED on some machines — and
+   * intermittently, which is the hardest kind of report to act on. */
+  it("tolerates application/octet-stream for Office documents", () => {
+    expect(getFileRejection(file("courrier.docx", "application/octet-stream"), DAAC)).toBeNull();
+    expect(getFileRejection(file("courrier.doc", "application/octet-stream"), DAAC)).toBeNull();
+  });
+  it("does NOT extend that tolerance to a PDF", () => {
+    expect(getFileRejection(file("titre.pdf", "application/octet-stream"), DAAC)?.reason).toBe("mime");
+  });
+
+  /* `image/jpg` is not a registered type; browsers send it anyway. A canonical
+   * one-type-per-extension table would reject a valid photo. */
+  it("accepts the unregistered image/jpg variant", () => {
+    expect(getFileRejection(file("photo.jpg", "image/jpg"), DAAC)).toBeNull();
+  });
+
+  /* The MIME table is a cross-check, not a second allow-list: a host adding a
+   * format to its policy must not be refused by a table it cannot see. */
+  it("accepts an allowed extension the MIME table does not know", () => {
+    const withDwg = {
+      extensions: ["dwg"]
+    };
+    expect(getFileRejection(file("plan.dwg", "application/acad"), withDwg)).toBeNull();
+  });
+  it("matches the policy case-insensitively on both sides", () => {
+    const upper = {
+      extensions: ["PDF"]
+    };
+    expect(getFileRejection(file("TITRE.Pdf", "application/pdf"), upper)).toBeNull();
+  });
+  it("accepts nothing when the policy lists nothing", () => {
+    expect(getFileRejection(file("titre.pdf"), {
+      extensions: []
+    })?.reason).toBe("extension");
+  });
+  it("uses host labels when given", () => {
+    const rejection = getFileRejection(file("archive.zip"), {
+      extensions: ["pdf"],
+      labels: {
+        type: "Seuls les PDF sont acceptés."
+      }
+    });
+    expect(rejection?.message).toBe("Seuls les PDF sont acceptés.");
+  });
+  it("treats an absent file as refused rather than throwing", () => {
+    expect(getFileRejection(null, DAAC)?.reason).toBe("extension");
+    expect(isAcceptedFile(undefined, DAAC)).toBe(false);
+  });
+});
+describe("describeAcceptedTypes / toAcceptAttribute", () => {
+  /* Order is the HOST's — it lists its most common format first on purpose, and
+   * sorting here would silently reorder copy someone wrote deliberately. */
+  it("keeps the host's order", () => {
+    expect(describeAcceptedTypes(DAAC.extensions)).toBe("PDF, PNG, JPG, JPEG, DOC, DOCX.");
+  });
+  it("builds the accept attribute", () => {
+    expect(toAcceptAttribute(DAAC.extensions)).toBe(".pdf,.png,.jpg,.jpeg,.doc,.docx");
+  });
+  it("lowercases the accept attribute", () => {
+    expect(toAcceptAttribute(["PDF", "Docx"])).toBe(".pdf,.docx");
+  });
+});
+//# sourceMappingURL=fileValidation.test.js.map

package/dist/esm/v2/__tests__/fileValidation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileValidation.test.js","names":["describeAcceptedTypes","getFileRejection","isAcceptedFile","isForbiddenExecutable","toAcceptAttribute","DAAC","extensions","file","name","type","File","describe","it","expect","toBe","undefined","toBeNull","rejection","reason","message","reckless","withDwg","upper","labels"],"sources":["../../../../src/lib/v2/__tests__/fileValidation.test.ts"],"sourcesContent":["import {\r\n  describeAcceptedTypes,\r\n  getFileRejection,\r\n  isAcceptedFile,\r\n  isForbiddenExecutable,\r\n  toAcceptAttribute,\r\n} from \"../utils/fileValidation\";\r\nimport type { FileAcceptPolicy } from \"../utils/fileValidation\";\r\n\r\n/** The policy of the module this capability was raised from, verbatim. */\r\nconst DAAC: FileAcceptPolicy = {\r\n  extensions: [\"pdf\", \"png\", \"jpg\", \"jpeg\", \"doc\", \"docx\"],\r\n};\r\n\r\nconst file = (name: string, type = \"\"): File =>\r\n  new File([\"contenu\"], name, { type });\r\n\r\ndescribe(\"isForbiddenExecutable\", () => {\r\n  it(\"recognises executables, scripts and installers\", () => {\r\n    for (const name of [\"setup.exe\", \"run.bat\", \"x.ps1\", \"pkg.msi\", \"a.hta\"]) {\r\n      expect(isForbiddenExecutable(file(name))).toBe(true);\r\n    }\r\n  });\r\n\r\n  it(\"is case-insensitive\", () => {\r\n    expect(isForbiddenExecutable(file(\"SETUP.EXE\"))).toBe(true);\r\n  });\r\n\r\n  it(\"leaves ordinary documents alone\", () => {\r\n    expect(isForbiddenExecutable(file(\"titre.pdf\"))).toBe(false);\r\n  });\r\n\r\n  /* Callers pass items straight out of a FileList; nothing may throw. */\r\n  it(\"tolerates a missing file\", () => {\r\n    expect(isForbiddenExecutable(null)).toBe(false);\r\n    expect(isForbiddenExecutable(undefined)).toBe(false);\r\n  });\r\n});\r\n\r\ndescribe(\"getFileRejection\", () => {\r\n  it(\"accepts a file the policy allows\", () => {\r\n    expect(getFileRejection(file(\"titre.pdf\", \"application/pdf\"), DAAC)).toBeNull();\r\n    expect(isAcceptedFile(file(\"scan.PNG\", \"image/png\"), DAAC)).toBe(true);\r\n  });\r\n\r\n  /* THE ORDER IS THE POINT: a dangerous file is named as such, not reported as\r\n   * an unsupported type — those are not the same information for the user. */\r\n  it(\"refuses an executable BEFORE any type consideration\", () => {\r\n    const rejection = getFileRejection(file(\"setup.exe\"), DAAC);\r\n    expect(rejection?.reason).toBe(\"executable\");\r\n    expect(rejection?.message).toBe(\r\n      \"Les fichiers exécutables, scripts et installeurs ne sont pas autorisés.\"\r\n    );\r\n  });\r\n\r\n  /* The deny-list is the LIBRARY's, not the host's: a host cannot opt into\r\n   * accepting executables by listing the extension. */\r\n  it(\"refuses an executable even when the policy lists it\", () => {\r\n    const reckless: FileAcceptPolicy = { extensions: [\"pdf\", \"exe\"] };\r\n    expect(getFileRejection(file(\"setup.exe\"), reckless)?.reason).toBe(\r\n      \"executable\"\r\n    );\r\n  });\r\n\r\n  it(\"refuses an extension outside the policy\", () => {\r\n    const rejection = getFileRejection(file(\"archive.zip\"), DAAC);\r\n    expect(rejection?.reason).toBe(\"extension\");\r\n    expect(rejection?.message).toBe(\r\n      \"Types autorisés : PDF, PNG, JPG, JPEG, DOC, DOCX.\"\r\n    );\r\n  });\r\n\r\n  /* \"rapport\" has NO extension; a bare split().pop() would read the whole name\r\n   * as one, and \"rapport\" is not in any allow-list, so the bug would hide. */\r\n  it(\"refuses a name with no extension\", () => {\r\n    expect(getFileRejection(file(\"rapport\"), DAAC)?.reason).toBe(\"extension\");\r\n  });\r\n\r\n  it(\"refuses a MIME type that contradicts the extension\", () => {\r\n    const rejection = getFileRejection(file(\"titre.pdf\", \"text/html\"), DAAC);\r\n    expect(rejection?.reason).toBe(\"mime\");\r\n  });\r\n\r\n  /* Some browsers report no type at all, and the extension has just been\r\n   * checked against the host's list. */\r\n  it(\"accepts an empty MIME type\", () => {\r\n    expect(getFileRejection(file(\"titre.pdf\", \"\"), DAAC)).toBeNull();\r\n  });\r\n\r\n  /* WITHOUT THIS, A LEGITIMATE .docx IS REFUSED on some machines — and\r\n   * intermittently, which is the hardest kind of report to act on. */\r\n  it(\"tolerates application/octet-stream for Office documents\", () => {\r\n    expect(\r\n      getFileRejection(file(\"courrier.docx\", \"application/octet-stream\"), DAAC)\r\n    ).toBeNull();\r\n    expect(\r\n      getFileRejection(file(\"courrier.doc\", \"application/octet-stream\"), DAAC)\r\n    ).toBeNull();\r\n  });\r\n\r\n  it(\"does NOT extend that tolerance to a PDF\", () => {\r\n    expect(\r\n      getFileRejection(file(\"titre.pdf\", \"application/octet-stream\"), DAAC)\r\n        ?.reason\r\n    ).toBe(\"mime\");\r\n  });\r\n\r\n  /* `image/jpg` is not a registered type; browsers send it anyway. A canonical\r\n   * one-type-per-extension table would reject a valid photo. */\r\n  it(\"accepts the unregistered image/jpg variant\", () => {\r\n    expect(getFileRejection(file(\"photo.jpg\", \"image/jpg\"), DAAC)).toBeNull();\r\n  });\r\n\r\n  /* The MIME table is a cross-check, not a second allow-list: a host adding a\r\n   * format to its policy must not be refused by a table it cannot see. */\r\n  it(\"accepts an allowed extension the MIME table does not know\", () => {\r\n    const withDwg: FileAcceptPolicy = { extensions: [\"dwg\"] };\r\n    expect(\r\n      getFileRejection(file(\"plan.dwg\", \"application/acad\"), withDwg)\r\n    ).toBeNull();\r\n  });\r\n\r\n  it(\"matches the policy case-insensitively on both sides\", () => {\r\n    const upper: FileAcceptPolicy = { extensions: [\"PDF\"] };\r\n    expect(getFileRejection(file(\"TITRE.Pdf\", \"application/pdf\"), upper)).toBeNull();\r\n  });\r\n\r\n  it(\"accepts nothing when the policy lists nothing\", () => {\r\n    expect(getFileRejection(file(\"titre.pdf\"), { extensions: [] })?.reason).toBe(\r\n      \"extension\"\r\n    );\r\n  });\r\n\r\n  it(\"uses host labels when given\", () => {\r\n    const rejection = getFileRejection(file(\"archive.zip\"), {\r\n      extensions: [\"pdf\"],\r\n      labels: { type: \"Seuls les PDF sont acceptés.\" },\r\n    });\r\n    expect(rejection?.message).toBe(\"Seuls les PDF sont acceptés.\");\r\n  });\r\n\r\n  it(\"treats an absent file as refused rather than throwing\", () => {\r\n    expect(getFileRejection(null, DAAC)?.reason).toBe(\"extension\");\r\n    expect(isAcceptedFile(undefined, DAAC)).toBe(false);\r\n  });\r\n});\r\n\r\ndescribe(\"describeAcceptedTypes / toAcceptAttribute\", () => {\r\n  /* Order is the HOST's — it lists its most common format first on purpose, and\r\n   * sorting here would silently reorder copy someone wrote deliberately. */\r\n  it(\"keeps the host's order\", () => {\r\n    expect(describeAcceptedTypes(DAAC.extensions)).toBe(\r\n      \"PDF, PNG, JPG, JPEG, DOC, DOCX.\"\r\n    );\r\n  });\r\n\r\n  it(\"builds the accept attribute\", () => {\r\n    expect(toAcceptAttribute(DAAC.extensions)).toBe(\r\n      \".pdf,.png,.jpg,.jpeg,.doc,.docx\"\r\n    );\r\n  });\r\n\r\n  it(\"lowercases the accept attribute\", () => {\r\n    expect(toAcceptAttribute([\"PDF\", \"Docx\"])).toBe(\".pdf,.docx\");\r\n  });\r\n});\r\n"],"mappings":"AAAA,SACEA,qBAAqB,EACrBC,gBAAgB,EAChBC,cAAc,EACdC,qBAAqB,EACrBC,iBAAiB,QACZ,yBAAyB;AAGhC;AACA,MAAMC,IAAsB,GAAG;EAC7BC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;AACzD,CAAC;AAED,MAAMC,IAAI,GAAGA,CAACC,IAAY,EAAEC,IAAI,GAAG,EAAE,KACnC,IAAIC,IAAI,CAAC,CAAC,SAAS,CAAC,EAAEF,IAAI,EAAE;EAAEC;AAAK,CAAC,CAAC;AAEvCE,QAAQ,CAAC,uBAAuB,EAAE,MAAM;EACtCC,EAAE,CAAC,gDAAgD,EAAE,MAAM;IACzD,KAAK,MAAMJ,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;MACxEK,MAAM,CAACV,qBAAqB,CAACI,IAAI,CAACC,IAAI,CAAC,CAAC,CAAC,CAACM,IAAI,CAAC,IAAI,CAAC;IACtD;EACF,CAAC,CAAC;EAEFF,EAAE,CAAC,qBAAqB,EAAE,MAAM;IAC9BC,MAAM,CAACV,qBAAqB,CAACI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAACO,IAAI,CAAC,IAAI,CAAC;EAC7D,CAAC,CAAC;EAEFF,EAAE,CAAC,iCAAiC,EAAE,MAAM;IAC1CC,MAAM,CAACV,qBAAqB,CAACI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAACO,IAAI,CAAC,KAAK,CAAC;EAC9D,CAAC,CAAC;;EAEF;EACAF,EAAE,CAAC,0BAA0B,EAAE,MAAM;IACnCC,MAAM,CAACV,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAACW,IAAI,CAAC,KAAK,CAAC;IAC/CD,MAAM,CAACV,qBAAqB,CAACY,SAAS,CAAC,CAAC,CAACD,IAAI,CAAC,KAAK,CAAC;EACtD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFH,QAAQ,CAAC,kBAAkB,EAAE,MAAM;EACjCC,EAAE,CAAC,kCAAkC,EAAE,MAAM;IAC3CC,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAEF,IAAI,CAAC,CAAC,CAACW,QAAQ,CAAC,CAAC;IAC/EH,MAAM,CAACX,cAAc,CAACK,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAEF,IAAI,CAAC,CAAC,CAACS,IAAI,CAAC,IAAI,CAAC;EACxE,CAAC,CAAC;;EAEF;AACF;EACEF,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,MAAMK,SAAS,GAAGhB,gBAAgB,CAACM,IAAI,CAAC,WAAW,CAAC,EAAEF,IAAI,CAAC;IAC3DQ,MAAM,CAACI,SAAS,EAAEC,MAAM,CAAC,CAACJ,IAAI,CAAC,YAAY,CAAC;IAC5CD,MAAM,CAACI,SAAS,EAAEE,OAAO,CAAC,CAACL,IAAI,CAC7B,yEACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;EACEF,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,MAAMQ,QAA0B,GAAG;MAAEd,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK;IAAE,CAAC;IACjEO,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,CAAC,EAAEa,QAAQ,CAAC,EAAEF,MAAM,CAAC,CAACJ,IAAI,CAChE,YACF,CAAC;EACH,CAAC,CAAC;EAEFF,EAAE,CAAC,yCAAyC,EAAE,MAAM;IAClD,MAAMK,SAAS,GAAGhB,gBAAgB,CAACM,IAAI,CAAC,aAAa,CAAC,EAAEF,IAAI,CAAC;IAC7DQ,MAAM,CAACI,SAAS,EAAEC,MAAM,CAAC,CAACJ,IAAI,CAAC,WAAW,CAAC;IAC3CD,MAAM,CAACI,SAAS,EAAEE,OAAO,CAAC,CAACL,IAAI,CAC7B,mDACF,CAAC;EACH,CAAC,CAAC;;EAEF;AACF;EACEF,EAAE,CAAC,kCAAkC,EAAE,MAAM;IAC3CC,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,SAAS,CAAC,EAAEF,IAAI,CAAC,EAAEa,MAAM,CAAC,CAACJ,IAAI,CAAC,WAAW,CAAC;EAC3E,CAAC,CAAC;EAEFF,EAAE,CAAC,oDAAoD,EAAE,MAAM;IAC7D,MAAMK,SAAS,GAAGhB,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EAAEF,IAAI,CAAC;IACxEQ,MAAM,CAACI,SAAS,EAAEC,MAAM,CAAC,CAACJ,IAAI,CAAC,MAAM,CAAC;EACxC,CAAC,CAAC;;EAEF;AACF;EACEF,EAAE,CAAC,4BAA4B,EAAE,MAAM;IACrCC,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAEF,IAAI,CAAC,CAAC,CAACW,QAAQ,CAAC,CAAC;EAClE,CAAC,CAAC;;EAEF;AACF;EACEJ,EAAE,CAAC,yDAAyD,EAAE,MAAM;IAClEC,MAAM,CACJZ,gBAAgB,CAACM,IAAI,CAAC,eAAe,EAAE,0BAA0B,CAAC,EAAEF,IAAI,CAC1E,CAAC,CAACW,QAAQ,CAAC,CAAC;IACZH,MAAM,CACJZ,gBAAgB,CAACM,IAAI,CAAC,cAAc,EAAE,0BAA0B,CAAC,EAAEF,IAAI,CACzE,CAAC,CAACW,QAAQ,CAAC,CAAC;EACd,CAAC,CAAC;EAEFJ,EAAE,CAAC,yCAAyC,EAAE,MAAM;IAClDC,MAAM,CACJZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,EAAEF,IAAI,CAAC,EACjEa,MACN,CAAC,CAACJ,IAAI,CAAC,MAAM,CAAC;EAChB,CAAC,CAAC;;EAEF;AACF;EACEF,EAAE,CAAC,4CAA4C,EAAE,MAAM;IACrDC,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EAAEF,IAAI,CAAC,CAAC,CAACW,QAAQ,CAAC,CAAC;EAC3E,CAAC,CAAC;;EAEF;AACF;EACEJ,EAAE,CAAC,2DAA2D,EAAE,MAAM;IACpE,MAAMS,OAAyB,GAAG;MAAEf,UAAU,EAAE,CAAC,KAAK;IAAE,CAAC;IACzDO,MAAM,CACJZ,gBAAgB,CAACM,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAEc,OAAO,CAChE,CAAC,CAACL,QAAQ,CAAC,CAAC;EACd,CAAC,CAAC;EAEFJ,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,MAAMU,KAAuB,GAAG;MAAEhB,UAAU,EAAE,CAAC,KAAK;IAAE,CAAC;IACvDO,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAEe,KAAK,CAAC,CAAC,CAACN,QAAQ,CAAC,CAAC;EAClF,CAAC,CAAC;EAEFJ,EAAE,CAAC,+CAA+C,EAAE,MAAM;IACxDC,MAAM,CAACZ,gBAAgB,CAACM,IAAI,CAAC,WAAW,CAAC,EAAE;MAAED,UAAU,EAAE;IAAG,CAAC,CAAC,EAAEY,MAAM,CAAC,CAACJ,IAAI,CAC1E,WACF,CAAC;EACH,CAAC,CAAC;EAEFF,EAAE,CAAC,6BAA6B,EAAE,MAAM;IACtC,MAAMK,SAAS,GAAGhB,gBAAgB,CAACM,IAAI,CAAC,aAAa,CAAC,EAAE;MACtDD,UAAU,EAAE,CAAC,KAAK,CAAC;MACnBiB,MAAM,EAAE;QAAEd,IAAI,EAAE;MAA+B;IACjD,CAAC,CAAC;IACFI,MAAM,CAACI,SAAS,EAAEE,OAAO,CAAC,CAACL,IAAI,CAAC,8BAA8B,CAAC;EACjE,CAAC,CAAC;EAEFF,EAAE,CAAC,uDAAuD,EAAE,MAAM;IAChEC,MAAM,CAACZ,gBAAgB,CAAC,IAAI,EAAEI,IAAI,CAAC,EAAEa,MAAM,CAAC,CAACJ,IAAI,CAAC,WAAW,CAAC;IAC9DD,MAAM,CAACX,cAAc,CAACa,SAAS,EAAEV,IAAI,CAAC,CAAC,CAACS,IAAI,CAAC,KAAK,CAAC;EACrD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFH,QAAQ,CAAC,2CAA2C,EAAE,MAAM;EAC1D;AACF;EACEC,EAAE,CAAC,wBAAwB,EAAE,MAAM;IACjCC,MAAM,CAACb,qBAAqB,CAACK,IAAI,CAACC,UAAU,CAAC,CAAC,CAACQ,IAAI,CACjD,iCACF,CAAC;EACH,CAAC,CAAC;EAEFF,EAAE,CAAC,6BAA6B,EAAE,MAAM;IACtCC,MAAM,CAACT,iBAAiB,CAACC,IAAI,CAACC,UAAU,CAAC,CAAC,CAACQ,IAAI,CAC7C,iCACF,CAAC;EACH,CAAC,CAAC;EAEFF,EAAE,CAAC,iCAAiC,EAAE,MAAM;IAC1CC,MAAM,CAACT,iBAAiB,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAACU,IAAI,CAAC,YAAY,CAAC;EAC/D,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/dist/esm/v2/__tests__/filterCriteria.test.js

@@ -0,0 +1,321 @@
+/**
+ * @jest-environment jsdom
+ */
+import { renderHook, act } from "@testing-library/react";
+import { buildFilterChips, filterCriteriaKeys, isCriterionSet } from "../patterns/filterCriteria";
+import useAppliedFilters from "../hooks/useAppliedFilters";
+
+/**
+ * filterCriteria (G-42) + useAppliedFilters (G-43) — promoted from
+ * `refonte-frontend` (Area 5).
+ *
+ * THE CASES BELOW ARE THE HOSTS' OWN, not invented ones. Each was read off the
+ * nine listings that consumed these two capabilities, which is why this file
+ * was written last: a test built on imagined descriptors would have covered
+ * the easy half and missed all four things that actually differ between
+ * screens.
+ */
+
+describe("isCriterionSet", () => {
+  /**
+   * CASE 1 — `0` MEANS UNSET. Four payloads in the promoting module carry
+   * `villeEntreeId: 0` / `importateurId: 0` as their "no selection" value. A
+   * chip appearing for `0` announces a criterion nobody chose.
+   */
+  test("0 is not set — it is the unset value of a reference mirror", () => {
+    expect(isCriterionSet(0)).toBe(false);
+  });
+  test("null, undefined, empty string and empty array are not set", () => {
+    expect(isCriterionSet(null)).toBe(false);
+    expect(isCriterionSet(undefined)).toBe(false);
+    expect(isCriterionSet("")).toBe(false);
+    expect(isCriterionSet([])).toBe(false);
+  });
+  test("a reference object, a non-empty string and a non-zero id are set", () => {
+    expect(isCriterionSet({
+      id: 42,
+      description: "SOFRANE SA"
+    })).toBe(true);
+    expect(isCriterionSet("2025-IM-0042")).toBe(true);
+    expect(isCriterionSet(42)).toBe(true);
+  });
+});
+describe("buildFilterChips", () => {
+  test("only SET criteria produce a chip", () => {
+    const criteria = [{
+      key: "identifiant",
+      label: "Référence"
+    }, {
+      key: "villeEntreeId",
+      label: "DPCI"
+    }];
+    const chips = buildFilterChips({
+      identifiant: "2025-IM-0042",
+      villeEntreeId: 0
+    }, criteria, jest.fn());
+    expect(chips).toHaveLength(1);
+    expect(chips[0]?.key).toBe("identifiant");
+  });
+
+  /**
+   * "Label: value" and not the value alone: "AFFECTE" does not say WHICH
+   * criterion it is when three chips sit side by side.
+   */
+  test("the chip reads « label : value »", () => {
+    const chips = buildFilterChips({
+      statut: {
+        id: 3,
+        description: "Affecté"
+      }
+    }, [{
+      key: "statut",
+      label: "Statut"
+    }], jest.fn());
+    expect(chips[0]?.label).toBe("Statut : Affecté");
+  });
+  test("a reference object renders through its description by default", () => {
+    const chips = buildFilterChips({
+      importateurCode: {
+        id: 7,
+        description: "NOVATIS"
+      }
+    }, [{
+      key: "importateurCode",
+      label: "Importateur"
+    }], jest.fn());
+    expect(chips[0]?.label).toBe("Importateur : NOVATIS");
+  });
+
+  /**
+   * CASE 4 — `format`. `typeReponse` stores the id DIRECTLY, with no object
+   * mirror, so without a formatter the chip would read "Réponse ministère : 3".
+   */
+  test("format renders a scalar id through the host's lookup", () => {
+    const lookup = {
+      "3": "Favorable"
+    };
+    const chips = buildFilterChips({
+      typeReponse: 3
+    }, [{
+      key: "typeReponse",
+      label: "Réponse ministère",
+      format: v => lookup[String(v)] ?? String(v)
+    }], jest.fn());
+    expect(chips[0]?.label).toBe("Réponse ministère : Favorable");
+  });
+
+  /**
+   * CASE 2 — THE PAIR. Reference criteria are held as two fields: an object for
+   * display and a scalar mirror for the payload. Clearing only the displayed
+   * key removes the chip from the screen while the criterion STAYS IN THE
+   * PAYLOAD — an invisible filter that still filters.
+   */
+  test("removing a paired criterion clears its mirror too", () => {
+    const onRemove = jest.fn();
+    const chips = buildFilterChips({
+      importateurCode: {
+        id: 7,
+        description: "NOVATIS"
+      }
+    }, [{
+      key: "importateurCode",
+      label: "Importateur",
+      linkedKeys: ["importateurId"]
+    }], onRemove);
+    chips[0]?.onRemove?.();
+    expect(onRemove).toHaveBeenCalledWith(["importateurCode", "importateurId"]);
+  });
+
+  /**
+   * CASE 3 — TWO NOMENCLATURES, not one mirror. One host's persisted filter
+   * suffixes its objects with `_obj` while its form names them plainly, so
+   * `linkedKeys` reconciles the two vocabularies: the chip READS
+   * `categorie_obj` and CLEARS all three keys.
+   */
+  test("linkedKeys can reconcile two key nomenclatures, not just a mirror", () => {
+    const onRemove = jest.fn();
+    const chips = buildFilterChips({
+      categorie_obj: {
+        id: 1,
+        description: "Balances"
+      }
+    }, [{
+      key: "categorie_obj",
+      label: "Catégorie d'IM",
+      linkedKeys: ["categorie", "categorieId"]
+    }], onRemove);
+    chips[0]?.onRemove?.();
+    expect(onRemove).toHaveBeenCalledWith(["categorie_obj", "categorie", "categorieId"]);
+  });
+  test("filterCriteriaKeys lists every key, mirrors included — for a clear-all", () => {
+    expect(filterCriteriaKeys([{
+      key: "identifiant",
+      label: "Référence"
+    }, {
+      key: "delegation",
+      label: "DPCI",
+      linkedKeys: ["delegationId", "villeEntreeId"]
+    }])).toEqual(["identifiant", "delegation", "delegationId", "villeEntreeId"]);
+  });
+});
+describe("useAppliedFilters", () => {
+  const makeForm = values => ({
+    values,
+    setFieldValue: jest.fn()
+  });
+
+  /**
+   * THE DEFECT THIS HOOK EXISTS FOR. `DataGridToolbar`'s search input writes
+   * into the form on every keystroke; the snapshot must not follow it, or a
+   * chip appears mid-typing announcing a filter that filters nothing.
+   */
+  test("the snapshot ignores typing until apply() is called", () => {
+    const form = makeForm({
+      identifiant: "202"
+    });
+    const {
+      result
+    } = renderHook(() => useAppliedFilters(form, {
+      onApply: jest.fn(),
+      onReset: jest.fn(),
+      onRemove: jest.fn()
+    }));
+    expect(result.current.appliedFilters).toEqual({});
+    act(() => {
+      result.current.apply();
+    });
+    expect(result.current.appliedFilters).toEqual({
+      identifiant: "202"
+    });
+  });
+  test("apply() runs the screen's search, resetAll() clears and resets", () => {
+    const onApply = jest.fn();
+    const onReset = jest.fn();
+    const form = makeForm({
+      identifiant: "2025-IM-0042"
+    });
+    const {
+      result
+    } = renderHook(() => useAppliedFilters(form, {
+      onApply,
+      onReset,
+      onRemove: jest.fn()
+    }));
+    act(() => {
+      result.current.apply();
+    });
+    expect(onApply).toHaveBeenCalled();
+    act(() => {
+      result.current.resetAll();
+    });
+    expect(onReset).toHaveBeenCalled();
+    /* The mirror-image defect: a snapshot left full after "clear criteria"
+     * shows chips for criteria that no longer filter anything. */
+    expect(result.current.appliedFilters).toEqual({});
+  });
+
+  /**
+   * The payload is rebuilt from the AMPUTATED SNAPSHOT and never re-read from
+   * the form: `setFieldValue` is asynchronous, so reading values back would
+   * give the criteria as they were BEFORE the removal.
+   */
+  test("removeCriteria clears the fields and hands back the REMAINING criteria", () => {
+    const onRemove = jest.fn();
+    const form = makeForm({
+      identifiant: "2025-IM-0042",
+      importateurCode: {
+        id: 7
+      },
+      importateurId: 7
+    });
+    const {
+      result
+    } = renderHook(() => useAppliedFilters(form, {
+      onApply: jest.fn(),
+      onReset: jest.fn(),
+      onRemove
+    }));
+    act(() => {
+      result.current.apply();
+    });
+    act(() => {
+      result.current.removeCriteria(["importateurCode", "importateurId"]);
+    });
+    expect(form.setFieldValue).toHaveBeenCalledWith("importateurCode", null);
+    expect(form.setFieldValue).toHaveBeenCalledWith("importateurId", null);
+    expect(onRemove).toHaveBeenCalledWith({
+      identifiant: "2025-IM-0042",
+      importateurCode: null,
+      importateurId: null
+    });
+    expect(result.current.appliedFilters["importateurCode"]).toBeNull();
+  });
+
+  /**
+   * Hosts disagree on what "empty" means, per field — which is why this is a
+   * parameter and not a library convention. One real host clears id mirrors to
+   * `0` and everything else to `null`, because that is what ITS reset payload
+   * uses.
+   */
+  test("emptyValueFor lets the host decide what empty means, per field", () => {
+    const onRemove = jest.fn();
+    const form = makeForm({
+      categorie: {
+        id: 1
+      },
+      categorieId: 1
+    });
+    const {
+      result
+    } = renderHook(() => useAppliedFilters(form, {
+      onApply: jest.fn(),
+      onReset: jest.fn(),
+      onRemove,
+      emptyValueFor: key => key.endsWith("Id") ? 0 : null
+    }));
+    act(() => {
+      result.current.apply();
+    });
+    act(() => {
+      result.current.removeCriteria(["categorie", "categorieId"]);
+    });
+    expect(form.setFieldValue).toHaveBeenCalledWith("categorie", null);
+    expect(form.setFieldValue).toHaveBeenCalledWith("categorieId", 0);
+    expect(onRemove).toHaveBeenCalledWith({
+      categorie: null,
+      categorieId: 0
+    });
+  });
+
+  /**
+   * THE THREE PATHS THAT BYPASS apply(). Restoring a saved filter or clicking
+   * a status chip changes what actually filters the list without going through
+   * the form's submit — and both used to leave the chips lying: the list was
+   * filtered and NO chip appeared.
+   */
+  test("setApplied covers the paths that never go through apply()", () => {
+    const form = makeForm({});
+    const {
+      result
+    } = renderHook(() => useAppliedFilters(form, {
+      onApply: jest.fn(),
+      onReset: jest.fn(),
+      onRemove: jest.fn()
+    }));
+    act(() => {
+      result.current.setApplied({
+        statut: {
+          id: 3,
+          description: "Affecté"
+        }
+      });
+    });
+    expect(result.current.appliedFilters).toEqual({
+      statut: {
+        id: 3,
+        description: "Affecté"
+      }
+    });
+  });
+});
+//# sourceMappingURL=filterCriteria.test.js.map

package/dist/esm/v2/__tests__/filterCriteria.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterCriteria.test.js","names":["renderHook","act","buildFilterChips","filterCriteriaKeys","isCriterionSet","useAppliedFilters","describe","test","expect","toBe","undefined","id","description","criteria","key","label","chips","identifiant","villeEntreeId","jest","fn","toHaveLength","statut","importateurCode","lookup","typeReponse","format","v","String","onRemove","linkedKeys","toHaveBeenCalledWith","categorie_obj","toEqual","makeForm","values","setFieldValue","form","result","onApply","onReset","current","appliedFilters","apply","toHaveBeenCalled","resetAll","importateurId","removeCriteria","toBeNull","categorie","categorieId","emptyValueFor","endsWith","setApplied"],"sources":["../../../../src/lib/v2/__tests__/filterCriteria.test.tsx"],"sourcesContent":["/**\r\n * @jest-environment jsdom\r\n */\r\nimport { renderHook, act } from \"@testing-library/react\";\r\nimport {\r\n  buildFilterChips,\r\n  filterCriteriaKeys,\r\n  isCriterionSet,\r\n} from \"../patterns/filterCriteria\";\r\nimport type { FilterCriterion } from \"../patterns/filterCriteria\";\r\nimport useAppliedFilters from \"../hooks/useAppliedFilters\";\r\n\r\n/**\r\n * filterCriteria (G-42) + useAppliedFilters (G-43) — promoted from\r\n * `refonte-frontend` (Area 5).\r\n *\r\n * THE CASES BELOW ARE THE HOSTS' OWN, not invented ones. Each was read off the\r\n * nine listings that consumed these two capabilities, which is why this file\r\n * was written last: a test built on imagined descriptors would have covered\r\n * the easy half and missed all four things that actually differ between\r\n * screens.\r\n */\r\n\r\ndescribe(\"isCriterionSet\", () => {\r\n  /**\r\n   * CASE 1 — `0` MEANS UNSET. Four payloads in the promoting module carry\r\n   * `villeEntreeId: 0` / `importateurId: 0` as their \"no selection\" value. A\r\n   * chip appearing for `0` announces a criterion nobody chose.\r\n   */\r\n  test(\"0 is not set — it is the unset value of a reference mirror\", () => {\r\n    expect(isCriterionSet(0)).toBe(false);\r\n  });\r\n\r\n  test(\"null, undefined, empty string and empty array are not set\", () => {\r\n    expect(isCriterionSet(null)).toBe(false);\r\n    expect(isCriterionSet(undefined)).toBe(false);\r\n    expect(isCriterionSet(\"\")).toBe(false);\r\n    expect(isCriterionSet([])).toBe(false);\r\n  });\r\n\r\n  test(\"a reference object, a non-empty string and a non-zero id are set\", () => {\r\n    expect(isCriterionSet({ id: 42, description: \"SOFRANE SA\" })).toBe(true);\r\n    expect(isCriterionSet(\"2025-IM-0042\")).toBe(true);\r\n    expect(isCriterionSet(42)).toBe(true);\r\n  });\r\n});\r\n\r\ndescribe(\"buildFilterChips\", () => {\r\n  test(\"only SET criteria produce a chip\", () => {\r\n    const criteria: FilterCriterion[] = [\r\n      { key: \"identifiant\", label: \"Référence\" },\r\n      { key: \"villeEntreeId\", label: \"DPCI\" },\r\n    ];\r\n    const chips = buildFilterChips(\r\n      { identifiant: \"2025-IM-0042\", villeEntreeId: 0 },\r\n      criteria,\r\n      jest.fn()\r\n    );\r\n    expect(chips).toHaveLength(1);\r\n    expect(chips[0]?.key).toBe(\"identifiant\");\r\n  });\r\n\r\n  /**\r\n   * \"Label: value\" and not the value alone: \"AFFECTE\" does not say WHICH\r\n   * criterion it is when three chips sit side by side.\r\n   */\r\n  test(\"the chip reads « label : value »\", () => {\r\n    const chips = buildFilterChips(\r\n      { statut: { id: 3, description: \"Affecté\" } },\r\n      [{ key: \"statut\", label: \"Statut\" }],\r\n      jest.fn()\r\n    );\r\n    expect(chips[0]?.label).toBe(\"Statut : Affecté\");\r\n  });\r\n\r\n  test(\"a reference object renders through its description by default\", () => {\r\n    const chips = buildFilterChips(\r\n      { importateurCode: { id: 7, description: \"NOVATIS\" } },\r\n      [{ key: \"importateurCode\", label: \"Importateur\" }],\r\n      jest.fn()\r\n    );\r\n    expect(chips[0]?.label).toBe(\"Importateur : NOVATIS\");\r\n  });\r\n\r\n  /**\r\n   * CASE 4 — `format`. `typeReponse` stores the id DIRECTLY, with no object\r\n   * mirror, so without a formatter the chip would read \"Réponse ministère : 3\".\r\n   */\r\n  test(\"format renders a scalar id through the host's lookup\", () => {\r\n    const lookup: Record<string, string> = { \"3\": \"Favorable\" };\r\n    const chips = buildFilterChips(\r\n      { typeReponse: 3 },\r\n      [\r\n        {\r\n          key: \"typeReponse\",\r\n          label: \"Réponse ministère\",\r\n          format: (v) => lookup[String(v)] ?? String(v),\r\n        },\r\n      ],\r\n      jest.fn()\r\n    );\r\n    expect(chips[0]?.label).toBe(\"Réponse ministère : Favorable\");\r\n  });\r\n\r\n  /**\r\n   * CASE 2 — THE PAIR. Reference criteria are held as two fields: an object for\r\n   * display and a scalar mirror for the payload. Clearing only the displayed\r\n   * key removes the chip from the screen while the criterion STAYS IN THE\r\n   * PAYLOAD — an invisible filter that still filters.\r\n   */\r\n  test(\"removing a paired criterion clears its mirror too\", () => {\r\n    const onRemove = jest.fn();\r\n    const chips = buildFilterChips(\r\n      { importateurCode: { id: 7, description: \"NOVATIS\" } },\r\n      [\r\n        {\r\n          key: \"importateurCode\",\r\n          label: \"Importateur\",\r\n          linkedKeys: [\"importateurId\"],\r\n        },\r\n      ],\r\n      onRemove\r\n    );\r\n    chips[0]?.onRemove?.();\r\n    expect(onRemove).toHaveBeenCalledWith([\"importateurCode\", \"importateurId\"]);\r\n  });\r\n\r\n  /**\r\n   * CASE 3 — TWO NOMENCLATURES, not one mirror. One host's persisted filter\r\n   * suffixes its objects with `_obj` while its form names them plainly, so\r\n   * `linkedKeys` reconciles the two vocabularies: the chip READS\r\n   * `categorie_obj` and CLEARS all three keys.\r\n   */\r\n  test(\"linkedKeys can reconcile two key nomenclatures, not just a mirror\", () => {\r\n    const onRemove = jest.fn();\r\n    const chips = buildFilterChips(\r\n      { categorie_obj: { id: 1, description: \"Balances\" } },\r\n      [\r\n        {\r\n          key: \"categorie_obj\",\r\n          label: \"Catégorie d'IM\",\r\n          linkedKeys: [\"categorie\", \"categorieId\"],\r\n        },\r\n      ],\r\n      onRemove\r\n    );\r\n    chips[0]?.onRemove?.();\r\n    expect(onRemove).toHaveBeenCalledWith([\r\n      \"categorie_obj\",\r\n      \"categorie\",\r\n      \"categorieId\",\r\n    ]);\r\n  });\r\n\r\n  test(\"filterCriteriaKeys lists every key, mirrors included — for a clear-all\", () => {\r\n    expect(\r\n      filterCriteriaKeys([\r\n        { key: \"identifiant\", label: \"Référence\" },\r\n        { key: \"delegation\", label: \"DPCI\", linkedKeys: [\"delegationId\", \"villeEntreeId\"] },\r\n      ])\r\n    ).toEqual([\"identifiant\", \"delegation\", \"delegationId\", \"villeEntreeId\"]);\r\n  });\r\n});\r\n\r\ndescribe(\"useAppliedFilters\", () => {\r\n  interface Form {\r\n    values: Record<string, unknown>;\r\n    setFieldValue: jest.Mock;\r\n  }\r\n\r\n  const makeForm = (values: Record<string, unknown>): Form => ({\r\n    values,\r\n    setFieldValue: jest.fn(),\r\n  });\r\n\r\n  /**\r\n   * THE DEFECT THIS HOOK EXISTS FOR. `DataGridToolbar`'s search input writes\r\n   * into the form on every keystroke; the snapshot must not follow it, or a\r\n   * chip appears mid-typing announcing a filter that filters nothing.\r\n   */\r\n  test(\"the snapshot ignores typing until apply() is called\", () => {\r\n    const form = makeForm({ identifiant: \"202\" });\r\n    const { result } = renderHook(() =>\r\n      useAppliedFilters(form, {\r\n        onApply: jest.fn(),\r\n        onReset: jest.fn(),\r\n        onRemove: jest.fn(),\r\n      })\r\n    );\r\n\r\n    expect(result.current.appliedFilters).toEqual({});\r\n\r\n    act(() => {\r\n      result.current.apply();\r\n    });\r\n    expect(result.current.appliedFilters).toEqual({ identifiant: \"202\" });\r\n  });\r\n\r\n  test(\"apply() runs the screen's search, resetAll() clears and resets\", () => {\r\n    const onApply = jest.fn();\r\n    const onReset = jest.fn();\r\n    const form = makeForm({ identifiant: \"2025-IM-0042\" });\r\n    const { result } = renderHook(() =>\r\n      useAppliedFilters(form, { onApply, onReset, onRemove: jest.fn() })\r\n    );\r\n\r\n    act(() => {\r\n      result.current.apply();\r\n    });\r\n    expect(onApply).toHaveBeenCalled();\r\n\r\n    act(() => {\r\n      result.current.resetAll();\r\n    });\r\n    expect(onReset).toHaveBeenCalled();\r\n    /* The mirror-image defect: a snapshot left full after \"clear criteria\"\r\n     * shows chips for criteria that no longer filter anything. */\r\n    expect(result.current.appliedFilters).toEqual({});\r\n  });\r\n\r\n  /**\r\n   * The payload is rebuilt from the AMPUTATED SNAPSHOT and never re-read from\r\n   * the form: `setFieldValue` is asynchronous, so reading values back would\r\n   * give the criteria as they were BEFORE the removal.\r\n   */\r\n  test(\"removeCriteria clears the fields and hands back the REMAINING criteria\", () => {\r\n    const onRemove = jest.fn();\r\n    const form = makeForm({\r\n      identifiant: \"2025-IM-0042\",\r\n      importateurCode: { id: 7 },\r\n      importateurId: 7,\r\n    });\r\n    const { result } = renderHook(() =>\r\n      useAppliedFilters(form, {\r\n        onApply: jest.fn(),\r\n        onReset: jest.fn(),\r\n        onRemove,\r\n      })\r\n    );\r\n\r\n    act(() => {\r\n      result.current.apply();\r\n    });\r\n    act(() => {\r\n      result.current.removeCriteria([\"importateurCode\", \"importateurId\"]);\r\n    });\r\n\r\n    expect(form.setFieldValue).toHaveBeenCalledWith(\"importateurCode\", null);\r\n    expect(form.setFieldValue).toHaveBeenCalledWith(\"importateurId\", null);\r\n    expect(onRemove).toHaveBeenCalledWith({\r\n      identifiant: \"2025-IM-0042\",\r\n      importateurCode: null,\r\n      importateurId: null,\r\n    });\r\n    expect(result.current.appliedFilters[\"importateurCode\"]).toBeNull();\r\n  });\r\n\r\n  /**\r\n   * Hosts disagree on what \"empty\" means, per field — which is why this is a\r\n   * parameter and not a library convention. One real host clears id mirrors to\r\n   * `0` and everything else to `null`, because that is what ITS reset payload\r\n   * uses.\r\n   */\r\n  test(\"emptyValueFor lets the host decide what empty means, per field\", () => {\r\n    const onRemove = jest.fn();\r\n    const form = makeForm({ categorie: { id: 1 }, categorieId: 1 });\r\n    const { result } = renderHook(() =>\r\n      useAppliedFilters(form, {\r\n        onApply: jest.fn(),\r\n        onReset: jest.fn(),\r\n        onRemove,\r\n        emptyValueFor: (key) => (key.endsWith(\"Id\") ? 0 : null),\r\n      })\r\n    );\r\n\r\n    act(() => {\r\n      result.current.apply();\r\n    });\r\n    act(() => {\r\n      result.current.removeCriteria([\"categorie\", \"categorieId\"]);\r\n    });\r\n\r\n    expect(form.setFieldValue).toHaveBeenCalledWith(\"categorie\", null);\r\n    expect(form.setFieldValue).toHaveBeenCalledWith(\"categorieId\", 0);\r\n    expect(onRemove).toHaveBeenCalledWith({ categorie: null, categorieId: 0 });\r\n  });\r\n\r\n  /**\r\n   * THE THREE PATHS THAT BYPASS apply(). Restoring a saved filter or clicking\r\n   * a status chip changes what actually filters the list without going through\r\n   * the form's submit — and both used to leave the chips lying: the list was\r\n   * filtered and NO chip appeared.\r\n   */\r\n  test(\"setApplied covers the paths that never go through apply()\", () => {\r\n    const form = makeForm({});\r\n    const { result } = renderHook(() =>\r\n      useAppliedFilters(form, {\r\n        onApply: jest.fn(),\r\n        onReset: jest.fn(),\r\n        onRemove: jest.fn(),\r\n      })\r\n    );\r\n\r\n    act(() => {\r\n      result.current.setApplied({ statut: { id: 3, description: \"Affecté\" } });\r\n    });\r\n\r\n    expect(result.current.appliedFilters).toEqual({\r\n      statut: { id: 3, description: \"Affecté\" },\r\n    });\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/__tests__/fmtDate.test.js

@@ -0,0 +1,68 @@
+import { fmtDate, fmtDateTime } from "../utils/fmtDate";
+
+/* Local time, deliberately (see the file header): the assertions below build
+ * their expectations from a local-time Date so the suite passes in any CI
+ * timezone. Where an ISO instant is used as input, only the parts that cannot
+ * shift with the zone are asserted. */
+
+describe("fmtDate", () => {
+  it("formats a Date as DD/MM/YYYY", () => {
+    expect(fmtDate(new Date(2026, 2, 5))).toBe("05/03/2026");
+  });
+  it("pads day and month to two digits", () => {
+    expect(fmtDate(new Date(2026, 0, 9))).toBe("09/01/2026");
+  });
+
+  /* THE DEFECT THIS EXISTS FOR. Every module copy fed `new Date(undefined)`
+   * into `getDate()`, whose accessors all return NaN — so an optional date
+   * field rendered the literal "NaN/NaN/NaN". */
+  it("never renders NaN for an absent or unparseable value", () => {
+    expect(fmtDate(undefined)).toBe("—");
+    expect(fmtDate(null)).toBe("—");
+    expect(fmtDate("")).toBe("—");
+    expect(fmtDate("pas une date")).toBe("—");
+    expect(fmtDate(new Date("nope"))).toBe("—");
+    expect(fmtDate(undefined)).not.toContain("NaN");
+    expect(fmtDateTime(undefined)).not.toContain("NaN");
+  });
+
+  /* An absent date must be DISTINGUISHABLE from a cell that failed to render,
+   * which an empty string is not. */
+  it("marks absence with an em dash by default", () => {
+    expect(fmtDate(null)).toBe("—");
+  });
+  it("accepts a caller-chosen absence mark, for a deliberately empty cell", () => {
+    expect(fmtDate(null, {
+      absent: ""
+    })).toBe("");
+    expect(fmtDateTime(null, {
+      absent: ""
+    })).toBe("");
+  });
+
+  /* `new Date(0)` is a real instant (1970) while `new Date("")` is Invalid: a
+   * falsy guard would conflate them, so epoch 0 must survive. */
+  it("treats epoch 0 as a date, not as absent", () => {
+    expect(fmtDate(0)).not.toBe("—");
+    expect(fmtDate(0)).toMatch(/^\d{2}\/\d{2}\/19(69|70)$/);
+  });
+  it("parses an ISO string from the API", () => {
+    // Day can shift with the runner's zone; the month and year cannot here.
+    expect(fmtDate("2026-03-05T12:00:00Z")).toMatch(/^\d{2}\/03\/2026$/);
+  });
+});
+describe("fmtDateTime", () => {
+  it("formats a Date as DD/MM/YYYY HH:mm", () => {
+    expect(fmtDateTime(new Date(2026, 2, 5, 14, 30))).toBe("05/03/2026 14:30");
+  });
+  it("pads hours and minutes", () => {
+    expect(fmtDateTime(new Date(2026, 2, 5, 9, 5))).toBe("05/03/2026 09:05");
+  });
+  it("omits seconds", () => {
+    expect(fmtDateTime(new Date(2026, 2, 5, 14, 30, 59))).toBe("05/03/2026 14:30");
+  });
+  it("renders midnight as 00:00, not as absent", () => {
+    expect(fmtDateTime(new Date(2026, 2, 5, 0, 0))).toBe("05/03/2026 00:00");
+  });
+});
+//# sourceMappingURL=fmtDate.test.js.map

package/dist/esm/v2/__tests__/fmtDate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmtDate.test.js","names":["fmtDate","fmtDateTime","describe","it","expect","Date","toBe","undefined","not","toContain","absent","toMatch"],"sources":["../../../../src/lib/v2/__tests__/fmtDate.test.ts"],"sourcesContent":["import { fmtDate, fmtDateTime } from \"../utils/fmtDate\";\r\n\r\n/* Local time, deliberately (see the file header): the assertions below build\r\n * their expectations from a local-time Date so the suite passes in any CI\r\n * timezone. Where an ISO instant is used as input, only the parts that cannot\r\n * shift with the zone are asserted. */\r\n\r\ndescribe(\"fmtDate\", () => {\r\n  it(\"formats a Date as DD/MM/YYYY\", () => {\r\n    expect(fmtDate(new Date(2026, 2, 5))).toBe(\"05/03/2026\");\r\n  });\r\n\r\n  it(\"pads day and month to two digits\", () => {\r\n    expect(fmtDate(new Date(2026, 0, 9))).toBe(\"09/01/2026\");\r\n  });\r\n\r\n  /* THE DEFECT THIS EXISTS FOR. Every module copy fed `new Date(undefined)`\r\n   * into `getDate()`, whose accessors all return NaN — so an optional date\r\n   * field rendered the literal \"NaN/NaN/NaN\". */\r\n  it(\"never renders NaN for an absent or unparseable value\", () => {\r\n    expect(fmtDate(undefined)).toBe(\"—\");\r\n    expect(fmtDate(null)).toBe(\"—\");\r\n    expect(fmtDate(\"\")).toBe(\"—\");\r\n    expect(fmtDate(\"pas une date\")).toBe(\"—\");\r\n    expect(fmtDate(new Date(\"nope\"))).toBe(\"—\");\r\n\r\n    expect(fmtDate(undefined)).not.toContain(\"NaN\");\r\n    expect(fmtDateTime(undefined)).not.toContain(\"NaN\");\r\n  });\r\n\r\n  /* An absent date must be DISTINGUISHABLE from a cell that failed to render,\r\n   * which an empty string is not. */\r\n  it(\"marks absence with an em dash by default\", () => {\r\n    expect(fmtDate(null)).toBe(\"—\");\r\n  });\r\n\r\n  it(\"accepts a caller-chosen absence mark, for a deliberately empty cell\", () => {\r\n    expect(fmtDate(null, { absent: \"\" })).toBe(\"\");\r\n    expect(fmtDateTime(null, { absent: \"\" })).toBe(\"\");\r\n  });\r\n\r\n  /* `new Date(0)` is a real instant (1970) while `new Date(\"\")` is Invalid: a\r\n   * falsy guard would conflate them, so epoch 0 must survive. */\r\n  it(\"treats epoch 0 as a date, not as absent\", () => {\r\n    expect(fmtDate(0)).not.toBe(\"—\");\r\n    expect(fmtDate(0)).toMatch(/^\\d{2}\\/\\d{2}\\/19(69|70)$/);\r\n  });\r\n\r\n  it(\"parses an ISO string from the API\", () => {\r\n    // Day can shift with the runner's zone; the month and year cannot here.\r\n    expect(fmtDate(\"2026-03-05T12:00:00Z\")).toMatch(/^\\d{2}\\/03\\/2026$/);\r\n  });\r\n});\r\n\r\ndescribe(\"fmtDateTime\", () => {\r\n  it(\"formats a Date as DD/MM/YYYY HH:mm\", () => {\r\n    expect(fmtDateTime(new Date(2026, 2, 5, 14, 30))).toBe(\"05/03/2026 14:30\");\r\n  });\r\n\r\n  it(\"pads hours and minutes\", () => {\r\n    expect(fmtDateTime(new Date(2026, 2, 5, 9, 5))).toBe(\"05/03/2026 09:05\");\r\n  });\r\n\r\n  it(\"omits seconds\", () => {\r\n    expect(fmtDateTime(new Date(2026, 2, 5, 14, 30, 59))).toBe(\r\n      \"05/03/2026 14:30\"\r\n    );\r\n  });\r\n\r\n  it(\"renders midnight as 00:00, not as absent\", () => {\r\n    expect(fmtDateTime(new Date(2026, 2, 5, 0, 0))).toBe(\"05/03/2026 00:00\");\r\n  });\r\n});\r\n"],"mappings":"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","ignoreList":[]}