@typecad/ui 0.1.0-alpha.1

package/dist/ui-engine/css-parser.d.ts

@@ -0,0 +1,155 @@
+import type { Diagnostic } from "@typecad/cuttlefish/api/shared";
+export type CSSSelectorKind = "element" | "id" | "class" | "attribute";
+/** A single simple selector: tag name, #id, or .class. */
+export interface SimpleSelector {
+    kind: CSSSelectorKind;
+    name: string;
+    value?: string;
+}
+/** A full CSS selector, supporting compound (`.foo.bar`, `tag.class`) and
+ *  descendant (`parent child`) combinators.
+ *  - `compounds[last]` is the target compound (the element the rule applies to).
+ *  - Each compound is an array of simples that must ALL match (AND).
+ *  - Preceding compounds are ancestor constraints (descendant combinator). */
+export interface CSSSelector {
+    compounds: SimpleSelector[][];
+    combinators?: (">" | " " | "+" | "~")[];
+    pseudo?: "pressed" | "disabled" | "checked" | "focus";
+    /** :not(...) negation compounds. Each is a compound that must NOT match. */
+    not?: SimpleSelector[][];
+}
+export interface TransitionDecl {
+    property: "background" | "color";
+    durationMs: number;
+}
+export interface KeyframeStop {
+    percent: number;
+    background?: string;
+    color?: string;
+    opacity?: string;
+    transform?: string;
+    transformOrigin?: string;
+    left?: string;
+    top?: string;
+    width?: string;
+    height?: string;
+}
+export interface KeyframeSet {
+    name: string;
+    stops: KeyframeStop[];
+}
+export interface AnimationDecl {
+    name: string;
+    durationMs: number;
+    iterations: number;
+    delayMs: number;
+    timingFunction: string;
+}
+export interface CSSProperty {
+    padding?: string;
+    margin?: string;
+    /** Per-side margin overrides (win over the `margin` shorthand when set). */
+    marginTop?: string;
+    marginRight?: string;
+    marginBottom?: string;
+    marginLeft?: string;
+    width?: string;
+    height?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    minHeight?: string;
+    maxHeight?: string;
+    aspectRatio?: string;
+    boxSizing?: string;
+    overflow?: string;
+    color?: string;
+    background?: string;
+    font?: string;
+    fontFamily?: string;
+    fontSize?: string;
+    textAlign?: string;
+    textDecoration?: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    fontSmoothing?: string;
+    fontSubset?: string;
+    lineHeight?: string;
+    letterSpacing?: string;
+    whiteSpace?: string;
+    textTransform?: string;
+    textOverflow?: string;
+    transition?: TransitionDecl;
+    animation?: string;
+    animationName?: string;
+    animationDuration?: string;
+    animationIterationCount?: string;
+    animationDelay?: string;
+    animationTimingFunction?: string;
+    display?: string;
+    flexDirection?: string;
+    gap?: string;
+    rowGap?: string;
+    columnGap?: string;
+    flexGrow?: string;
+    flexShrink?: string;
+    flexBasis?: string;
+    alignSelf?: string;
+    alignItems?: string;
+    alignContent?: string;
+    justifyContent?: string;
+    flexWrap?: string;
+    order?: string;
+    position?: string;
+    zIndex?: string;
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+    border?: string;
+    borderRadius?: string;
+    borderWidth?: string;
+    borderColor?: string;
+    borderStyle?: string;
+    /** Per-side border overrides (win over the shorthand when set). */
+    borderTopWidth?: string;
+    borderTopStyle?: string;
+    borderTopColor?: string;
+    borderRightWidth?: string;
+    borderRightStyle?: string;
+    borderRightColor?: string;
+    borderBottomWidth?: string;
+    borderBottomStyle?: string;
+    borderBottomColor?: string;
+    borderLeftWidth?: string;
+    borderLeftStyle?: string;
+    borderLeftColor?: string;
+    opacity?: string;
+    visibility?: string;
+    outline?: string;
+    boxShadow?: string;
+    textShadow?: string;
+    transform?: string;
+    transformOrigin?: string;
+    objectFit?: string;
+}
+export interface CSSRule {
+    selector: CSSSelector;
+    properties: CSSProperty;
+}
+export interface CSSFontFace {
+    fontFamily: string;
+    src: string;
+    fontWeight?: string;
+    fontStyle?: string;
+}
+export declare function parseCss(src: string, diagnostics?: Diagnostic[]): CSSRule[];
+export declare function parseFontFaces(src: string): CSSFontFace[];
+/** Parse an inline style string ("color: red; font-size: 16px") into CSSProperty.
+ *  Uses the same assignProp pipeline as rule parsing. */
+export declare function parseInlineStyle(src: string, diagnostics?: Diagnostic[]): CSSProperty;
+/** Parse the animation shorthand: "pulse 2s infinite 500ms".
+ *  Fields: name (identifier), duration (Nms/Ns), iterations (number|infinite), delay (Nms/Ns). */
+export declare function parseAnimation(val: string): AnimationDecl | null;
+/** Parse @keyframes blocks from CSS source.
+ *  Returns KeyframeSet[] — one per @keyframes name. */
+export declare function parseKeyframes(src: string): KeyframeSet[];