@ismail-elkorchi/css-parser 0.1.0

package/dist/public/types.d.ts

@@ -0,0 +1,279 @@
+export type NodeId = number;
+export type ParseContext = "stylesheet" | "atrule" | "atrulePrelude" | "mediaQueryList" | "mediaQuery" | "condition" | "rule" | "selectorList" | "selector" | "block" | "declarationList" | "declaration" | "value";
+export interface Span {
+    readonly start: number;
+    readonly end: number;
+}
+export type SpanProvenance = "input" | "none";
+export interface ParseError {
+    readonly code: "BUDGET_EXCEEDED" | "STREAM_READ_FAILED" | "UNSUPPORTED_ENCODING" | "INVALID_PARSE_CONTEXT" | "PARSER_ERROR";
+    readonly parseErrorId: string;
+    readonly message: string;
+    readonly span?: Span;
+    readonly line?: number;
+    readonly column?: number;
+}
+export interface BudgetOptions {
+    readonly maxInputBytes?: number;
+    readonly maxBufferedBytes?: number;
+    readonly maxTokens?: number;
+    readonly maxNodes?: number;
+    readonly maxDepth?: number;
+    readonly maxTraceEvents?: number;
+    readonly maxTraceBytes?: number;
+    readonly maxTimeMs?: number;
+}
+export interface ParseOptions {
+    readonly captureSpans?: boolean;
+    readonly includeSpans?: boolean;
+    readonly trace?: boolean;
+    readonly transportEncodingLabel?: string;
+    readonly context?: ParseContext;
+    readonly budgets?: BudgetOptions;
+}
+export interface TokenizeOptions {
+    readonly transportEncodingLabel?: string;
+    readonly budgets?: BudgetOptions;
+}
+export interface StartEndToken {
+    readonly kind: string;
+    readonly rawKind: string;
+    readonly value: string;
+    readonly start: number;
+    readonly end: number;
+}
+export type Token = StartEndToken;
+export interface TraceDecodeEvent {
+    readonly seq: number;
+    readonly kind: "decode";
+    readonly source: "input" | "sniff";
+    readonly encoding: string;
+    readonly sniffSource: "input" | "bom" | "transport" | "charset" | "default";
+}
+export interface TraceTokenEvent {
+    readonly seq: number;
+    readonly kind: "token";
+    readonly count: number;
+}
+export interface TraceParseEvent {
+    readonly seq: number;
+    readonly kind: "parse";
+    readonly context: ParseContext;
+    readonly nodeCount: number;
+    readonly errorCount: number;
+}
+export interface TraceParseErrorEvent {
+    readonly seq: number;
+    readonly kind: "parseError";
+    readonly parseErrorId: string;
+    readonly startOffset: number | null;
+    readonly endOffset: number | null;
+}
+export interface TraceBudgetEvent {
+    readonly seq: number;
+    readonly kind: "budget";
+    readonly budget: BudgetExceededPayload["budget"];
+    readonly limit: number | null;
+    readonly actual: number;
+    readonly status: "ok" | "exceeded";
+}
+export interface TraceStreamEvent {
+    readonly seq: number;
+    readonly kind: "stream";
+    readonly bytesRead: number;
+}
+export type TraceEvent = TraceDecodeEvent | TraceTokenEvent | TraceParseEvent | TraceParseErrorEvent | TraceBudgetEvent | TraceStreamEvent;
+export interface CssNode {
+    readonly id: NodeId;
+    readonly type: string;
+    readonly spanProvenance?: SpanProvenance;
+    readonly span?: Span;
+    readonly [key: string]: unknown;
+}
+export type NodeVisitor = (node: CssNode, depth: number) => void;
+export interface StyleSheetTree {
+    readonly id: NodeId;
+    readonly kind: "stylesheet";
+    readonly context: "stylesheet";
+    readonly root: CssNode;
+    readonly children: readonly CssNode[];
+    readonly errors: readonly ParseError[];
+    readonly trace?: readonly TraceEvent[];
+}
+export interface FragmentTree {
+    readonly id: NodeId;
+    readonly kind: "fragment";
+    readonly context: ParseContext;
+    readonly root: CssNode;
+    readonly children: readonly CssNode[];
+    readonly errors: readonly ParseError[];
+    readonly trace?: readonly TraceEvent[];
+}
+export interface OutlineEntry {
+    readonly nodeId: NodeId;
+    readonly depth: number;
+    readonly type: string;
+    readonly text: string;
+}
+export interface Outline {
+    readonly entries: readonly OutlineEntry[];
+}
+export interface Chunk {
+    readonly index: number;
+    readonly nodeId: NodeId;
+    readonly content: string;
+    readonly nodes: number;
+}
+export interface ChunkOptions {
+    readonly maxChars?: number;
+    readonly maxNodes?: number;
+    readonly maxBytes?: number;
+}
+export interface BudgetExceededPayload {
+    readonly code: "BUDGET_EXCEEDED";
+    readonly budget: "maxInputBytes" | "maxBufferedBytes" | "maxTokens" | "maxNodes" | "maxDepth" | "maxTraceEvents" | "maxTraceBytes" | "maxTimeMs";
+    readonly limit: number;
+    readonly actual: number;
+}
+export interface RemoveNodeEdit {
+    readonly kind: "removeNode";
+    readonly target: NodeId;
+}
+export interface ReplaceNodeEdit {
+    readonly kind: "replaceNode";
+    readonly target: NodeId;
+    readonly css: string;
+}
+export interface InsertCssBeforeEdit {
+    readonly kind: "insertCssBefore";
+    readonly target: NodeId;
+    readonly css: string;
+}
+export interface InsertCssAfterEdit {
+    readonly kind: "insertCssAfter";
+    readonly target: NodeId;
+    readonly css: string;
+}
+export type Edit = RemoveNodeEdit | ReplaceNodeEdit | InsertCssBeforeEdit | InsertCssAfterEdit;
+export interface PatchSliceStep {
+    readonly kind: "slice";
+    readonly start: number;
+    readonly end: number;
+}
+export interface PatchInsertStep {
+    readonly kind: "insert";
+    readonly at: number;
+    readonly text: string;
+}
+export type PatchStep = PatchSliceStep | PatchInsertStep;
+export interface PatchPlan {
+    readonly steps: readonly PatchStep[];
+    readonly result: string;
+}
+export interface PatchPlanningErrorPayload {
+    readonly code: "NODE_NOT_FOUND" | "MISSING_NODE_SPAN" | "NON_INPUT_SPAN_PROVENANCE" | "OVERLAPPING_EDITS" | "INVALID_EDIT_TARGET";
+    readonly target?: NodeId;
+    readonly detail?: string;
+}
+export interface SelectorAttributeLike {
+    readonly name: string;
+    readonly value: string;
+}
+export interface SelectorNodeLike {
+    readonly kind?: string;
+    readonly type?: string;
+    readonly tagName?: string;
+    readonly attributes?: readonly SelectorAttributeLike[];
+    readonly children?: readonly SelectorNodeLike[];
+    readonly [key: string]: unknown;
+}
+export type SelectorCombinator = " " | ">";
+export interface SelectorSimpleType {
+    readonly kind: "type";
+    readonly name: string;
+    readonly universal: boolean;
+}
+export interface SelectorSimpleId {
+    readonly kind: "id";
+    readonly value: string;
+}
+export interface SelectorSimpleClass {
+    readonly kind: "class";
+    readonly value: string;
+}
+export interface SelectorSimpleAttribute {
+    readonly kind: "attribute";
+    readonly name: string;
+    readonly matcher: null | "=" | "~=" | "|=" | "^=" | "$=" | "*=";
+    readonly value: string | null;
+    readonly flags: string | null;
+}
+export type SelectorSimple = SelectorSimpleType | SelectorSimpleId | SelectorSimpleClass | SelectorSimpleAttribute;
+export interface CompiledSelectorCompound {
+    readonly simpleSelectors: readonly SelectorSimple[];
+}
+export interface SelectorUnsupportedPart {
+    readonly selectorIndex: number;
+    readonly partType: string;
+    readonly detail: string;
+}
+export interface CompiledSelector {
+    readonly selectorIndex: number;
+    readonly compounds: readonly CompiledSelectorCompound[];
+    readonly combinators: readonly SelectorCombinator[];
+    readonly supported: boolean;
+    readonly unsupportedParts: readonly SelectorUnsupportedPart[];
+}
+export interface CompiledSelectorList {
+    readonly source: string;
+    readonly parseErrors: readonly ParseError[];
+    readonly selectors: readonly CompiledSelector[];
+    readonly supported: boolean;
+    readonly unsupportedParts: readonly SelectorUnsupportedPart[];
+}
+export interface SelectorQueryOptions {
+    readonly strict?: boolean;
+    readonly maxVisitedNodes?: number;
+}
+export interface StyleSignalSpecificity {
+    readonly a: number;
+    readonly b: number;
+    readonly c: number;
+}
+export interface StyleDeclarationSignal {
+    readonly declarationNodeId: NodeId;
+    readonly property: string;
+    readonly value: string;
+    readonly important: boolean;
+    readonly declarationOrder: number;
+}
+export interface StyleRuleSignal {
+    readonly ruleNodeId: NodeId;
+    readonly selectorText: string;
+    readonly selector: CompiledSelectorList;
+    readonly selectorSupported: boolean;
+    readonly specificityMax: StyleSignalSpecificity;
+    readonly cascadeOrder: number;
+    readonly declarations: readonly StyleDeclarationSignal[];
+}
+export interface StyleSignalOptions {
+    readonly includeUnsupportedSelectors?: boolean;
+    readonly strictSelectors?: boolean;
+}
+export type RenderSignalClass = "visibility-hidden-subtree" | "visibility-hidden-self" | "control-affordance";
+export interface RenderSignal {
+    readonly signalClass: RenderSignalClass;
+    readonly source: "rule" | "inline";
+    readonly property: string;
+    readonly value: string;
+    readonly important: boolean;
+    readonly declarationOrder: number;
+    readonly selectorText: string | null;
+    readonly declarationNodeId: NodeId;
+    readonly ruleNodeId: NodeId | null;
+    readonly cascadeOrder: number | null;
+}
+export interface RenderSignalOptions extends StyleSignalOptions {
+    readonly includeControlAffordance?: boolean;
+    readonly includeVisibilitySignals?: boolean;
+}

