bestax-migrate 2.3.9 → 2.5.0

package/dist/sources/bulma-classes/class-map.d.ts

@@ -0,0 +1,182 @@
+/**
+ * The bulma-classes table: for a Bulma class on a plain JSX element, which
+ * bestax component renders that element, and which prop renders each of its
+ * other classes.
+ *
+ * Every conversion this table allows must render exactly the HTML the raw
+ * element rendered. That is a claim about bestax, and the render tests hold
+ * it: each root, modifier and helper here is rendered through the built
+ * library and compared with the raw markup it replaces.
+ *
+ * Data only: `scripts/gen-mcp-index.mjs` imports it directly for the MCP
+ * server's `lookup_bulma_classes`, so nothing Node cannot strip (no enums, no
+ * namespaces, type imports only), and a change to it wants `pnpm gen:mcp`.
+ */
+export interface PropWrite {
+    readonly prop: string;
+    /** Omitted for a bare boolean prop. */
+    readonly value?: string;
+}
+export type TagSet = {
+    readonly on: readonly string[];
+} | {
+    readonly except: readonly string[];
+};
+export declare function inTagSet(set: TagSet, tag: string): boolean;
+export interface Modifier {
+    readonly writes: readonly PropWrite[];
+    /** The raw tags the writes are exact on (Title's size picks its heading). */
+    readonly tagIn?: readonly string[];
+}
+/**
+ * - `mapped`: converts to `target`.
+ * - `todo`: bestax has a component, but the markup does not map element by
+ *   element yet; the family's outermost class gets a TODO.
+ * - `plain`: valid Bulma with nothing to convert to; left alone, no TODO.
+ */
+export type RootStatus = 'mapped' | 'todo' | 'plain';
+export interface RootEntry {
+    readonly status: RootStatus;
+    /**
+     * bestax JSX name, dotted for a part (`Hero.Body`). On a `todo` family, the
+     * component a person converts the family to by hand.
+     */
+    readonly target?: string;
+    /** The tag the target renders with no `as`. */
+    readonly tag?: string;
+    /** Tags `as` can reach: a list, any tag, or none (fixed). */
+    readonly as?: readonly string[] | 'any';
+    /** Title and SubTitle render `h{size}` whatever `as` says, unless `as="p"`. */
+    readonly sizeDrivesTag?: boolean;
+    readonly modifiers?: Readonly<Record<string, Modifier>>;
+    /** The prop that renders `has-text-{color}` here, or null when none does. */
+    readonly textColor?: 'textColor' | 'color' | null;
+    /** The prop that renders `has-background-{color}` here, or null when none does. */
+    readonly bgColor?: 'bgColor' | 'backgroundColor' | null;
+    /** Attributes the target renders when the element does not set them. */
+    readonly defaults?: Readonly<Record<string, string>>;
+    /**
+     * Attributes the element may carry that the target's props type rejects.
+     * One that is also a default converts at exactly its default value (the
+     * target renders it anyway, so it is dropped); otherwise it refuses.
+     */
+    readonly untypedAttrs?: readonly string[];
+    /** The target's props type requires children. */
+    readonly requiresChildren?: boolean;
+    /**
+     * The target renders its children inside an element of its own (`Card`
+     * inside `.card-content`) unless one of them is one of these parts, so the
+     * element converts only beside a direct child that converts to one.
+     * `whenEmpty`: it renders that element with no children too.
+     */
+    readonly wrapsChildren?: {
+        readonly in: string;
+        readonly unless: readonly string[];
+        readonly whenEmpty?: boolean;
+    };
+    /**
+     * Attributes the target types as numbers. A numeric string (`value="40"`)
+     * becomes a number, which renders the same; any other string refuses.
+     */
+    readonly numberAttrs?: readonly string[];
+    /** Attributes the target drops: on these tags, or on all tags except these. */
+    readonly dropsAttr?: Readonly<Record<string, TagSet>>;
+    /**
+     * The target's props a raw attribute of the same name would be read as,
+     * and the ones that reach the DOM unchanged. Together they are every prop
+     * the target declares; a test holds that.
+     */
+    readonly ownProps?: readonly string[];
+    readonly passThrough?: readonly string[];
+    /** For `todo` roots: a part, whose family root carries the TODO. */
+    readonly part?: boolean;
+    /** Why a `todo` or `plain` root is what it is; `todo` messages quote it. */
+    readonly why?: string;
+    /**
+     * Modifiers left out of `modifiers` on purpose, because the prop that
+     * renders the class renders more than the class. They stay in `className`;
+     * the reason is for the MCP lookup, which would otherwise say bestax has
+     * no prop for them.
+     */
+    readonly omits?: Readonly<Record<string, string>>;
+}
+export declare const COLORS: readonly ["primary", "link", "info", "success", "warning", "danger", "black", "black-bis", "black-ter", "grey-darker", "grey-dark", "grey", "grey-light", "grey-lighter", "white", "white-bis", "white-ter", "light", "dark"];
+export declare const SIZES: readonly ["0", "1", "2", "3", "4", "5", "6", "auto"];
+export declare const TEXT_SIZES: readonly ["1", "2", "3", "4", "5", "6", "7"];
+export declare const ALIGNMENTS: readonly ["centered", "justified", "left", "right"];
+export declare const TEXT_TRANSFORMS: readonly ["capitalized", "lowercase", "uppercase", "italic"];
+export declare const TEXT_WEIGHTS: readonly ["light", "normal", "medium", "semibold", "bold"];
+export declare const FONT_FAMILIES: readonly ["sans-serif", "monospace", "primary", "secondary", "code"];
+export declare const DISPLAYS: readonly ["block", "flex", "inline", "inline-block", "inline-flex", "grid"];
+export declare const FLEX_DIRECTIONS: readonly ["row", "row-reverse", "column", "column-reverse"];
+export declare const FLEX_WRAPS: readonly ["nowrap", "wrap", "wrap-reverse"];
+export declare const JUSTIFY_CONTENTS: readonly ["flex-start", "flex-end", "center", "space-between", "space-around", "space-evenly", "start", "end", "left", "right"];
+export declare const ALIGN_CONTENTS: readonly ["flex-start", "flex-end", "center", "space-between", "space-around", "space-evenly", "stretch"];
+export declare const ALIGN_ITEMS: readonly ["stretch", "flex-start", "flex-end", "center", "baseline", "start", "end"];
+export declare const ALIGN_SELFS: readonly ["auto", "flex-start", "flex-end", "center", "baseline", "stretch"];
+export declare const FLEX_GROW_SHRINK: readonly ["0", "1", "2", "3", "4", "5"];
+export declare const VIEWPORTS: readonly ["mobile", "tablet", "tablet-only", "touch", "desktop", "desktop-only", "widescreen", "widescreen-only", "fullhd"];
+/** `tablet-only` → `TabletOnly`: the suffix bestax puts on per-viewport props. */
+export declare function viewportSuffix(viewport: string): string;
+export declare const ROOTS: Readonly<Record<string, RootEntry>>;
+/**
+ * Which root wins when an element carries two (`column box`): layout before
+ * surface, so the element keeps the role that decides where it sits. The
+ * other root stays in `className`, which renders the same either way.
+ */
+export declare const PRECEDENCE: readonly string[];
+/** Refs reach the element only through these targets. */
+export declare const FORWARDS_REF: readonly string[];
+/**
+ * Plain tags bestax wraps, for an element with helper classes and no root
+ * (`<p className="has-text-centered">` → `<Paragraph textAlign="centered">`).
+ */
+export declare const WRAPPERS: Readonly<Record<string, string>>;
+/** The wrappers' own props, as `ROOTS` lists them for the components. */
+export declare const WRAPPER_OWN_PROPS: Readonly<Record<string, readonly string[]>>;
+/** Bulma 0.9 classes v1 dropped, with what replaced them. */
+export declare const LEGACY_09: Readonly<Record<string, string>>;
+/**
+ * `text-color` and `background` resolve to a per-target prop (`RootEntry`'s
+ * `textColor`/`bgColor`); `flex-container` only renders beside a flex
+ * `display`; `display` cannot mix a base value with per-viewport ones.
+ */
+export type HelperGroup = 'text-color' | 'background' | 'spacing' | 'typography' | 'display' | 'visibility' | 'flex-container' | 'flex-item' | 'other';
+export interface HelperToken {
+    readonly group: HelperGroup;
+    readonly write: PropWrite;
+}
+export declare const HELPER_TOKENS: ReadonlyMap<string, HelperToken>;
+/** Every helper prop name, for the attribute-collision check. */
+export declare const HELPER_PROPS: ReadonlySet<string>;
+/**
+ * Bulma classes this source never turns into a prop, grouped by why. Any
+ * class not named above stays in `className` anyway; this list exists so
+ * every class in Bulma's stylesheet is accounted for, and a Bulma release
+ * that adds one fails a test until someone decides what it is.
+ */
+export declare const PASSTHROUGH: ReadonlyArray<{
+    readonly why: string;
+    readonly match: RegExp;
+}>;
+/**
+ * Why a class stays a class. Consult it only for a class nothing above
+ * converts: a modifier converts on its own root and nowhere else, so the same
+ * class can be both (`is-narrow-touch` is a Column prop, and a breakpoint
+ * bestax has no prop for on anything else).
+ */
+export declare function passthroughReason(token: string): string | undefined;
+/** The table's entry for a class. */
+export declare function rootFor(token: string): RootEntry | undefined;
+/**
+ * A class that decides what its element is, for a TODO: a root the table
+ * converts or a family's outermost class. Parts and `plain` roots are not.
+ */
+export declare function flaggableRoot(token: string): RootEntry | undefined;
+/** A root's modifier for a class. */
+export declare function modifierFor(entry: RootEntry, token: string): Modifier | undefined;
+/** What replaced a Bulma 0.9 class v1 removed. */
+export declare function legacyHint(token: string): string | undefined;
+/** The bestax wrapper for a plain tag. */
+export declare function wrapperFor(tag: string): string | undefined;
+//# sourceMappingURL=class-map.d.ts.map

package/dist/sources/bulma-classes/class-map.d.ts.map

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