cbrowser 20.2.2 → 21.0.0

package/dist/cif-score.d.ts

@@ -11,6 +11,27 @@
  * 4. Sensory Fitness (15%) -- can they process without overload?
  * 5. Navigation Fitness (20%) -- can they get around?
  *
+ * Every number the score computes with is read through param() from
+ * visual/provenance/cif.ts, which says where it comes from: five are WCAG's,
+ * four are units or display choices, and the rest (the weights above among
+ * them) were set by hand. tests/cif-no-literals.test.ts keeps it that way.
+ *
+ * MISSING INPUTS follow one rule, stated with its rationale at cif.noData.score
+ * in visual/provenance/cif.ts: a component scores only from inputs the caller
+ * supplied, no assumed value ever stands in for a missing one, and a component
+ * with none of its inputs supplied is marked `measured: false`, scores
+ * cif.noData.score, says "Not measured" in its details, is listed in
+ * `notMeasured` and is never a top issue. `barriers` counts as supplied when it
+ * is an array, even an empty one (an audit ran and found nothing); undefined
+ * means no audit ran.
+ *
+ * CERTIFICATION needs every component measured. The grade is read from the
+ * composite as always, but platinum, gold, silver and bronze are issued only
+ * when all 25 components were measured; otherwise the certification is "none"
+ * and `certificationNote` says how many were not. An unmeasured component scores
+ * cif.noData.score, so without this a page with nothing measured certified
+ * bronze. (Alexa, 2026-10-24.)
+ *
  * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
  * @license MIT
  * @since v19.0.0
@@ -18,11 +39,25 @@
 export interface CIFComponentScore {
     score: number;
     details: string;
+    /**
+     * False when none of the inputs this component reads was supplied: it then
+     * scores cif.noData.score, its details begin "Not measured", and it is left
+     * out of topIssues.
+     */
+    measured: boolean;
 }
 export interface CIFScore {
     composite: number;
     grade: string;
+    /** platinum, gold, silver or bronze only when every component was measured; otherwise "none". */
     certification: string;
+    /** How many of the components were not measured (the length of `notMeasured`). */
+    notMeasuredCount: number;
+    /**
+     * The sentence a customer reads when a component went unmeasured, e.g.
+     * "Not certified: 3 of 25 components not measured."; null when all were measured.
+     */
+    certificationNote: string | null;
     motor: {
         score: number;
         components: {
@@ -79,6 +114,8 @@ export interface CIFScore {
         score: number;
         fix: string;
     }>;
+    /** "category.component" for every component that was not measured, so the grade is never read without them. */
+    notMeasured: string[];
     url: string;
     timestamp: string;
 }
@@ -89,7 +126,20 @@ export interface CIFInput {
         element?: string;
         description?: string;
         wcagCriteria?: string[];
+        /**
+         * The persona-weight key empathy_audit's detector set, if any. Its
+         * close-spacing barrier (type motor_precision) carries "target_spacing";
+         * spacingAdequacy counts those and keyboardOperability skips them, so the
+         * barrier is counted once.
+         */
+        weightKey?: string;
     }>;
+    /**
+     * True when the audit that produced `barriers` checked for skip links.
+     * empathy_audit has no skip-link detector, so its callers leave this unset
+     * and skipMechanisms reads "not measured" unless the list holds a skip finding.
+     */
+    skipLinksChecked?: boolean;
     touchTargets?: Array<{
         width: number;
         height: number;
@@ -131,11 +181,12 @@ export interface CIFInput {
     url: string;
 }
 /**
- * Compute the CIF (Cognitive Interface Fitness) score from raw tool data.
- *
- * Accepts data from empathy_audit, agent_ready_audit, cognitive_effort CTC,
- * page_understand, and attention_analysis. All fields are optional --
- * missing data produces conservative estimates with lower confidence.
+ * The grade for a composite, from the registered cif.grade.* bands. Exported so
+ * a caller that grades an average of composites (the dashboard) uses these bands
+ * rather than a copy of their numbers.
  */
+export declare function computeGrade(composite: number): string;
+/** Fix text for a measured component. Exported for tests; topIssues is the only caller. */
+export declare function generateFixRecommendation(category: string, component: string, score: number, data: CIFInput): string;
 export declare function computeCIFScore(data: CIFInput): CIFScore;
 //# sourceMappingURL=cif-score.d.ts.map

package/dist/cif-score.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cif-score.d.ts","sourceRoot":"","sources":["../src/cif-score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IAEtB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE;YACV,qBAAqB,EAAE,iBAAiB,CAAC;YACzC,cAAc,EAAE,iBAAiB,CAAC;YAClC,gBAAgB,EAAE,iBAAiB,CAAC;YACpC,eAAe,EAAE,iBAAiB,CAAC;YACnC,oBAAoB,EAAE,iBAAiB,CAAC;SACzC,CAAC;KACH,CAAC;IAEF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE;YACV,kBAAkB,EAAE,iBAAiB,CAAC;YACtC,eAAe,EAAE,iBAAiB,CAAC;YACnC,iBAAiB,EAAE,iBAAiB,CAAC;YACrC,eAAe,EAAE,iBAAiB,CAAC;YACnC,cAAc,EAAE,iBAAiB,CAAC;SACnC,CAAC;KACH,CAAC;IAEF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE;YACV,kBAAkB,EAAE,iBAAiB,CAAC;YACtC,WAAW,EAAE,iBAAiB,CAAC;YAC/B,kBAAkB,EAAE,iBAAiB,CAAC;YACtC,gBAAgB,EAAE,iBAAiB,CAAC;YACpC,cAAc,EAAE,iBAAiB,CAAC;SACnC,CAAC;KACH,CAAC;IAEF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE;YACV,gBAAgB,EAAE,iBAAiB,CAAC;YACpC,mBAAmB,EAAE,iBAAiB,CAAC;YACvC,UAAU,EAAE,iBAAiB,CAAC;YAC9B,iBAAiB,EAAE,iBAAiB,CAAC;YACrC,iBAAiB,EAAE,iBAAiB,CAAC;SACtC,CAAC;KACH,CAAC;IAEF,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE;YACV,iBAAiB,EAAE,iBAAiB,CAAC;YACrC,mBAAmB,EAAE,iBAAiB,CAAC;YACvC,cAAc,EAAE,iBAAiB,CAAC;YAClC,iBAAiB,EAAE,iBAAiB,CAAC;YACrC,iBAAiB,EAAE,iBAAiB,CAAC;SACtC,CAAC;KACH,CAAC;IAEF,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IAEvB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAGH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAGlC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,GAAG,EAAE,MAAM,CAAC;CACb;AAgrBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAyCxD"}
+{"version":3,"file":"cif-score.d.ts","sourceRoot":"","sources":["../src/cif-score.ts"],"names":[],"mappings":"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"}