@rokt/dcui-orchestrator 1.2.1-rc.44 → 1.2.1-rc.46

package/dist/libraries/dcui-components/src/components/style-mapper/combiners/escape-css-string.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Escapes the characters that can end or escape a double-quoted CSS string:
+ * a double quote and a backslash get a backslash in front, and a CSS newline
+ * (LF, CR, FF) becomes its hex escape with a space terminator. A value written
+ * into url("...") then stays inside the quotes even when the validator in
+ * front of it lets one of them through.
+ *
+ * A colon and a semicolon become their hex escapes too. The css writer
+ * (Emotion) scans the whole style string for `label:<name>` and appends the
+ * name to the class it inserts, and the rule's own closing `");` ends a
+ * label that the value starts (the `")` is read into the name, the `;` ends
+ * it), so a label read out of the value would turn that class into a
+ * selector list that reaches the host page. The colon is escaped so the word
+ * label can never be followed by one, and the semicolon so a raw one cannot
+ * end such a label. The browser decodes both back to the same url.
+ */
+export declare function escapeCSSString(value: string): string;

package/dist/libraries/dcui-components/src/components/style-mapper/combiners/index.d.ts

@@ -1,4 +1,5 @@
 export * from './apply-from-spec';
+export * from './escape-css-string';
 export * from './join';
 export * from './join-to-css-rule';
 export * from './join-to-media-query';

package/dist/libraries/dcui-components/src/utils/responsive-css.d.ts

@@ -1 +1,10 @@
+/**
+ * A breakpoint width is written into CSS text, a media query or a class name,
+ * so only a finite, non-negative number is interpolated. The store replaces
+ * every other layout value before it arrives here; this is the second check,
+ * for a width that reaches the style mapper another way. A value that is not
+ * a width gets a form that matches nothing, never a rule that applies
+ * everywhere.
+ */
+export declare function isBreakpointWidth(width: unknown): width is number;
 export declare function getBreakpointCSSClass(width?: number): string;

package/dist/libraries/layout-renderer-utils/src/reducers/breakpoint/coerce-breakpoints.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A layout's breakpoint widths end up in CSS text: the saga builds a matchMedia
+ * query from each one, and the style mapper writes each into a media query or
+ * a class name. Only a finite, non-negative number is a width there. Any other
+ * value becomes INVALID_BREAKPOINT_WIDTH, which the saga and the style mapper
+ * skip, so its styles never apply, as the browser dropped the malformed rule
+ * before. A key is never dropped: the style mapper pairs an element's style
+ * blocks with the breakpoints by position, so a missing key would move every
+ * later block onto the wrong width.
+ */
+/**
+ * Not a width. No media query is registered for it, no style rule is written
+ * for it, and every comparison with it is false, so a breakpoint that carries
+ * it is never active and never styles anything.
+ */
+export declare const INVALID_BREAKPOINT_WIDTH: number;
+export declare function isBreakpointWidth(value: unknown): value is number;
+export declare function coerceBreakpointWidth(value: unknown): number;
+export declare function coerceBreakpoints(breakpoints: unknown): Record<string, number>;

package/dist/libraries/layout-renderer-utils/src/reducers/breakpoint/index.d.ts

@@ -1 +1,2 @@
 export * from './reducer';
+export * from './coerce-breakpoints';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokt/dcui-orchestrator",
-  "version": "1.2.1-rc.44",
+  "version": "1.2.1-rc.46",
   "description": "Rokt's DCUI rendering process",
   "main": "dist/index.cjs",
   "module": "dist/index.js",