package/dist/public/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@ismail-elkorchi/css-parser",
+  "version": "0.1.0",
+  "description": "Deterministic CSS parser for automation workflows across Node, Deno, Bun, and modern browsers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ismail-elkorchi/css-parser.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "packageManager": "npm@11.10.0",
+  "engines": {
+    "node": ">=24.0.0",
+    "npm": ">=11.0.0"
+  },
+  "main": "./dist/mod.js",
+  "types": "./dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "import": "./dist/mod.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "lint": "eslint . --max-warnings=0",
+    "fmt": "eslint . --fix --max-warnings=0",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/build/copy-vendor.mjs",
+    "test": "npm run test:control",
+    "test:control": "npm run build && node --test test/control/**/*.test.js tests/control/**/*.test.js && node scripts/eval/write-stub-reports.mjs",
+    "test:conformance": "node scripts/conformance/run-all.mjs",
+    "test:encoding": "npm run build && node scripts/conformance/run-encoding-fixtures.mjs",
+    "test:tokenizer": "npm run build && node scripts/conformance/run-tokenizer-fixtures.mjs",
+    "test:tree": "npm run build && node scripts/conformance/run-tree-fixtures.mjs",
+    "test:serializer": "npm run build && node scripts/conformance/run-serializer-fixtures.mjs",
+    "test:holdout": "npm run build && node scripts/conformance/run-holdout-fixtures.mjs",
+    "test:browser-diff": "npm run build && node scripts/oracles/run-browser-diff.mjs",
+    "test:fuzz": "npm run build && node scripts/fuzz/run-fuzz.mjs",
+    "test:bench": "npm run build && node --expose-gc scripts/bench/run-bench.mjs",
+    "test:bench:stability": "npm run build && node --expose-gc scripts/bench/run-bench-stability.mjs",
+    "examples:run": "npm run build && node examples/run-all.mjs",
+    "check:fast": "npm run lint && npm run typecheck && npm run test:control && npm run examples:run",
+    "docs:lint:jsr": "deno doc --lint --sloppy-imports jsr/mod.ts",
+    "docs:test:jsr": "deno test --doc --no-check --sloppy-imports jsr/mod.ts",
+    "smoke:node": "npm run build && node scripts/smoke/control.mjs --runtime=node --report=reports/smoke-node.json",
+    "smoke:deno": "npm run build && deno run --allow-read --allow-write=reports --allow-env scripts/smoke/control.mjs --runtime=deno --report=reports/smoke-deno.json",
+    "smoke:bun": "npm run build && bun run scripts/smoke/control.mjs --runtime=bun --report=reports/smoke-bun.json",
+    "smoke:browser": "npm run build && node scripts/smoke/browser-smoke.mjs --report=reports/smoke-browser.json",
+    "smoke:all": "npm run smoke:node && npm run smoke:deno && npm run smoke:bun",
+    "deps:freshness": "npm outdated || true",
+    "pack:check": "node scripts/eval/pack-check.mjs",
+    "realworld:import": "node scripts/realworld/import-css-corpus.mjs",
+    "realworld:bench": "npm run build && node scripts/bench/bench-realworld-css.mjs",
+    "realworld:signals": "npm run build && node scripts/realworld/write-render-signals-report.mjs",
+    "realworld:bench:selectors": "npm run build && node --expose-gc scripts/bench/run-selector-bench.mjs",
+    "realworld:bench:selectors:stability": "npm run build && node scripts/bench/run-selector-bench-stability.mjs",
+    "realworld:check": "node scripts/realworld/check-realworld-targets.mjs",
+    "eval:realworld": "npm run realworld:bench && npm run realworld:signals && npm run realworld:bench:selectors && npm run realworld:bench:selectors:stability && npm run realworld:check && node scripts/realworld/eval-realworld.mjs",
+    "mutation:pilot": "npm run build && node scripts/mutation/run-pilot.mjs --config=scripts/mutation/pilot-config.json --out=docs/reference/mutation-pilot-report.json",
+    "eval:ci": "node scripts/eval/run-eval.mjs --profile=ci",
+    "eval:release": "node scripts/eval/run-eval.mjs --profile=release",
+    "eval:hard-gate": "node scripts/eval/run-eval.mjs --profile=hard-gate"
+  },
+  "dependencies": {},
+  "overrides": {
+    "ajv": "6.14.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.3",
+    "eslint": "9.39.3",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-boundaries": "5.4.0",
+    "eslint-plugin-import": "2.32.0",
+    "playwright": "1.58.2",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.56.0"
+  }
+}