sheetom 0.1.0-rc.9 → 0.1.1

package/dist/index.d.cts

@@ -1,6 +1,30 @@
 //#region src/diagnostics.d.ts
 /** Stable machine-readable codes emitted by opt-in mutation diagnostics. */
-type SheetOMDiagnosticCode = "INVALID_PRIORITY" | "INVALID_PROPERTY_VALUE" | "UNSUPPORTED_SHORTHAND_VALUE";
+type SheetOMMutationDiagnosticCode = "INVALID_PRIORITY" | "INVALID_PROPERTY_VALUE" | "UNSUPPORTED_SHORTHAND_VALUE";
+type SheetOMSerializationDiagnosticCode = "UNREPRESENTABLE_PENDING_SHORTHAND";
+type SheetOMDiagnosticCode = SheetOMMutationDiagnosticCode | SheetOMSerializationDiagnosticCode;
+/** A structured explanation for an ignored mutation. */
+interface SheetOMMutationDiagnostic {
+  code: SheetOMMutationDiagnosticCode;
+  severity: "warning";
+  operation: "setProperty";
+  message: string;
+  property: string;
+  input: string;
+  location: null;
+}
+/** A structured explanation for a best-effort serialization recovery. */
+interface SheetOMSerializationDiagnostic {
+  code: SheetOMSerializationDiagnosticCode;
+  severity: "warning";
+  operation: "serialize";
+  message: string;
+  property: string;
+  input: "";
+  location: null;
+  conflictingLonghands: readonly string[];
+}
+type SheetOMDiagnostic = SheetOMMutationDiagnostic | SheetOMSerializationDiagnostic;
 //#endregion
 //#region src/generated/css-style-declaration-properties.d.ts
 /** Named CSS properties supported by the pinned Chromium compatibility baseline. */
@@ -728,17 +752,36 @@ interface SheetOMResourceBudget {
   maxDeclarationsPerBlock?: number;
 }
 //#endregion
+//#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 {
+  readonly code: SheetOMSerializationErrorCode;
+  readonly shorthand: string;
+  readonly conflictingLonghands: readonly string[];
+  constructor(shorthand: string, conflictingLonghands: readonly string[], options?: ErrorOptions);
+}
+//#endregion
 //#region src/index.d.ts
-/** A structured explanation for an ignored or recovered mutation. */
-interface SheetOMDiagnostic {
-  code: SheetOMDiagnosticCode;
-  severity: "warning";
-  operation: "setProperty";
-  message: string;
+/** One ordered declaration mutation executed by SheetOM's engine extension. */
+type CSSDeclarationMutation = {
+  kind: "set";
   property: string;
-  input: string;
-  location: null;
-}
+  value: string | null;
+  priority?: string | null;
+} | {
+  kind: "remove";
+  property: string;
+};
+/** The result at the matching index of an ordered declaration mutation batch. */
+type CSSDeclarationMutationResult = {
+  kind: "set";
+  accepted: boolean;
+  diagnostic: SheetOMDiagnostic | null;
+} | {
+  kind: "remove";
+  value: string;
+};
 /** Options for a constructed SheetOM stylesheet. */
 interface CSSStyleSheetOptions {
   baseURL?: string;
@@ -946,7 +989,7 @@ declare class CSSStyleDeclaration {
   #private;
   readonly [index: number]: string | undefined;
   readonly parentRule: CSSRule;
-  protected constructor(parentRule: CSSRule);
+  protected constructor(parentRule: CSSRule, initialCssText?: string);
   get cssText(): string;
   set cssText(value: string);
   get length(): number;
@@ -954,6 +997,8 @@ declare class CSSStyleDeclaration {
   getPropertyValue(name: string): string;
   getPropertyPriority(name: string): string;
   setProperty(name: string, value: string | null, priority?: string): void;
+  /** Apply ordered declaration mutations through one engine boundary crossing. */
+  applyMutations(mutations: readonly CSSDeclarationMutation[]): CSSDeclarationMutationResult[];
   removeProperty(name: string): string;
 }
 /** A live `@font-face` descriptor rule. */
@@ -1126,11 +1171,13 @@ declare class CSSStyleSheet {
   replace(cssText: string): Promise<CSSStyleSheet>;
   /** Serialize current state as reparsable CSS without mutating live objects. */
   serialize(): string;
-  /** Drain opt-in mutation diagnostics without affecting CSSOM behavior. */
+  /** Serialize current state only when its CSS semantics can be preserved exactly. */
+  serializeStrict(): string;
+  /** Drain opt-in mutation and serialization diagnostics without affecting CSSOM behavior. */
   takeDiagnostics(): SheetOMDiagnostic[];
 }
 /** Forgivingly parse an existing regular stylesheet without loading imports. */
 declare function parseStyleSheet(cssText: string, options?: ParseStyleSheetOptions): CSSStyleSheet;
 //#endregion
-export { CSSConditionRule, CSSContainerRule, CSSCounterStyleRule, 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, SheetOMDiagnostic, type SheetOMDiagnosticCode, type SheetOMResourceBudget, parseStyleSheet };
+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 };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,6 +1,30 @@
 //#region src/diagnostics.d.ts
 /** Stable machine-readable codes emitted by opt-in mutation diagnostics. */
-type SheetOMDiagnosticCode = "INVALID_PRIORITY" | "INVALID_PROPERTY_VALUE" | "UNSUPPORTED_SHORTHAND_VALUE";
+type SheetOMMutationDiagnosticCode = "INVALID_PRIORITY" | "INVALID_PROPERTY_VALUE" | "UNSUPPORTED_SHORTHAND_VALUE";
+type SheetOMSerializationDiagnosticCode = "UNREPRESENTABLE_PENDING_SHORTHAND";
+type SheetOMDiagnosticCode = SheetOMMutationDiagnosticCode | SheetOMSerializationDiagnosticCode;
+/** A structured explanation for an ignored mutation. */
+interface SheetOMMutationDiagnostic {
+  code: SheetOMMutationDiagnosticCode;
+  severity: "warning";
+  operation: "setProperty";
+  message: string;
+  property: string;
+  input: string;
+  location: null;
+}
+/** A structured explanation for a best-effort serialization recovery. */
+interface SheetOMSerializationDiagnostic {
+  code: SheetOMSerializationDiagnosticCode;
+  severity: "warning";
+  operation: "serialize";
+  message: string;
+  property: string;
+  input: "";
+  location: null;
+  conflictingLonghands: readonly string[];
+}
+type SheetOMDiagnostic = SheetOMMutationDiagnostic | SheetOMSerializationDiagnostic;
 //#endregion
 //#region src/generated/css-style-declaration-properties.d.ts
 /** Named CSS properties supported by the pinned Chromium compatibility baseline. */
@@ -728,17 +752,36 @@ interface SheetOMResourceBudget {
   maxDeclarationsPerBlock?: number;
 }
 //#endregion
+//#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 {
+  readonly code: SheetOMSerializationErrorCode;
+  readonly shorthand: string;
+  readonly conflictingLonghands: readonly string[];
+  constructor(shorthand: string, conflictingLonghands: readonly string[], options?: ErrorOptions);
+}
+//#endregion
 //#region src/index.d.ts
