@wix/origami-transforms 0.1.28 → 0.1.30

package/dist/cssPlugins/componentPosition.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const componentPositionPlugin: import("../transform/types.js").CssTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const componentPositionPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/cssPlugins/customEnums.d.ts

@@ -1,3 +1,6 @@
 export function removeCustomEnums(root: any): void;
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const customEnumsPlugin: import("../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["duplicate_enum", "non_literal_enum_value", "unknown_enum_value", "enum_parent_selector_list"];
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const customEnumsPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/customMedia.d.ts

@@ -1,2 +1,7 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const customMediaPlugin: import("../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["unresolved_custom_media"];
+export function fail<E extends Error>(check: Check, error: E): E & {
+    check: "unresolved_custom_media";
+};
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const customMediaPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/fonts.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const fontsPlugin: import("../transform/types.js").CssTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const fontsPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/cssPlugins/index.d.ts

@@ -1,2 +1,2 @@
-/** @type {readonly import('../transform/types.js').CssTransformPlugin[]} */
-export const cssPlugins: readonly import("../transform/types.js").CssTransformPlugin[];
+/** @type {readonly import('../transform/types.js').CssTransformPlugin<string>[]} */
+export const cssPlugins: readonly import("../transform/types.js").CssTransformPlugin<string>[];

package/dist/cssPlugins/layout/index.d.ts

@@ -1,2 +1,7 @@
-/** @type {import('../../transform/types.js').CssTransformPlugin} */
-export const layoutPlugin: import("../../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["unknown_target", "target_requires_component_id", "invalid_target_envelope", "target_not_site_layout", "duplicate_target", "target_requires_declarations", "duplicate_target_property", "property_wrong_target", "content_position_not_relative", "unsupported_overflow", "unsupported_content_alignment", "inconsistent_container_display", "duplicate_root_property", "property_requires_target"];
+export function fail<E extends Error>(check: Check, error: E): E & {
+    check: "unknown_target" | "target_requires_component_id" | "invalid_target_envelope" | "target_not_site_layout" | "duplicate_target" | "target_requires_declarations" | "duplicate_target_property" | "property_wrong_target" | "content_position_not_relative" | "unsupported_overflow" | "unsupported_content_alignment" | "inconsistent_container_display" | "duplicate_root_property" | "property_requires_target";
+};
+/** @type {import('../../transform/types.js').CssTransformPlugin<Check>} */
+export const layoutPlugin: import("../../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/mixins.d.ts

@@ -1,2 +1,7 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const mixinsPlugin: import("../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["missing_mixin", "cyclic_apply", "expansion_depth_exceeded", "cloned_node_budget_exceeded", "cloned_css_budget_exceeded"];
+export function fail<E extends Error>(check: Check, error: E): E & {
+    check: "missing_mixin" | "cyclic_apply" | "expansion_depth_exceeded" | "cloned_node_budget_exceeded" | "cloned_css_budget_exceeded";
+};
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const mixinsPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/presets.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const presetsPlugin: import("../transform/types.js").CssTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const presetsPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/cssPlugins/shapeDividers.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const shapeDividersPlugin: import("../transform/types.js").CssTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const shapeDividersPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/cssPlugins/spx/calls.d.ts

@@ -1 +1,4 @@
+export const THEME_SPX: "--theme-spx(";
 export function lowerCalls(declaration: import("postcss").Declaration, resolve: (value: number) => string, invalidCall: () => Error): void;
+export function lowerThemeCalls(declaration: import("postcss").Declaration, resolve: (value: number, themeRefWidth: number) => string, invalidCall: () => Error): void;
+export function toThemeCalls(value: string, themeRefWidth: number): string;

package/dist/cssPlugins/spx/index.d.ts

@@ -1,2 +1,7 @@
-/** @type {import('../../transform/types.js').CssTransformPlugin} */
-export const spxPlugin: import("../../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["unsupported_spx_resolver", "invalid_spx_reference_width", "non_literal_spx_argument"];
+export function fail<E extends Error>(check: Check, error: E): E & {
+    check: "unsupported_spx_resolver" | "invalid_spx_reference_width" | "non_literal_spx_argument";
+};
+/** @type {import('../../transform/types.js').CssTransformPlugin<Check>} */
+export const spxPlugin: import("../../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/spxThemeVariables/index.d.ts

@@ -0,0 +1,6 @@
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../../transform/types.js').CssTransformPlugin<Check>} */
+export const spxThemeVariablesPlugin: import("../../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/cssPlugins/spxThemeVariables/utils/breakpointUtils.d.ts

@@ -0,0 +1,23 @@
+export function maxWidthOf(query: string): number | undefined;
+export function breakpointOf(ancestors: readonly import("postcss").Node[]): string;
+export function widestFirst(breakpoints: readonly string[]): string[];
+export function themeBreakpointsOf({ breakpoints }: ThemeVariables): string[];
+export function inheritedBreakpointsOf({ breakpoints }: ThemeVariables, breakpoint: string): string[];
+export function cascadeAt({ rules }: ThemeVariables, cascadeBreakpoints: readonly string[]): Map<string, CascadedVariable>;
+export function resolveRefWidths(breakpoints: readonly string[], ownRefWidths: Map<string, number>): Map<string, number>;
+export function refWidthAt({ refWidthByBreakpoint }: ThemeVariables, breakpoint: string): number;
+export type VariableMap = Map<string, import("postcss").Declaration>;
+export type ThemeRule = {
+    scanned: import("./stylesheetUtils.js").ScannedRule;
+    variables: VariableMap;
+};
+export type ThemeVariables = {
+    rules: ThemeRule[];
+    breakpoints: string[];
+    refWidthByBreakpoint: Map<string, number>;
+};
+export type CascadedVariable = {
+    declaration: import("postcss").Declaration;
+    breakpoint: string;
+    index: number;
+};

package/dist/cssPlugins/spxThemeVariables/utils/copyPlanUtils.d.ts

@@ -0,0 +1,14 @@
+export function planBreakpoints(theme: ThemeVariables): BreakpointPlan;
+export function planThemeCopies(theme: ThemeVariables, breakpointPlan: BreakpointPlan): ThemeCopies;
+export type CascadedVariable = import("./breakpointUtils.js").CascadedVariable;
+export type ThemeVariables = import("./breakpointUtils.js").ThemeVariables;
+export type VariableMap = import("./breakpointUtils.js").VariableMap;
+export type Declaration = import("postcss").Declaration;
+export type ThemeCopies = Map<string, VariableMap>;
+export type VariableReferences = Map<string, string[]>;
+export type BreakpointPlan = Map<string, string[]>;
+export type CopyCriteria = {
+    ownVariables: VariableMap;
+    scaleDependent: Set<string>;
+    widerCopied: Set<string>;
+};

package/dist/cssPlugins/spxThemeVariables/utils/cssTreeUtils.d.ts

@@ -0,0 +1,10 @@
+export const DESKTOP: "";
+export function ancestorsOf(node: import("postcss").Node): import("postcss").Node[];
+export function isAtRule(node: import("postcss").Node): node is import("postcss").AtRule;
+export function collapseWhitespace(text: string): string;
+export function isInContainerDefaults(ancestors: readonly import("postcss").Node[]): boolean;
+export function isTopLevel(ancestors: readonly import("postcss").Node[]): ancestors is readonly import("postcss").AtRule[];
+export function hasRootSelector(rule: import("postcss").Rule): boolean;
+export function isCustomProperty(prop: string): boolean;
+export function isMedia(node: import("postcss").Node): node is import("postcss").AtRule;
+export function declarationsOf(rule: import("postcss").Rule): import("postcss").Declaration[];

package/dist/cssPlugins/spxThemeVariables/utils/restateUtils.d.ts

@@ -0,0 +1,9 @@
+export function restateThemeVariables(theme: ThemeVariables, breakpointPlan: BreakpointPlan): void;
+export type CascadedVariable = import("./breakpointUtils.js").CascadedVariable;
+export type ThemeVariables = import("./breakpointUtils.js").ThemeVariables;
+export type BreakpointPlan = import("./copyPlanUtils.js").BreakpointPlan;
+export type RestateTarget = {
+    breakpoint: string;
+    index: number;
+    refWidth: number;
+};

package/dist/cssPlugins/spxThemeVariables/utils/sectionUtils.d.ts

@@ -0,0 +1,6 @@
+/** @typedef {import('./stylesheetUtils.js').ScannedRule} ScannedRule */
+/** @typedef {import('./wrappingAtRuleUtils.js').Section} Section */
+export const CONTENT_MAX_WIDTH: "--content-max-width";
+export function readSectionRules(layoutRules: readonly ScannedRule[]): Section[];
+export type ScannedRule = import("./stylesheetUtils.js").ScannedRule;
+export type Section = import("./wrappingAtRuleUtils.js").Section;

package/dist/cssPlugins/spxThemeVariables/utils/stylesheetUtils.d.ts

@@ -0,0 +1,10 @@
+export function scanStylesheet(root: import("postcss").Root, siteFolder: string): StylesheetScan;
+export type ScannedRule = {
+    rule: import("postcss").Rule;
+    breakpoint: string;
+    declarations: import("postcss").Declaration[];
+};
+export type StylesheetScan = {
+    themeRules: ScannedRule[];
+    layoutRules: ScannedRule[];
+};

package/dist/cssPlugins/spxThemeVariables/utils/themeUtils.d.ts

@@ -0,0 +1,6 @@
+export function readThemeVariables(themeRules: readonly ScannedRule[]): ThemeVariables;
+export function tagThemeVariables(themeRules: readonly ScannedRule[], theme: ThemeVariables): void;
+export type ThemeRule = import("./breakpointUtils.js").ThemeRule;
+export type ThemeVariables = import("./breakpointUtils.js").ThemeVariables;
+export type VariableMap = import("./breakpointUtils.js").VariableMap;
+export type ScannedRule = import("./stylesheetUtils.js").ScannedRule;

package/dist/cssPlugins/spxThemeVariables/utils/wrappingAtRuleUtils.d.ts

@@ -0,0 +1,10 @@
+export function wrappingAtRulesOf(rule: import("postcss").Rule): import("postcss").AtRule[];
+export function groupSectionsByWrappingAtRules(sections: readonly Section[]): SectionGroup[];
+export type Section = {
+    selector: string;
+    wrappingAtRules: import("postcss").AtRule[];
+};
+export type SectionGroup = {
+    wrappingAtRules: import("postcss").AtRule[];
+    selectors: string[];
+};

package/dist/cssPlugins/spxThemeVariables/utils/writeUtils.d.ts

@@ -0,0 +1,17 @@
+/** @typedef {import('./copyPlanUtils.js').ThemeCopies} ThemeCopies */
+/** @typedef {import('./wrappingAtRuleUtils.js').Section} Section */
+/** @typedef {import('./wrappingAtRuleUtils.js').SectionGroup} SectionGroup */
+/**
+ * @typedef {object} BreakpointCopies
+ * @property {string} breakpoint
+ * @property {import('postcss').Declaration[]} declarations
+ */
+export const THEME_COPIES_LAYER: "origami-theme-copies";
+export function writeCopies(root: import("postcss").Root, themeCopies: ThemeCopies, sections: readonly Section[]): void;
+export type ThemeCopies = import("./copyPlanUtils.js").ThemeCopies;
+export type Section = import("./wrappingAtRuleUtils.js").Section;
+export type SectionGroup = import("./wrappingAtRuleUtils.js").SectionGroup;
+export type BreakpointCopies = {
+    breakpoint: string;
+    declarations: import("postcss").Declaration[];
+};

package/dist/cssPlugins/stackChildren.d.ts

@@ -1,2 +1,5 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const stackChildrenPlugin: import("../transform/types.js").CssTransformPlugin;
+export const checks: readonly ["child_not_in_stack"];
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const stackChildrenPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/cssPlugins/wixVectorUrls.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../transform/types.js').CssTransformPlugin} */
-export const wixVectorUrlsPlugin: import("../transform/types.js").CssTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
+export const wixVectorUrlsPlugin: import("../transform/types.js").CssTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/jsxPlugins/index.d.ts

@@ -1,2 +1,2 @@
-/** @type {readonly import('../transform/types.js').JsxTransformPlugin[]} */
-export const jsxPlugins: readonly import("../transform/types.js").JsxTransformPlugin[];
+/** @type {readonly import('../transform/types.js').JsxTransformPlugin<string>[]} */
+export const jsxPlugins: readonly import("../transform/types.js").JsxTransformPlugin<string>[];

package/dist/jsxPlugins/mediaValidation/index.d.ts

@@ -1,2 +1,5 @@
-/** @type {import('../../transform/types.js').JsxTransformPlugin} */
-export const mediaValidationPlugin: import("../../transform/types.js").JsxTransformPlugin;
+export const checks: readonly ["media_not_wix"];
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../../transform/types.js').JsxTransformPlugin<Check>} */
+export const mediaValidationPlugin: import("../../transform/types.js").JsxTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/jsxPlugins/origamiCompatibility/index.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../../transform/types.js').JsxTransformPlugin} */
-export const origamiCompatibilityPlugin: import("../../transform/types.js").JsxTransformPlugin;
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../../transform/types.js').JsxTransformPlugin<Check>} */
+export const origamiCompatibilityPlugin: import("../../transform/types.js").JsxTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/jsxPlugins/pageSlots.d.ts

@@ -1,6 +1,7 @@
-export namespace pageSlotsPlugin {
-    let name: string;
-    let order: number;
-    function appliesTo(context: any): boolean;
-    function transform(program: any): void;
-}
+/** @typedef {typeof checks[number]} Check */
+/** Transitional support for DM's literal Page children alongside authored slot props.
+ * @type {import('../transform/types.js').JsxTransformPlugin<Check>} */
+export const pageSlotsPlugin: import("../transform/types.js").JsxTransformPlugin<Check>;
+export type Check = (typeof checks)[number];
+declare const checks: readonly [];
+export {};

package/dist/jsxPlugins/validation/checks.d.ts

@@ -1,12 +1,12 @@
 export function assertKnownConstraints(rules: any): void;
 export function constrainsChildren(rule: any): boolean;
-export function checkRule(rule: any, { node, componentOf, report }: {
+export function checkRule(rule: import("./rules.js").Rule, { node, componentOf, report }: {
     node: any;
-    componentOf: any;
-    report: any;
+    componentOf: (node: any) => string | undefined;
+    report: (check: import("./index.js").Check, message: string) => void;
 }): void;
-export function checkCreateElement(rule: any, { node, component, report }: {
+export function checkCreateElement(rule: import("./rules.js").Rule, { node, component, report }: {
     node: any;
-    component: any;
-    report: any;
-}): any;
+    component: string;
+    report: (check: import("./index.js").Check, message: string) => void;
+}): void;

package/dist/jsxPlugins/validation/index.d.ts

@@ -1,2 +1,5 @@
-/** @type {import('../../transform/types.js').JsxTransformPlugin} */
-export const layoutValidationPlugin: import("../../transform/types.js").JsxTransformPlugin;
+export const checks: readonly ["section_wrong_child", "section_too_few_children", "section_too_many_children", "section_non_literal_children", "section_create_element"];
+/** @typedef {typeof checks[number]} Check */
+/** @type {import('../../transform/types.js').JsxTransformPlugin<Check>} */
+export const layoutValidationPlugin: import("../../transform/types.js").JsxTransformPlugin<Check>;
+export type Check = (typeof checks)[number];

package/dist/jsxPlugins/validation/rules.d.ts

@@ -1,7 +1,32 @@
+/**
+ * @typedef {object} Rule
+ * @property {string} id
+ * @property {string[]} components
+ * @property {string[]} allowedChildren
+ * @property {number} minChildren
+ * @property {number} maxChildren
+ * @property {Record<'allowedChildren' | 'minChildren' | 'maxChildren' | 'literal' | 'createElement', import('./index.js').Check>} checks
+ */
+/** @satisfies {Rule[]} */
 export const RULES: {
     id: string;
+    checks: {
+        allowedChildren: "section_wrong_child";
+        minChildren: "section_too_few_children";
+        maxChildren: "section_too_many_children";
+        literal: "section_non_literal_children";
+        createElement: "section_create_element";
+    };
     components: string[];
     allowedChildren: string[];
     minChildren: number;
     maxChildren: number;
 }[];
+export type Rule = {
+    id: string;
+    components: string[];
+    allowedChildren: string[];
+    minChildren: number;
+    maxChildren: number;
+    checks: Record<"allowedChildren" | "minChildren" | "maxChildren" | "literal" | "createElement", import("./index.js").Check>;
+};

package/dist/transform/bi.d.ts

@@ -2,3 +2,12 @@
 export function countPlugin(context: any, duration: any): void;
 /** @param {'malformed_custom_enum' | 'unmappable_preset' | 'svg_not_loaded' | 'media_not_wix'} key */
 export function warn(key: "malformed_custom_enum" | "unmappable_preset" | "svg_not_loaded" | "media_not_wix"): void;
+/**
+ * @template {string} Check
+ * @param {import('./types.js').TransformPluginBase<Check>} plugin
+ * @param {unknown} cause
+ * @returns {Check | undefined}
+ */
+export function declaredCheck<Check extends string>(plugin: import("./types.js").TransformPluginBase<Check>, cause: unknown): Check | undefined;
+/** Finish a plugin failure, projecting only its declared keys into check children. */
+export function recordPluginFailure(plugin: any, cause: any, pageId: any): void;

package/dist/transform/layoutError.d.ts

@@ -1,17 +1,20 @@
-export class LayoutError extends Error {
+/** @template {string} Check */
+export class LayoutError<Check extends string> extends Error {
     /**
-     * @param {readonly string[]} violations
+     * @param {Pick<import('./types.js').TransformPluginBase<Check>, 'checks'>} plugin
+     * @param {readonly import('./types.js').Violation<NoInfer<Check>>[]} violations
      * @param {{ file?: string, line?: number, column?: number }} [location] The first violation's, which the
      *     bundler prints as the error's position (Vite's CSS stage reads `file`, `line` and `column`).
      */
-    constructor(violations: readonly string[], location?: {
+    constructor(plugin: Pick<import("./types.js").TransformPluginBase<Check>, "checks">, violations: readonly import("./types.js").Violation<NoInfer<Check>>[], location?: {
         file?: string;
         line?: number;
         column?: number;
     });
     error_name: string;
     stack: string;
-    violations: readonly string[];
+    plugin: Pick<import("./types.js").TransformPluginBase<Check>, "checks">;
+    violations: readonly import("./types.js").Violation<NoInfer<Check>>[];
     location: {
         file?: string;
         line?: number;

package/dist/transform/pipeline.d.ts

@@ -1,7 +1,7 @@
 export function createTransformPipeline({ layout, jsxPlugins, cssPlugins }: {
     layout: import("./types.js").SiteLayout;
-    jsxPlugins?: readonly import("./types.js").JsxTransformPlugin[];
-    cssPlugins?: readonly import("./types.js").CssTransformPlugin[];
+    jsxPlugins?: readonly import("./types.js").JsxTransformPlugin<string>[];
+    cssPlugins?: readonly import("./types.js").CssTransformPlugin<string>[];
 }): {
     /** Whether any JSX transform selects this module (structure.jsx/.tsx by default).
      * @param {string} id

package/dist/transform/types.d.ts

@@ -32,15 +32,15 @@ export type TransformContext = {
      */
     ssr: boolean;
 };
-/**
- * The transform-plugin contract.
- *
- * Both stages have the same shape: an engine parses the file once, and each plugin is handed that
- * AST plus the file's context and does what it likes with it. Babel and PostCSS are engines here,
- * not plugin hosts — a plugin never has to know either one's own plugin protocol. Which stage a
- * plugin belongs to is decided by the list it is registered in, so no descriptor restates it.
- */
-export type TransformPluginBase = {
+export type Violation<Check extends string> = {
+    check: Check;
+    message: string;
+};
+export type CheckError<Check extends string> = Error & {
+    check: Check;
+};
+export type TransformPluginBase<Check extends string> = {
+    checks: readonly Check[];
     name: string;
     /**
      * Ascending. Ties break by registration order.
@@ -59,7 +59,7 @@ export type TransformPluginBase = {
  * `parserPlugins` are Babel parser plugins the file needs; they are unioned across selected plugins
  * and applied before any of them run.
  */
-export type JsxTransformPlugin = TransformPluginBase & {
+export type JsxTransformPlugin<Check extends string> = TransformPluginBase<Check> & {
     transform: (program: any, context: TransformContext) => void;
     parserPlugins?: readonly string[];
 };
@@ -68,7 +68,7 @@ export type JsxTransformPlugin = TransformPluginBase & {
  * plugin's `validate` or `transform` runs. It returns a promise only when it has something to load, so a stylesheet
  * that needs nothing loaded stays synchronous for PostCSS.
  */
-export type CssTransformPlugin = TransformPluginBase & {
+export type CssTransformPlugin<Check extends string> = TransformPluginBase<Check> & {
     prepare?: (root: import("postcss").Root, context: CssTransformContext) => Promise<void | {
         fetched: number;
         failed: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/origami-transforms",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Babel and PostCSS checks and transforms for Wix origami page files.",
   "main": "./src/index.js",
   "files": [
@@ -13,7 +13,7 @@
     "test": "node --test test/*.spec.js",
     "test:browser": "node test/spx.browser.mjs && node test/semanticContainer.browser.mjs",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.checks.json"
   },
   "dependencies": {
     "@babel/core": "^7.26.0",
@@ -71,5 +71,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "falconPackageHash": "1fbeabb662063771eaf3dbbb2b84d3ea8ba71598556ee82a91d545fa"
+  "falconPackageHash": "3dbca0d8f0a2ca89672ec04b7c608fae13a2f9a9cbdbf55285316758"
 }

package/src/cssPlugins/componentPosition.js

@@ -6,8 +6,12 @@ import { isLayoutSource } from './layout/parser.js'
 // One class or id: DM writes `.compId`, and layout.css still accepts `#compId` (see layout/parser.js).
 const SINGLE_CLASS_OR_ID = /^[.#][\w-]+$/
 
-/** @type {import('../transform/types.js').CssTransformPlugin} */
+const checks = /** @type {const} */ ([])
+/** @typedef {typeof checks[number]} Check */
+
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
 export const componentPositionPlugin = {
+    checks,
     name: 'component-position',
     order: 14,
     transform(root, context) {

package/src/cssPlugins/customEnums.js

@@ -222,8 +222,12 @@ export const removeCustomEnums = root => {
     for (const rule of emptied) if (rule?.type === 'rule' && rule.nodes.length === 0) rule.remove()
 }
 
-/** @type {import('../transform/types.js').CssTransformPlugin} */
+export const checks = /** @type {const} */ (['duplicate_enum', 'non_literal_enum_value', 'unknown_enum_value', 'enum_parent_selector_list'])
+/** @typedef {typeof checks[number]} Check */
+
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
 export const customEnumsPlugin = {
+    checks,
     name: 'custom-enums',
     // After mixins copy their bodies in, before presets and layout move declarations out of the instance's rule.
     order: 11,
@@ -311,13 +315,13 @@ export const customEnumsPlugin = {
             const matching = enums.filter(item => item.key === declaration.prop && item.inline === nearest)
             if (matching.length === 0) return null
             const key = declaration.prop.slice(2)
-            if (matching.length > 1) return `the element has custom enum ${key} more than once, so it can't say which.`
+            if (matching.length > 1) return /** @satisfies {[Check, string]} */ (['duplicate_enum', `the element has custom enum ${key} more than once, so it can't say which.`])
             const [found] = matching
             const value = declaration.value.trim()
             const allowed = Object.keys(found.options).join(', ')
-            if (/\bvar\(/.test(value)) return `a custom enum's value must be literal, one of ${allowed}.`
+            if (/\bvar\(/.test(value)) return /** @satisfies {[Check, string]} */ (['non_literal_enum_value', `a custom enum's value must be literal, one of ${allowed}.`])
             const options = found.options[value]
-            if (options === undefined) return `"${value}" is not an option of ${key}; use one of ${allowed}.`
+            if (options === undefined) return /** @satisfies {[Check, string]} */ (['unknown_enum_value', `"${value}" is not an option of ${key}; use one of ${allowed}.`])
             return options
         }
 
@@ -337,7 +341,8 @@ export const customEnumsPlugin = {
         }
 
         // Every declaration is checked before any is rewritten: a failed run leaves the stylesheet as it was.
-        const violations = new Set()
+        /** @type {Map<string, import('../transform/types.js').Violation<Check>>} */
+        const violations = new Map()
         /** @type {any} The first violation's source, whose position the bundler prints. */
         let first
         // The rules with an enum that resolves, the only ones a selector list is split in.
@@ -348,17 +353,18 @@ export const customEnumsPlugin = {
                 const results = resolve(rule, own).map(selector => lookup(declaration, selector))
                 if (results.some(result => result !== null)) resolving.add(rule)
                 if (results.length > 1 && results.some(result => result !== null)) {
-                    return ['set a custom enum on one instance rule, not under a parent selector list.']
+                    return [/** @satisfies {[Check, string]} */ (['enum_parent_selector_list', 'set a custom enum on one instance rule, not under a parent selector list.'])]
                 }
-                return results.filter(result => typeof result === 'string')
+                return results.filter(result => Array.isArray(result))
             })
-            for (const problem of problems) {
+            for (const [check, problem] of problems) {
                 first ??= declaration.source
-                violations.add(`custom-enums: ${declaration.prop}: ${declaration.value}${where(declaration)}: ${problem}`)
+                const message = `custom-enums: ${declaration.prop}: ${declaration.value}${where(declaration)}: ${problem}`
+                violations.set(message, { check, message })
             }
         }
         if (violations.size) {
-            throw new LayoutError([...violations], {
+            throw new LayoutError(customEnumsPlugin, [...violations.values()], {
                 file: first?.input.file,
                 line: first?.start?.line,
                 column: first?.start?.column,
@@ -380,7 +386,7 @@ export const customEnumsPlugin = {
             const rule = ruleOf(declaration)
             if (rule === undefined) continue
             const [selector] = resolve(rule, rule.selector)
-            const options = /** @type {Exclude<ReturnType<typeof lookup>, string>} */ (lookup(declaration, selector))
+            const options = /** @type {Exclude<ReturnType<typeof lookup>, string[]>} */ (lookup(declaration, selector))
             if (options !== null) declaration.replaceWith(expansion(declaration, options))
         }
     },

package/src/cssPlugins/customMedia.js

@@ -27,8 +27,15 @@ const usesCustomMedia = root => {
     return used
 }
 
-/** @type {import('../transform/types.js').CssTransformPlugin} */
+export const checks = /** @type {const} */ (['unresolved_custom_media'])
+/** @typedef {typeof checks[number]} Check */
+
+/** @template {Error} E @param {Check} check @param {E} error */
+export const fail = (check, error) => Object.assign(error, { check })
+
+/** @type {import('../transform/types.js').CssTransformPlugin<Check>} */
 export const customMediaPlugin = {
+    checks,
     name: 'custom-media',
     order: 0,
     transform(root, context) {
@@ -43,9 +50,9 @@ export const customMediaPlugin = {
         // disables the whole block.
         root.walkAtRules('media', atRule => {
             if (CUSTOM_MEDIA_QUERY.test(atRule.params)) {
-                throw new Error(
+                throw fail('unresolved_custom_media', new Error(
                     `@media ${atRule.params} has no usable @custom-media definition: it is missing or cyclic`
-                )
+                ))
             }
         })
     },