npm.io
1.0.0 • Published 2 months ago

css-typed-om

Licence
MIT
Version
1.0.0
Deps
0
Size
846 kB
Vulns
0
Weekly
0
Stars
11

CSS Typed OM Polyfill

This polyfill brings the CSS Typed OM Level 1 Specification to browsers that do not yet support it, allowing you to interact with CSS values as typed JavaScript objects rather than strings.

This project is fully tested using the official Web Platform Tests (WPT).

  • WPT Commit: fbc1b90e2 (2026-08-19T1039Z)
  • PASS: 12476 / 13134
  • FAIL: 658 / 13134

Features

  • Specification-Compliant: Implementation matches the CSS Typed OM Level 1 spec.
  • Automatic Polyfilling: Automatically patches window.CSS, Element.prototype.computedStyleMap, HTMLElement.prototype.attributeStyleMap, and other relevant interfaces if running in a browser.
  • Typed Values: Supports CSSUnitValue, CSSMathValue, CSSTransformValue, CSSColorValue, and more.
  • Fully Typed: Written in TypeScript with standard types exported.
  • ESM & IIFE Support: Built for modern environments and direct browser script usage.
  • Fully WPT Tested: This project is fully tested using the official Web Platform Tests (WPT).

Installation

npm install css-typed-om

Usage

1. As a Polyfill

Simply import the package to automatically install the polyfill on the global scope:

import 'css-typed-om';

// Now you can use the typed OM API
const element = document.querySelector('.my-element');
const width = element.computedStyleMap().get('width');

console.log(width.value); // e.g., 100
console.log(width.unit);  // e.g., 'px'

// Setting styles
element.attributeStyleMap.set('opacity', CSS.number(0.5));
element.attributeStyleMap.set('margin-top', CSS.px(20));
2. As a Module (Explicit Imports)

If you prefer to use the classes directly without relying on global patching (or for testing/Node environments):

import { CSSUnitValue, CSSKeywordValue } from 'css-typed-om';

const width = new CSSUnitValue(100, 'px');
const display = new CSSKeywordValue('block');

Development

Installation

To install dependencies for development:

npm install
Building

To build the project (ESM, IIFE, and Types):

npm run build
Testing

To run all tests (unit and Web Platform Tests):

npm run test

Or you can run them individually:

  1. Unit Tests: Fast tests using Vitest.

    npm run test:unit
  2. Web Platform Tests (WPT): Runs the official WPT suite for CSS Typed OM.

    # Run WPT tests (requires Python and Firefox)
    npm run test:wpt
    
    # Run WPT tests locally for debugging
    npm run test:wpt:local
    
    # Update WPT to latest version
    npm run test:wpt:update

Acknowledgements

The package name css-typed-om was kindly handed over by Jonathan Neal who authored the (now archived) https://github.com/csstools/css-typed-om project.

License

MIT

Disclaimer

This project is mostly AI-generated using Google Antigravity, based on the spec and WPT.

Keywords