sheetom 0.1.1 → 0.2.1

package/dist/index.d.cts

@@ -755,7 +755,7 @@ interface SheetOMResourceBudget {
 //#region src/serialization-error.d.ts
 type SheetOMSerializationErrorCode = "UNREPRESENTABLE_PENDING_SHORTHAND";
 /** A reparsable stylesheet cannot faithfully represent the current CSSOM state. */
-declare class SheetOMSerializationError extends Error {
+export declare class SheetOMSerializationError extends Error {
   readonly code: SheetOMSerializationErrorCode;
   readonly shorthand: string;
   readonly conflictingLonghands: readonly string[];
@@ -763,8 +763,15 @@ declare class SheetOMSerializationError extends Error {
 }
 //#endregion
 //#region src/index.d.ts
+/** CSS authoring utilities, without installing or replacing the global CSS namespace. */
+export declare const CSS: {
+  /** Serialize a DOMString as a CSS identifier, including lone UTF-16 surrogates. */
+  escape(value: string): string;
+  /** Test a declaration or supports condition against the pinned authoring capabilities. */
+  supports(propertyOrCondition: string, value?: string): boolean;
+};
 /** One ordered declaration mutation executed by SheetOM's engine extension. */
-type CSSDeclarationMutation = {
+export type CSSDeclarationMutation = {
   kind: "set";
   property: string;
   value: string | null;
@@ -774,7 +781,7 @@ type CSSDeclarationMutation = {
   property: string;
 };
 /** The result at the matching index of an ordered declaration mutation batch. */
-type CSSDeclarationMutationResult = {
+export type CSSDeclarationMutationResult = {
   kind: "set";
   accepted: boolean;
   diagnostic: SheetOMDiagnostic | null;
@@ -783,7 +790,7 @@ type CSSDeclarationMutationResult = {
   value: string;
 };
 /** Options for a constructed SheetOM stylesheet. */
-interface CSSStyleSheetOptions {
+export interface CSSStyleSheetOptions {
   baseURL?: string;
   media?: string;
   disabled?: boolean;
@@ -791,17 +798,17 @@ interface CSSStyleSheetOptions {
   resourceBudget?: SheetOMResourceBudget | null;
 }
 /** Options for forgiving parsing of an existing regular stylesheet. */
-interface ParseStyleSheetOptions extends CSSStyleSheetOptions {
+export interface ParseStyleSheetOptions extends CSSStyleSheetOptions {
   href?: string;
 }
 /** One parsed parameter exposed by `CSSFunctionRule.getParameters()`. */
-interface FunctionParameter {
+export interface FunctionParameter {
   name: string;
   type: string;
   defaultValue?: string;
 }
 /** Base class for live stylesheet rules. */
-declare class CSSRule {
+export declare class CSSRule {
   #private;
   static readonly STYLE_RULE = 1;
   static readonly CHARSET_RULE = 2;
@@ -837,7 +844,7 @@ declare class CSSRule {
   set cssText(_value: string);
 }
 /** A stable, live, indexed collection of rules. */
-declare class CSSRuleList {
+export declare class CSSRuleList {
   #private;
   readonly [index: number]: CSSRule | undefined;
   private constructor();
@@ -845,7 +852,7 @@ declare class CSSRuleList {
   item(index: number): CSSRule | null;
 }
 /** A live serialized list of media queries. */
-declare class MediaList {
+export declare class MediaList {
   #private;
   readonly [index: number]: string | undefined;
   private constructor();
@@ -857,7 +864,7 @@ declare class MediaList {
   deleteMedium(medium: string): void;
 }
 /** A rule containing a live nested rule list. */
-declare class CSSGroupingRule extends CSSRule {
+export declare class CSSGroupingRule extends CSSRule {
   readonly cssRules: CSSRuleList;
   protected constructor(type: number);
   insertRule(ruleText: string, index?: number): number;
@@ -865,13 +872,13 @@ declare class CSSGroupingRule extends CSSRule {
   protected serializeGroup(header: string): string;
 }
 /** A grouping rule controlled by a serialized condition. */
-declare class CSSConditionRule extends CSSGroupingRule {
+export declare class CSSConditionRule extends CSSGroupingRule {
   #private;
   protected constructor(type: number, conditionText: string);
   get conditionText(): string;
 }
 /** A live custom `@function` rule. */
-declare class CSSFunctionRule extends CSSGroupingRule {
+export declare class CSSFunctionRule extends CSSGroupingRule {
   #private;
   readonly name: string;
   readonly returnType: string;
@@ -880,8 +887,48 @@ declare class CSSFunctionRule extends CSSGroupingRule {
   get cssText(): string;
   set cssText(_value: string);
 }
+/** Experimental revision-pinned native CSS mixin definition. */
+export declare class CSSMixinRule extends CSSGroupingRule {
+  #private;
+  readonly name: string;
+  readonly contents = true;
+  private constructor();
+  getParameters(): FunctionParameter[];
+  get cssText(): string;
+  set cssText(_value: string);
+}
+/** Experimental native CSS mixin application with a contents block. */
+export declare class CSSApplyBlockRule extends CSSGroupingRule {
+  #private;
+  readonly name: string;
+  private constructor();
+  getArguments(): string[];
+  get cssText(): string;
+  set cssText(_value: string);
+}
+/** Experimental native CSS mixin application without a contents block. */
+export declare class CSSApplyStatementRule extends CSSRule {
+  #private;
+  readonly name: string;
+  private constructor();
+  getArguments(): string[];
+  get cssText(): string;
+  set cssText(_value: string);
+}
+/** Experimental native CSS mixin contents placeholder with a fallback block. */
+export declare class CSSContentsBlockRule extends CSSGroupingRule {
+  private constructor();
+  get cssText(): string;
+  set cssText(_value: string);
+}
+/** Experimental native CSS mixin contents placeholder without a fallback. */
+export declare class CSSContentsStatementRule extends CSSRule {
+  private constructor();
+  get cssText(): string;
+  set cssText(_value: string);
+}
 /** A live `@media` rule. */
-declare class CSSMediaRule extends CSSConditionRule {
+export declare class CSSMediaRule extends CSSConditionRule {
   readonly media: MediaList;
   private constructor();
   get conditionText(): string;
@@ -889,13 +936,13 @@ declare class CSSMediaRule extends CSSConditionRule {
   set cssText(_value: string);
 }
 /** A live `@supports` rule. */
-declare class CSSSupportsRule extends CSSConditionRule {
+export declare class CSSSupportsRule extends CSSConditionRule {
   private constructor();
   get cssText(): string;
   set cssText(_value: string);
 }
 /** A live `@container` rule. */
-declare class CSSContainerRule extends CSSConditionRule {
+export declare class CSSContainerRule extends CSSConditionRule {
   readonly containerName: string;
   readonly containerQuery: string;
   private constructor();
@@ -903,7 +950,7 @@ declare class CSSContainerRule extends CSSConditionRule {
   set cssText(_value: string);
 }
 /** An immutable statement-form `@layer` rule. */
-declare class CSSLayerStatementRule extends CSSRule {
+export declare class CSSLayerStatementRule extends CSSRule {
   #private;
   private constructor();
   get nameList(): readonly string[];
@@ -911,14 +958,14 @@ declare class CSSLayerStatementRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A live block-form `@layer` rule. */
-declare class CSSLayerBlockRule extends CSSGroupingRule {
+export declare class CSSLayerBlockRule extends CSSGroupingRule {
   readonly name: string;
   private constructor();
   get cssText(): string;
   set cssText(_value: string);
 }
 /** A live `@scope` rule. */
-declare class CSSScopeRule extends CSSGroupingRule {
+export declare class CSSScopeRule extends CSSGroupingRule {
   readonly start: string | null;
   readonly end: string | null;
   private constructor();
@@ -926,13 +973,13 @@ declare class CSSScopeRule extends CSSGroupingRule {
   set cssText(_value: string);
 }
 /** A live `@starting-style` rule. */
-declare class CSSStartingStyleRule extends CSSGroupingRule {
+export declare class CSSStartingStyleRule extends CSSGroupingRule {
   private constructor();
   get cssText(): string;
   set cssText(_value: string);
 }
 /** A non-loading `@import` rule with mutable media. */
-declare class CSSImportRule extends CSSRule {
+export declare class CSSImportRule extends CSSRule {
   #private;
   readonly media: MediaList;
   readonly styleSheet: null;
@@ -944,7 +991,7 @@ declare class CSSImportRule extends CSSRule {
   set cssText(_value: string);
 }
 /** An immutable `@namespace` rule. */
-declare class CSSNamespaceRule extends CSSRule {
+export declare class CSSNamespaceRule extends CSSRule {
   #private;
   readonly namespaceURI: string;
   readonly prefix: string;
@@ -953,7 +1000,7 @@ declare class CSSNamespaceRule extends CSSRule {
   set cssText(_value: string);
 }
 /** An immutable `@property` registration rule. */
-declare class CSSPropertyRule extends CSSRule {
+export declare class CSSPropertyRule extends CSSRule {
   #private;
   readonly name: string;
   readonly syntax: string;
@@ -964,7 +1011,7 @@ declare class CSSPropertyRule extends CSSRule {
   set cssText(_value: string);
 }
 /** An immutable `@font-palette-values` rule. */
-declare class CSSFontPaletteValuesRule extends CSSRule {
+export declare class CSSFontPaletteValuesRule extends CSSRule {
   #private;
   readonly name: string;
   readonly fontFamily: string;
@@ -975,7 +1022,7 @@ declare class CSSFontPaletteValuesRule extends CSSRule {
   set cssText(_value: string);
 }
 /** An immutable `@view-transition` rule. */
-declare class CSSViewTransitionRule extends CSSRule {
+export declare class CSSViewTransitionRule extends CSSRule {
   #private;
   readonly navigation: string;
   readonly types: readonly string[];
@@ -984,8 +1031,8 @@ declare class CSSViewTransitionRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A live declaration block with indexed, named, and method-based access. */
-interface CSSStyleDeclaration extends CSSStyleDeclarationNamedProperties {}
-declare class CSSStyleDeclaration {
+export interface CSSStyleDeclaration extends CSSStyleDeclarationNamedProperties {}
+export declare class CSSStyleDeclaration {
   #private;
   readonly [index: number]: string | undefined;
   readonly parentRule: CSSRule;
@@ -1002,14 +1049,14 @@ declare class CSSStyleDeclaration {
   removeProperty(name: string): string;
 }
 /** A live `@font-face` descriptor rule. */
-declare class CSSFontFaceRule extends CSSRule {
+export declare class CSSFontFaceRule extends CSSRule {
   readonly style: CSSStyleDeclaration;
   private constructor();
   get cssText(): string;
   set cssText(_value: string);
 }
 /** Declarations ordered after a nested style rule. */
-declare class CSSNestedDeclarations extends CSSRule {
+export declare class CSSNestedDeclarations extends CSSRule {
   #private;
   private constructor();
   get style(): CSSStyleDeclaration;
@@ -1018,7 +1065,7 @@ declare class CSSNestedDeclarations extends CSSRule {
   set cssText(_value: string);
 }
 /** A run of live descriptors inside a custom function. */
-declare class CSSFunctionDeclarations extends CSSRule {
+export declare class CSSFunctionDeclarations extends CSSRule {
   #private;
   private constructor();
   get style(): CSSFunctionDescriptors;
@@ -1027,12 +1074,12 @@ declare class CSSFunctionDeclarations extends CSSRule {
   set cssText(_value: string);
 }
 /** The declaration interface used by `CSSFunctionDeclarations`. */
-declare class CSSFunctionDescriptors extends CSSStyleDeclaration {
+export declare class CSSFunctionDescriptors extends CSSStyleDeclaration {
   get result(): string;
   set result(_value: string | null);
 }
 /** A page-margin rule nested inside `CSSPageRule`. */
-declare class CSSMarginRule extends CSSRule {
+export declare class CSSMarginRule extends CSSRule {
   readonly name: string;
   readonly style: CSSStyleDeclaration;
   private constructor();
@@ -1040,7 +1087,7 @@ declare class CSSMarginRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A live `@page` rule with declarations and margin rules. */
-declare class CSSPageRule extends CSSGroupingRule {
+export declare class CSSPageRule extends CSSGroupingRule {
   #private;
   readonly style: CSSStyleDeclaration;
   private constructor();
@@ -1049,16 +1096,20 @@ declare class CSSPageRule extends CSSGroupingRule {
   get cssText(): string;
   set cssText(_value: string);
 }
-/** A live `@position-try` declaration rule. */
-declare class CSSPositionTryRule extends CSSRule {
+/** The allowed descriptors of an anchor positioning fallback rule. */
+export declare class CSSPositionTryDescriptors extends CSSStyleDeclaration {}
+/** A named anchor positioning fallback rule. */
+export declare class CSSPositionTryRule extends CSSRule {
+  #private;
   readonly name: string;
-  readonly style: CSSStyleDeclaration;
   private constructor();
+  get style(): CSSPositionTryDescriptors;
+  set style(cssText: string);
   get cssText(): string;
   set cssText(_value: string);
 }
 /** One mutable keyframe selector and declaration block. */
-declare class CSSKeyframeRule extends CSSRule {
+export declare class CSSKeyframeRule extends CSSRule {
   #private;
   readonly style: CSSStyleDeclaration;
   private constructor();
@@ -1068,7 +1119,7 @@ declare class CSSKeyframeRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A mutable `@keyframes` rule. */
-declare class CSSKeyframesRule extends CSSRule {
+export declare class CSSKeyframesRule extends CSSRule {
   #private;
   readonly cssRules: CSSRuleList;
   private constructor();
@@ -1082,7 +1133,7 @@ declare class CSSKeyframesRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A mutable `@counter-style` descriptor rule. */
-declare class CSSCounterStyleRule extends CSSRule {
+export declare class CSSCounterStyleRule extends CSSRule {
   #private;
   private constructor();
   get name(): string;
@@ -1111,7 +1162,7 @@ declare class CSSCounterStyleRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A live map exposed by one font-feature-values category. */
-declare class CSSFontFeatureValuesMap implements Iterable<[string, number[]]> {
+export declare class CSSFontFeatureValuesMap implements Iterable<[string, number[]]> {
   #private;
   private constructor();
   get size(): number;
@@ -1127,7 +1178,7 @@ declare class CSSFontFeatureValuesMap implements Iterable<[string, number[]]> {
   [Symbol.iterator](): MapIterator<[string, number[]]>;
 }
 /** A mutable `@font-feature-values` rule. */
-declare class CSSFontFeatureValuesRule extends CSSRule {
+export declare class CSSFontFeatureValuesRule extends CSSRule {
   #private;
   readonly annotation: CSSFontFeatureValuesMap;
   readonly ornaments: CSSFontFeatureValuesMap;
@@ -1142,7 +1193,7 @@ declare class CSSFontFeatureValuesRule extends CSSRule {
   set cssText(_value: string);
 }
 /** A live style rule with declarations and nested rules. */
-declare class CSSStyleRule extends CSSGroupingRule {
+export declare class CSSStyleRule extends CSSGroupingRule {
   #private;
   readonly style: CSSStyleDeclaration;
   private constructor();
@@ -1151,19 +1202,23 @@ declare class CSSStyleRule extends CSSGroupingRule {
   get cssText(): string;
   set cssText(_value: string);
 }
-/** A mutable, browser-shaped authoring stylesheet. */
-declare class CSSStyleSheet {
-  #private;
-  readonly cssRules: CSSRuleList;
+/** Shared stylesheet metadata. Instances are created through CSSStyleSheet. */
+export declare class StyleSheet {
   readonly media: MediaList;
   readonly ownerNode: null;
   readonly parentStyleSheet: null;
-  readonly ownerRule: null;
   readonly title: null;
   readonly type = "text/css";
   disabled: boolean;
-  constructor(options?: CSSStyleSheetOptions | null);
+  protected constructor();
   get href(): string | null;
+}
+/** A mutable, browser-shaped authoring stylesheet. */
+export declare class CSSStyleSheet extends StyleSheet {
+  #private;
+  readonly cssRules: CSSRuleList;
+  readonly ownerRule: null;
+  constructor(options?: CSSStyleSheetOptions | null);
   get baseURL(): string;
   insertRule(ruleText: string, index?: number): number;
   deleteRule(index: number): void;
@@ -1177,7 +1232,7 @@ declare class CSSStyleSheet {
   takeDiagnostics(): SheetOMDiagnostic[];
 }
 /** Forgivingly parse an existing regular stylesheet without loading imports. */
-declare function parseStyleSheet(cssText: string, options?: ParseStyleSheetOptions): CSSStyleSheet;
+export declare function parseStyleSheet(cssText: string, options?: ParseStyleSheetOptions): CSSStyleSheet;
 //#endregion
-export { CSSConditionRule, CSSContainerRule, CSSCounterStyleRule, CSSDeclarationMutation, CSSDeclarationMutationResult, CSSFontFaceRule, CSSFontFeatureValuesMap, CSSFontFeatureValuesRule, CSSFontPaletteValuesRule, CSSFunctionDeclarations, CSSFunctionDescriptors, CSSFunctionRule, CSSGroupingRule, CSSImportRule, CSSKeyframeRule, CSSKeyframesRule, CSSLayerBlockRule, CSSLayerStatementRule, CSSMarginRule, CSSMediaRule, CSSNamespaceRule, CSSNestedDeclarations, CSSPageRule, CSSPositionTryRule, CSSPropertyRule, CSSRule, CSSRuleList, CSSScopeRule, CSSStartingStyleRule, CSSStyleDeclaration, CSSStyleRule, CSSStyleSheet, CSSStyleSheetOptions, CSSSupportsRule, CSSViewTransitionRule, FunctionParameter, MediaList, ParseStyleSheetOptions, type SheetOMDiagnostic, type SheetOMDiagnosticCode, type SheetOMMutationDiagnostic, type SheetOMMutationDiagnosticCode, type SheetOMResourceBudget, type SheetOMSerializationDiagnostic, type SheetOMSerializationDiagnosticCode, SheetOMSerializationError, type SheetOMSerializationErrorCode, parseStyleSheet };
+export type { SheetOMDiagnostic, SheetOMDiagnosticCode, SheetOMMutationDiagnostic, SheetOMMutationDiagnosticCode, SheetOMResourceBudget, SheetOMSerializationDiagnostic, SheetOMSerializationDiagnosticCode, SheetOMSerializationErrorCode };
 //# sourceMappingURL=index.d.cts.map