-/** A structured explanation for an ignored or recovered mutation. */
-interface SheetOMDiagnostic {
-  code: SheetOMDiagnosticCode;
-  severity: "warning";
-  operation: "setProperty";
-  message: string;
+/** One ordered declaration mutation executed by SheetOM's engine extension. */
+type CSSDeclarationMutation = {
+  kind: "set";
   property: string;
-  input: string;
-  location: null;
-}
+  value: string | null;
+  priority?: string | null;
+} | {
+  kind: "remove";
+  property: string;
+};
+/** The result at the matching index of an ordered declaration mutation batch. */
+type CSSDeclarationMutationResult = {
+  kind: "set";
+  accepted: boolean;
+  diagnostic: SheetOMDiagnostic | null;
+} | {
+  kind: "remove";
+  value: string;
+};
 /** Options for a constructed SheetOM stylesheet. */
 interface CSSStyleSheetOptions {
   baseURL?: string;
@@ -946,7 +989,7 @@ declare class CSSStyleDeclaration {
   #private;
   readonly [index: number]: string | undefined;
   readonly parentRule: CSSRule;
-  protected constructor(parentRule: CSSRule);
+  protected constructor(parentRule: CSSRule, initialCssText?: string);
   get cssText(): string;
   set cssText(value: string);
   get length(): number;
@@ -954,6 +997,8 @@ declare class CSSStyleDeclaration {
   getPropertyValue(name: string): string;
   getPropertyPriority(name: string): string;
   setProperty(name: string, value: string | null, priority?: string): void;
+  /** Apply ordered declaration mutations through one engine boundary crossing. */
+  applyMutations(mutations: readonly CSSDeclarationMutation[]): CSSDeclarationMutationResult[];
   removeProperty(name: string): string;
 }
 /** A live `@font-face` descriptor rule. */
@@ -1126,11 +1171,13 @@ declare class CSSStyleSheet {
   replace(cssText: string): Promise<CSSStyleSheet>;
   /** Serialize current state as reparsable CSS without mutating live objects. */
   serialize(): string;
-  /** Drain opt-in mutation diagnostics without affecting CSSOM behavior. */
+  /** Serialize current state only when its CSS semantics can be preserved exactly. */
+  serializeStrict(): string;
+  /** Drain opt-in mutation and serialization diagnostics without affecting CSSOM behavior. */
   takeDiagnostics(): SheetOMDiagnostic[];
 }
 /** Forgivingly parse an existing regular stylesheet without loading imports. */
 declare function parseStyleSheet(cssText: string, options?: ParseStyleSheetOptions): CSSStyleSheet;
 //#endregion
-export { CSSConditionRule, CSSContainerRule, CSSCounterStyleRule, 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, SheetOMDiagnostic, type SheetOMDiagnosticCode, type SheetOMResourceBudget, parseStyleSheet };
+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 };
 //# sourceMappingURL=index.d.ts.map