@c4a/extract-style 0.7.10-alpha.1 → 0.7.10

package/index.d.ts

@@ -0,0 +1,584 @@
+import { z } from 'zod';
+
+export interface StyleLocator {
+	path: string;
+	line: number;
+	end_line?: number;
+	column: number;
+	qualified_item_path: string;
+}
+export interface StyleImport {
+	import_ref: string;
+	kind: "import" | "use" | "forward";
+	specifier: string | null;
+	specifier_digest: string;
+	resolution: "registered" | "external" | "builtin" | "package-or-load-path" | "unresolved";
+	resolved_path: string | null;
+	locator: StyleLocator;
+}
+export interface StyleToken {
+	token_ref: string;
+	name: string;
+	syntax: "custom-property" | "scss-variable" | "property-rule";
+	configurable: boolean;
+	value_digest: string | null;
+	locator: StyleLocator;
+}
+export interface StyleTokenReference {
+	reference_ref: string;
+	name: string;
+	owner_qualified_item_path: string;
+	locator: StyleLocator;
+}
+export interface StyleSelector {
+	selector_ref: string;
+	selector_digest: string;
+	class_names: string[];
+	id_names: string[];
+	type_names: string[];
+	pseudo_classes: string[];
+	attribute_names: string[];
+	locator: StyleLocator;
+}
+export interface StyleVariantState {
+	evidence_ref: string;
+	selector_ref: string;
+	evidence_kind: "pseudo-class" | "state-attribute" | "class-modifier";
+	name: string;
+	locator: StyleLocator;
+}
+export interface StyleComponentCandidate {
+	candidate_ref: string;
+	name: string;
+	basis: "module-file" | "class-root";
+	selector_ref: string | null;
+	locator: StyleLocator;
+}
+export interface StyleDiagnostic {
+	code: "style-import-dynamic-unsupported" | "style-import-unresolved" | "style-selector-dynamic-identity-omitted" | "style-selector-unsupported" | "style-source-unsupported";
+	severity: "warning" | "error";
+	locator: StyleLocator;
+	detail: string;
+}
+export interface StyleDocumentCatalog {
+	path: string;
+	lines?: number;
+	syntax: "css" | "scss" | "excluded";
+	disposition: "analyzed" | "unsupported" | "excluded";
+	imports: StyleImport[];
+	tokens: StyleToken[];
+	token_references: StyleTokenReference[];
+	selectors: StyleSelector[];
+	variants_and_states: StyleVariantState[];
+	component_candidates: StyleComponentCandidate[];
+	diagnostics: StyleDiagnostic[];
+}
+/** Parses only caller-registered CSS/SCSS sources without compiling them. */
+export declare function parseStyleSources(files: Readonly<Record<string, string>>): StyleDocumentCatalog[];
+declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObject<{
+	protocol: z.ZodLiteral<"context.indexer.evidence-adapter-result/v1">;
+	adapter: z.ZodObject<{
+		id: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}>;
+	authorized_scope: z.ZodObject<{
+		source_ref: z.ZodString;
+		module_refs: z.ZodArray<z.ZodString, "many">;
+		scope_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}>;
+	input_digest: z.ZodString;
+	precedence: z.ZodNumber;
+	files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		file_ref: z.ZodString;
+		source_ref: z.ZodString;
+		module_ref: z.ZodNullable<z.ZodString>;
+		normalized_path: z.ZodEffects<z.ZodString, string, string>;
+		role: z.ZodEnum<[
+			"primary-owner",
+			"enricher"
+		]>;
+		coverage_tier: z.ZodEnum<[
+			"ast-catalog",
+			"lightweight-evidence"
+		]>;
+		disposition: z.ZodEnum<[
+			"analyzed",
+			"unsupported",
+			"excluded"
+		]>;
+		facts: z.ZodArray<z.ZodObject<{
+			fact_ref: z.ZodString;
+			kind: z.ZodEffects<z.ZodString, string, string>;
+			locator: z.ZodObject<{
+				source_ref: z.ZodString;
+				module_ref: z.ZodNullable<z.ZodString>;
+				normalized_path: z.ZodEffects<z.ZodString, string, string>;
+				qualified_item_path: z.ZodString;
+				signature_digest: z.ZodString;
+			}, "strict", z.ZodTypeAny, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}>;
+			payload_digest: z.ZodString;
+			denominator: z.ZodEnum<[
+				"none",
+				"eligible-file",
+				"loc",
+				"symbol",
+				"protocol-item"
+			]>;
+		}, "strict", z.ZodTypeAny, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}>, "many">;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, "many">;
+	diagnostics: z.ZodArray<z.ZodObject<{
+		code: z.ZodEffects<z.ZodString, string, string>;
+		fact_ref: z.ZodOptional<z.ZodString>;
+		severity: z.ZodEnum<[
+			"info",
+			"warning",
+			"error"
+		]>;
+		detail_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}>, "many">;
+	toolchain: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		step: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+		capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+		input_digest: z.ZodString;
+		output_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, "many">;
+	output_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>;
+type IndexerEvidenceAdapterResult = z.infer<typeof indexerEvidenceAdapterResultSchema>;
+type IndexerEvidenceAdapterFactPayloadValue = null | boolean | number | string | IndexerEvidenceAdapterFactPayloadValue[] | {
+	[key: string]: IndexerEvidenceAdapterFactPayloadValue;
+};
+interface IndexerEvidenceAdapterFactPayload {
+	fact_ref: string;
+	payload: IndexerEvidenceAdapterFactPayloadValue;
+}
+interface IndexerEvidenceAdapterMaterialization {
+	result: IndexerEvidenceAdapterResult;
+	fact_payloads: IndexerEvidenceAdapterFactPayload[];
+}
+export interface StyleEvidenceAdapterInvocation {
+	adapter: IndexerEvidenceAdapterResult["adapter"];
+	authorized_scope: IndexerEvidenceAdapterResult["authorized_scope"];
+	input_digest: string;
+	precedence: number;
+	module_refs?: Readonly<Record<string, string | null>>;
+	role?: "primary-owner" | "enricher";
+}
+export declare function styleSourcesToEvidenceAdapterResult(files: Readonly<Record<string, string>>, invocation: StyleEvidenceAdapterInvocation): IndexerEvidenceAdapterResult;
+export declare function styleSourcesToEvidenceAdapterMaterialization(files: Readonly<Record<string, string>>, invocation: StyleEvidenceAdapterInvocation): IndexerEvidenceAdapterMaterialization;
+export declare const STYLE_EVIDENCE_ADAPTER_EXPORT = "styleSourcesToEvidenceAdapterMaterialization";
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract-style",
-  "version": "0.7.10-alpha.1",
+  "version": "0.7.10",
   "type": "module",
   "description": "Lightweight CSS and SCSS evidence adapter for Context",
   "license": "MIT",
@@ -22,7 +22,9 @@
     "postcss": "^8.5.26",
     "postcss-scss": "^4.0.9",
     "postcss-selector-parser": "^7.1.5",
-    "postcss-value-parser": "^4.2.0"
+    "postcss-value-parser": "^4.2.0",
+    "zod": "^3.23.8"
   },
-  "main": "./index.js"
+  "main": "./index.js",
+  "types": "./index.d.ts"
 }