@xdanangelxoqenpm/occaecati-optio-pariatur

v1.0.0

Published

8 months ago

PostCSS plugin to partially polyfill experimental `@scope` at-rule.

Downloads

0High
0Medium
0Low

thanhmai019901

resolve parsing es6 String.prototype.trim colour private syntax argument toStringTag stringify ratelimit String.prototype.matchAll watch wrap description hooks input efficient ECMAScript 2021 higher-order omit loading linewrap setImmediate text module classnames drop up es-shims eventDispatcher query own redirect tslib sharedarraybuffer StyleSheet east-asian-width agent BigInt64Array write ast await utility schema flatten Reflect.getPrototypeOf ES2017 byte descriptors redact getintrinsic 256 typeof cloudfront functions Array.prototype.includes stream Array.prototype.findLast apollo structuredClone Object.entries testing negative zero events curl promise stringifier forms expression cloudtrail byteLength graphql spinners symbol validate inspect live error password CSS telephone karma full regex create findLast tape react ECMAScript 2023 link browserslist matches shrinkwrap includes qs flags glacier Uint32Array proto values dataView queue columns yup RFC-6455 unicode ECMAScript 2017 ecmascript date estree ES7 ES2019 cjk quote datastructure less.js css-in-js robust package logging es2017 AsyncIterator assign output util.inspect fast-copy dependency manager cli fastcopy trimEnd scheme es2015 rm -fr sqs rapid endpoint style ender from toSorted mocha walking key multi-package ECMAScript 6 hardlinks Object nope typed redux-toolkit guid http every compare inference Rx diff set styles typescript iteration web javascript sorted channel terminal rds extra ie width bootstrap css queueMicrotask amazon @@toStringTag deep-copy xterm less css Object.values Microsoft full-width pnpm9 regular expression has WebSocket lint Observables deterministic ECMAScript 2015 arraybuffer BigUint64Array lru eslint-plugin protocol-buffers figlet jasmine getPrototypeOf concatMap Array.prototype.flatten typesafe class-validator ECMAScript 2022 hash fullwidth URL consume dynamodb mime-db idle setter define elm postcss ES3 sham bootstrap less optimizer typed array equality css less installer [[Prototype]]internal beanstalk vpc look-up random weakmap busy args promises modules es-shim API forEach streams2 ajv value mime search Int8Array authentication nodejs compile less ReactiveExtensions ES6 ECMAScript 2020 number ES5 awesomesauce mru environment es .env option emoji findup validation bundling types ajax toArray Function.prototype.name rm ArrayBuffer url symlinks ReactiveX fastclone RegExp#flags chinese descriptor hot regexp match crypto aws Object.assign japanese typeerror entries emr shell read Underscore Array.prototype.contains callbind shim ec2 test side lesscss sort storagegateway https streams map eslint TypeBox watching getopt ES2022 node batch ses shebang ESnext command spinner buffer commander util watcher patch typedarrays wordbreak YAML accessor break Symbol.toStringTag debugger intrinsic moment stylesheet progress mapreduce jsonpath fixed-width js deepcopy bcrypt bind Symbol concat language delete some CSSStyleDeclaration trimStart obj immer check listeners i18n variables in css require make mimetypes data kinesis id rangeerror iterate api get client TypedArray superagent prototype es2018 Object.defineProperty mkdirs escape loadbalancing Stream walk hasOwn airbnb filter Object.getPrototypeOf generics type proxy assertion korean async native hasOwnProperty serialization matchAll name keys package.json has-own isConcatSpreadable valid persistent styling ebs connect string byteOffset less mixins indicator waf jwt parser sameValueZero serialize clone superstruct trimRight chromium ES2015 flat fetch symbols utilities path Array.prototype.findLastIndex ES2016 colors route53 Object.fromEntries symlink location autoprefixer rgb cloudsearch group ES2021 term react-hooks property querystring lockfile scheme-validation stable limited deep regular expressions tostringtag logger dom-testing-library find ES2018 workflow ES8 dir fps which call tdd es7 chai file system gdpr crypt express s3 positive bundler cloudwatch defineProperty importexport predictable monorepo banner styled-components Set Uint8Array make dir character HyBi mobile command-line touch JSON-Schema Float32Array redux immutable zod performant chrome invariant circular tap dataview auth stdlib speed framework typedarray Array.prototype.filter browserlist Float64Array nested css reduce preprocessor eslintconfig state ECMAScript 7 electron dayjs protobuf sns css prefix move Int32Array censor iterator fast pipe is Array.prototype.flatMap collection worker tty mkdir encryption rmdir ArrayBuffer#slice last cache RegExp.prototype.flags Observable dotenv weakset less JSON accessibility elb regular in reuse route concurrency whatwg parse gradients css length internal slot styleguide bluebird rfc4122 deepclone find-up core a11y import Promise lazy task getter npm Object.is slot form-validation Uint8ClampedArray es8 ansi wait fast-clone workspace:*toolkit json ArrayBuffer.prototype.slice browser ECMAScript 2018 settings watchFile eslintplugin debug function Iterator WebSockets install negative open jsx URLSearchParams call-bind -0 copy traverse replay minimal cors routing package manager folder autoscaling properties packages request toobject computed-types configurable joi preserve-symlinks Object.keys phone duplex bdd Map espree bound time readablestream formatting reducer argv Array polyfill call-bound writable sequence tester enumerable react-hook-form 0 art Push css nesting _.extend extend pretty arrays runtime contains hookform dom rate log Int16Array jsdom emit once form helpers readable gradients css3 classes setPrototypeOf directory l10n stateless parent warning limit dependencies react-testing-library findLastIndex vest __proto__jsdiff cloudformation real-time object zero throttle private data TypeScript prop file groupBy metadata visual es-abstract ECMAScript 3 fastify io-ts

