nudge-ui 0.2.0

package/dist/inspector/tokens/resolution.d.ts

@@ -0,0 +1,56 @@
+import type { TokenDefinition, TokenEntry } from "../../css/model/index.js";
+import type { InteractionState } from "../shell/styleState.js";
+export { invalidateStyleResolutionCache } from "./resolution/cssomCollector.js";
+import type { MatchedRule, ResolvedProperty, TokenTable } from "../../css/model/index.js";
+/**
+ * Builds (or reuses) the document's CSSOM rule snapshot ahead of a resolution
+ * sweep. Idempotent: the walk runs once per stylesheet revision and is a cache
+ * hit afterwards, so a scheduler can warm it in its own frame to keep the
+ * subsequent resolution sweep's blocking time small.
+ */
+export declare function prewarmCssomRuleSnapshot(doc: Document): void;
+export declare function buildTokenTable(entries: readonly TokenEntry[]): TokenTable;
+export declare function getTokenTable(): TokenTable;
+/**
+ * The build-time catalog is intentionally an inventory of every project token.
+ * Element edits must instead use only custom properties resolved in that
+ * element's cascade; a token defined by a lazy stylesheet is not usable until
+ * that stylesheet is attached to the document. Entries are cached per element
+ * until the element or stylesheet revision changes; the derived table reuses
+ * `buildTokenTable`'s input-identity memo.
+ */
+export declare function getAvailableTokenEntriesForElement(el: HTMLElement, definitions?: readonly TokenDefinition[]): TokenEntry[];
+/**
+ * Produces the page catalog used by the global Tokens settings section. It retains the
+ * build-time inventory separately, while removing declarations from CSS files
+ * that have not loaded when the document exposes mappable source identities
+ * (such as Vite's lazy route stylesheets). Opaque compiled URLs do not narrow
+ * the adapter-supplied catalog.
+ */
+export declare function getAvailableTokenCatalog(root?: HTMLElement, definitions?: readonly TokenDefinition[]): TokenDefinition[];
+/** Test hook: clears the per-source-site matched-rule cache. */
+export declare function resetSourceSiteMatchCache(): void;
+/** Test hook: number of distinct cached source-site match sets. */
+export declare function sourceSiteMatchCacheSize(): number;
+/**
+ * Package-private cascade fixture seam. This exercises selector, layer,
+ * importance, and interaction-state coordination while still crossing the
+ * public value-semantics Interface through `resolveDeclaration`.
+ * It is intentionally absent from the package exports.
+ */
+export declare function resolveRuleFixture(el: HTMLElement, rules: MatchedRule[], tokenTable: TokenTable): ResolvedProperty[];
+export declare function getResolvedProperties(el: HTMLElement, tokenTable: TokenTable): ResolvedProperty[];
+/**
+ * Resolve the authored cascade for a chosen interaction state without relying
+ * on the pointer's current location. This is intentionally attribution-first:
+ * values with no authored declaration still fall back to the browser's live
+ * computed value in the field layer.
+ */
+export declare function getResolvedPropertiesForState(el: HTMLElement, tokenTable: TokenTable, state: InteractionState): ResolvedProperty[];
+export declare function getAvailableInteractionStates(el: HTMLElement): InteractionState[];
+/**
+ * Resolves the cascade with transient interaction selectors removed. Used when
+ * an editor must stay linked to the stable token beneath a live :hover/:focus
+ * paint. Memoized per (element, revisions, tokenTable).
+ */
+export declare function getResolvedPropertiesStable(el: HTMLElement, tokenTable: TokenTable): ResolvedProperty[];