PostCSS @scope polyfill

PostCSS plugin to partially polyfill experimental @scope at-rule.

The idea

If we consider limited depth of DOM tree then we can polyfill some parts of styles scoping specification. For example this selector in scoping rule

@scope (.scoping-root) to (.scoping-limit) {
  a {
    color: rebeccapurple;
  }
}

can be rewritten to list of selectors

.scoping-root > a:not(.scoping-limit),
.scoping-root > :not(.scoping-limit) > a:not(.scoping-limit),
.scoping-root
  > :not(.scoping-limit)
  > :not(.scoping-limit)
  > a:not(.scoping-limit) {
  color: rebeccapurple;
}

And to preserve original specificity of selector we cen wrap it in :where() pseudo class:

a:where(
    .scoping-root > a:not(.scoping-limit),
    .scoping-root > :not(.scoping-limit) > a:not(.scoping-limit),
    .scoping-root
      > :not(.scoping-limit)
      > :not(.scoping-limit)
      > a:not(.scoping-limit)
  ) {
  color: rebeccapurple;
}

Limitations

DOM depth

Main limitation of this polyfill is that it will not work for unlimited depth of DOM tree (or to be more specific the distance from scoping root to matched element). For example above result will look like this:

<div class="scoping-root">
  <a>in the scope</a>
  <a class="scoping-limit">not in the scope</a>
  <div>
    <div>
      <div>
        <a>in the scope but not matched because of depth limitation</a>
      </div>
    </div>
  </div>
</div>

This should't be a major problem for application based on components. Usually we would limit scoping so that it wouldn't match html elements inside inner components. For example

function SomeComponent(props) {
  return (
    <div className="scoping-root">
      <a href="#">in the scope</a>
      <div className="scoping-limit">
        <SomeOtherComponent />
      </div>
    </div>
  );
}

Scope proximity

Scope Proximity could probably be polyfilled using Style Queries. The problem is that browser support for style queries is even more limited the support for native scoping so for now this is not supported by this plugin.

Performance

Size of output CSS

Size of output css can grow really high with increasing value of depth option so this should be taken into consideration. On the other hand beacause of repetitiveness in the output code it compresses extremely well. Here are some examples for .css file conting simple example from this README:

@scope (.scoping-root) to (.scoping-limit) {
  a {
    color: rebeccapurple;
  }
}

Impact of depth option on size of output file and level of compression

Note: This requires more "real life" examples to test

Style calculation

Using this polyfill instead of native scoping can increase style recalculation time. This may differ between browser. Polyfilled code extensively uses child combinator (>) and this should help browsers to "fast reject" during element matching but nevertheless this problem requires more testing and deep diving into it.

PostCSS Options

module.exports = {
  plugins: [
    require("@xdanangelxoqenpm/occaecati-optio-pariatur")({
      /* options */
    }),
  ],
};

depth number: maximum DOM tree depth to support scoping. Default value: 10.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme