@uindow/css 1.0.1

package/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026-present Uindow™ (https://uindow.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,294 @@
+# @uindow/css - The Smarter CSS Selector Generator
+
+<p align="center">
+    <a href="https://uindow.com/?ref=github">
+        <img src="https://uindow.github.io/img/github-banner-css.png?v=2"/>
+    </a>
+</p>
+
+Generate one - or many - unique CSS selectors for any DOM element. Clean, human-readable output. A configurable penalty model that ranks results from most semantic to most specific. Built for performance, designed to stay out of your way.
+
+Works everywhere JavaScript runs: Node.js, browsers, and any environment with a DOM.
+
+<p align="center">
+    <a href="https://uindow.github.io/img/uindow-css.gif" target="_blank">
+        <img src="https://uindow.github.io/img/uindow-css.gif"/>
+    </a>
+</p>
+
+---
+
+## Installation
+
+**npm**
+
+```bash
+npm install @uindow/css
+```
+
+```js
+const { findOne, findAll } = require("@uindow/css");
+```
+
+**Browser (standalone)**
+
+```html
+<script src="https://uindow.github.io/css/selector.js"></script>
+<script>
+    const { findOne, findAll } = Uindow_CSS;
+</script>
+```
+
+---
+
+## Quick start
+
+```js
+const { findOne, findAll } = require("@uindow/css");
+
+// The single best selector
+const { selector, penalty } = findOne(document.querySelector(".hero"));
+// → '[data-id="42"] .hero'
+
+// Every viable selector, ranked from best to most specific
+const results = findAll(document.querySelector(".hero"), { maxResults: 5 });
+// → [
+//     { selector: '[data-id="42"] .hero',         penalty: 1.3  },
+//     { selector: '.hero',                        penalty: 1.3  },
+//     { selector: 'section [data-id="42"] .hero', penalty: 2.6  },
+//     { selector: 'main .hero',                   penalty: 2.75 },
+//     { selector: 'main .hero:nth-of-type(1)',    penalty: 4.4  },
+//   ]
+```
+
+---
+
+## Why @uindow/css?
+
+Most CSS selector generators treat the problem as a lookup: walk up the DOM, find something unique, done. One selector, take it or leave it.
+
+`@uindow/css` treats it as a **search problem**. It explores the space of possible selectors across every ancestor level, scores each candidate against a configurable penalty model, prunes aggressively to stay fast, and surfaces a ranked list of results - so you always get the shortest, most readable, most stable selector first, with fallbacks already computed.
+
+---
+
+## Comparison with `@medv/finder`
+
+| Feature | **@uindow/css** | **@medv/finder** |
+|---|---|---|
+| **Custom root element** | ✅ Any `HTMLElement`, `Document`, or `ShadowRoot` | ✅ Supported |
+| **ID filter** | ✅ `idFilter` filter | ✅ `idName` filter |
+| **Tag filter** | ✅ `tagFilter` filter | ✅ `tagName` filter |
+| **Class filter** | ✅ Excludes `is-*`, `has-*`, `js-*`, `css-*` by default | ⚠️ Less opinionated defaults |
+| **Attribute filter** | ✅ Excludes `style`, `width`, `height`, URLs, values ≥ 32 chars by default | ⚠️ Less opinionated defaults |
+| **Search timeout** | ✅ `timeout` with graceful fallback | ⚠️ May quit before an exhaustive search |
+| [**Returns multiple selectors**](#multiple-selectors-ranked-by-quality) | ✅ Up to `maxResults`, ranked by penalty | ❌ Single selector only |
+| [**Per-type penalty tuning**](#fine-grained-penalty-model) | ✅ `idPenalty`, `tagPenalty`, `attrPenalty`, `attrMatchPenalty`, `classPenalty`, `nthOfTypePenalty`, `nthChildPenalty`, `lengthPenaltyThreshold` | ❌ Not configurable |
+| [**Candidate/path caps**](#performance-controls) | ✅ `maxCandidatesPerLevel`, `maxPathsPerLevel`, `maxPathsTotal` | ❌ Not supported |
+| [**Prefix/suffix attribute matching**](#prefix-and-suffix-attribute-matching) | ✅ `[attr^="start"]`, `[attr$="end"]` | ❌ Not supported |
+| [**Human-readable attribute selectors**](#clean-human-readable-output) | ✅ Always emits `[attr="123"]` | ❌ Uses `CSS.escape()` |
+| [**Fuzziness**](#fuzziness) | ✅  Trade exclusivity for shorter selectors (`0%` to `100%`) | ❌ Not supported |
+| [**Effort**](#effort) | ✅  Trade processing time for shorter selectors (`0%` to `100%`) | ❌ Not supported |
+| [**Compound selectors**](#compound-selectors-at-every-level) | ✅ Attempts to merge tag, classes, and attributes at each level: `input.check[type="checkbox"][value="2"]` | ❌ Simple selectors only |
+
+---
+
+## Features
+
+### Multiple selectors, ranked by quality
+
+`findAll()` returns up to `maxResults` selectors sorted by ascending penalty - from the most semantic to the most specific. Pick the best one programmatically, or hand the whole list to your users.
+
+```js
+const { findAll } = require("@uindow/css");
+
+const results = findAll(el, { maxResults: 10 });
+
+results.forEach(({ selector, penalty }) => {
+    console.log(`${selector}  (penalty: ${penalty})`);
+});
+```
+
+### Prefix and suffix attribute matching
+
+When an exact attribute match would be brittle or unavailable, `@uindow/css` can generate selectors using the CSS `^=` (prefix) and `$=` (suffix) operators. They carry their own separate penalty so they only surface when genuinely useful.
+
+```css
+/* Exact match - always preferred */
+[data-id="42"]
+
+/* Prefix match - used when it uniquely identifies the element */
+[data-id^="prod-"]
+
+/* Suffix match */
+[data-id$="-active"]
+```
+
+Tune how eagerly these appear with `attrMatchPenalty` (default `1.2`).
+
+### Clean, human-readable output
+
+Every selector is emitted in the plain `[attr="value"]` format. No CSS-escaped sequences, no surprises when you read, copy, or paste the result.
+
+```css
+/* ✅ @uindow/css */
+[data-id="123"] .nav-item
+
+/* ❌ Other tools */
+[data-id="\31 23"] .nav-item
+```
+
+### Sensible default filters
+
+Unstable and noisy parts of the DOM are excluded before the search begins:
+
+- **Attributes** - `style`, `width`, `height`, URL values, and anything over 32 characters are ignored by default.
+- **Classes** - `is-*`, `has-*`, `js-*`, and `css-*` are ignored by default. These are state and behaviour hooks - they change at runtime and make brittle selectors.
+- **IDs** - all IDs are allowed by default. Provide your own `idFilter` to exclude auto-generated or dynamic ones.
+
+Every filter is a plain function, so your own rules are one line of code.
+
+### Fine-grained penalty model
+
+Each selector type has an independent penalty weight. Lower means it shows up more often in results; higher means it only appears when nothing better is available.
+
+| Option | Default | Controls |
+|---|---|---|
+| `idPenalty` | `1` | `#id` selectors |
+| `tagPenalty` | `1.1` | `div`, `span`, … |
+| `attrPenalty` | `1.25` | `[name]`, `[value="1"]` |
+| `attrMatchPenalty` | `1.2` | `[name^="x"]`, `[value$="5"]` |
+| `classPenalty` | `1.3` | `.button`, `.nav-item`, … |
+| `nthOfTypePenalty` | `3` | `div:nth-of-type(2)` |
+| `nthChildPenalty` | `6` | `:nth-child(3)` |
+| `lengthPenaltyThreshold` | `32` | Extra penalty for selectors longer than N chars |
+
+### Performance controls
+
+For large or deeply nested DOMs, hard caps keep the search bounded:
+
+```js
+const { findAll } = require("@uindow/css");
+
+findAll(el, {
+    maxCandidatesPerLevel: 2500, // Candidates evaluated per ancestor level
+    maxPathsPerLevel:        50, // Unique paths kept per level
+    maxPathsTotal:         1000, // Unique paths across the entire search
+    timeout:               1500, // Return best found so far after N ms
+});
+```
+
+### Fuzziness
+
+By default, `@uindow/css` only returns selectors that match the target element exclusively. Set `fuzziness > 0` to allow selectors that match the target *first* while potentially matching other elements too - trading strict uniqueness for shorter, cleaner output.
+
+```js
+findAll(el, { fuzziness: 0   }); // Strict - only exclusive selectors (default)
+findAll(el, { fuzziness: 5   }); // Up to 5% non-exclusive matches allowed
+findAll(el, { fuzziness: 20  }); // Relaxed - prioritise brevity
+findAll(el, { fuzziness: 100 }); // Fuzzy - only non-exclusive (first-match) selectors
+```
+
+### Effort
+
+Controls how much effort is spent optimizing partial results before returning the final list. This setting trades speed for result quality: higher values spend more time exploring candidates before producing the final result set.
+
+```js
+findAll(el, { effort: 0 });   // Low effort - quickly returns the first `maxResults`
+findAll(el, { effort: 50 });  // Medium effort - evaluates 25 × `maxResults` candidates before returning the final results
+findAll(el, { effort: 100 }); // Maximum effort - evaluates 50 × `maxResults` candidates before returning the final results
+```
+
+### Compound selectors at every level
+
+Most CSS selector generators pick a single token per ancestor level - a class, or an attribute, or a tag - and move on. This produces selectors that are either fragile (too generic) or bloated (too many levels deep).
+
+`@uindow/css` builds **compound selectors** at each level by default, combining the tag, relevant classes, and attributes into a single, precise token:
+
+```css
+/* ✅ @uindow/css - compound, precise, readable */
+input.check[type="checkbox"][value="2"]
+
+/* ❌ Other tools - simple, one token at a time */
+input
+.check
+[type="checkbox"]
+```
+
+The result is selectors that are shorter, more stable, and immediately understandable at a glance.
+
+---
+
+## API
+
+### `findOne(element, options?)`
+
+Returns the single best selector for `element`, or throws if none can be generated.
+
+```js
+const { findOne } = require("@uindow/css");
+
+const { selector, penalty } = findOne(document.getElementById("main"));
+// → { selector: '#main', penalty: 1 }
+```
+
+### `findAll(element, options?)`
+
+Returns up to `maxResults` selectors sorted by ascending penalty, or throws if none can be generated.
+
+```js
+const { findAll } = require("@uindow/css");
+
+const results = findAll(document.getElementById("main"), {
+    maxResults: 10,
+});
+```
+
+---
+
+## Configuration reference
+
+All configuration items are optional. Any omitted option falls back to its default.
+
+```js
+const { findAll } = require("@uindow/css");
+
+findAll(el, {
+    // Scope - nothing above this element appears in any selector
+    root: document.querySelector("#app"),  // Default: document.documentElement
+
+    // Filters - return false to exclude a candidate from the search
+    idFilter:    (name)        => !name.startsWith("auto-"),
+    tagFilter:   (name)        => name !== "div",
+    classFilter: (name)        => !name.startsWith("is-"),
+    attrFilter:  (name, value) => name.startsWith("data-") && value.length < 32,
+
+    // Penalties - lower value → type appears more often in results
+    idPenalty:              1,
+    tagPenalty:             1.1,
+    attrPenalty:            1.25,
+    attrMatchPenalty:       1.2,
+    classPenalty:           1.3,
+    nthOfTypePenalty:       3,
+    nthChildPenalty:        6,
+    lengthPenaltyThreshold: 32,
+
+    // Performance caps
+    maxCandidatesPerLevel:  2500,
+    maxPathsPerLevel:         50,
+    maxPathsTotal:          1000,
+    maxResults:               25,
+    timeout:                1500,
+
+    // Percentage of shorter, first-match selectors
+    fuzziness: 0,
+
+    // Effort spent on optimizing candidates
+    effort: 50
+});
+```
+
+---
+
+## License
+
+MIT © 2026 [Uindow™](https://uindow.com)

package/index.js

@@ -0,0 +1,28 @@
+/**
+ * Uindow's CSS Selector Generator
+ * 
+ * @architect Mark Jivko <mark@uindow.com>
+ * @copyright © 2026 Uindow™ (https://uindow.com)
+ * @license MIT
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files
+ * (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software,
+ * and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+ * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+"use strict";var E=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var v=f=>{throw TypeError(f)};var C=(f,e)=>E(f,"name",{value:e,configurable:!0});var q=(f,e)=>{for(var t in e)E(f,t,{get:e[t],enumerable:!0})},B=(f,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of V(e))!W.call(f,a)&&a!==t&&E(f,a,{get:()=>e[a],enumerable:!(n=I(e,a))||n.enumerable});return f};var J=f=>B(E({},"__esModule",{value:!0}),f);var K=(f,e,t)=>e.has(f)||v("Cannot "+t);var A=(f,e,t)=>e.has(f)?v("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(f):e.set(f,t);var h=(f,e,t)=>(K(f,e,"access private method"),t);var Y={};q(Y,{findAll:()=>X,findOne:()=>Q});module.exports=J(Y);var i,D,j,F,G,R,U,$,N;const c=class c{static findOne(e,t={}){return(typeof t!="object"||t===null)&&(t={}),c.findAll(e,{...t,maxResults:1})[0]}static findAll(e,t={}){var b,L,o,u,m,y,P;if(Node.ELEMENT_NODE!==e?.nodeType)throw new Error("Cannot generate a CSS selector for this element");if(e.tagName.toLowerCase()==="html")return[{selector:"html",penalty:0}];const n=h(b=c,i,D).call(b,t),a=performance.now(),r=(()=>{const s=e.getRootNode?.();return s?.constructor?.name==="ShadowRoot"?s:Node.DOCUMENT_NODE===n.root.nodeType?n.root:n.root.ownerDocument??n.root})(),l={},S=[];for(const{candidate:s,level:d}of h(L=c,i,j).call(L,e,n,r)){if(performance.now()-a>n.timeout)break;if(typeof l[d]>"u"&&(l[d]=0),!(l[d]>=n.maxPathsPerLevel)&&h(o=c,i,N).call(o,e,n,s,r)&&(S.push({path:s,penalty:h(u=c,i,U).call(u,s,n)}),l[d]++,S.length>=n.maxPathsTotal))break}if(S.length===0){const s=(()=>{var k,z;const d=[];let M=0,x=e;for(;x&&x!==r;){const H=x.tagName.toLowerCase(),O=h(k=c,i,$).call(k,x,H);if(O===-1)return[];d.push({compound:`${H}:nth-of-type(${O})`,penalty:n.nthOfTypePenalty,level:M}),x=x.parentElement,M++}return h(z=c,i,N).call(z,e,n,d,r)?d:[]})();if(!s.length)throw new Error("No fallback CSS selector was not found");return[{selector:h(m=c,i,R).call(m,s),penalty:h(y=c,i,U).call(y,s,n)}]}S.sort((s,d)=>s.penalty-d.penalty);const p=[],g=new Set,w=C(s=>{var M,x;const d=h(M=c,i,R).call(M,s);!d||g.has(d)||(g.add(d),p.push({selector:d,penalty:h(x=c,i,U).call(x,s,n)}))},"append"),_=n.maxResults*Math.round(1+n.effort/100*49);t:for(const{path:s}of S){for(const d of h(P=c,i,F).call(P,s,e,n,r))if(w(d),p.length>=_)break t;w(s)}return p.sort((s,d)=>s.penalty-d.penalty),p.slice(0,n.maxResults)}};i=new WeakSet,D=C(function(e={}){(typeof e!="object"||e===null)&&(e={});const t={};t.root=e.root instanceof HTMLElement?e.root:document.documentElement,t.idFilter=typeof e.idFilter=="function"?e.idFilter:()=>!0,t.tagFilter=typeof e.tagFilter=="function"?e.tagFilter:()=>!0,t.classFilter=typeof e.classFilter=="function"?e.classFilter:r=>!r.match(/^(is-|has-|js-|css-)/),t.attrFilter=typeof e.attrFilter=="function"?e.attrFilter:(r,l)=>!/(?:width|height|style)$/i.test(r)&&l.length<=32&&!/^(?:\w+:)?\/\/?/i.test(l);const n={lengthPenaltyThreshold:32,maxCandidatesPerLevel:2500,maxPathsPerLevel:50,maxPathsTotal:1e3,maxResults:25,fuzziness:0,effort:50,timeout:1500};for(const r of Object.keys(n))t[r]=Number.isInteger(e[r])?Math.abs(e[r]):n[r];t.fuzziness>100&&(t.fuzziness=100),t.effort>100&&(t.effort=100),t.lengthPenaltyThreshold<1&&(t.lengthPenaltyThreshold=1),t.maxResults<1&&(t.maxResults=1),t.maxPathsTotal<t.maxResults&&(t.maxPathsTotal=t.maxResults),t.maxPathsPerLevel<t.maxResults&&(t.maxPathsPerLevel=t.maxResults),t.maxCandidatesPerLevel<t.maxPathsPerLevel&&(t.maxCandidatesPerLevel=t.maxPathsPerLevel);const a={idPenalty:1,tagPenalty:1.1,classPenalty:1.3,attrPenalty:1.25,attrMatchPenalty:1.2,nthOfTypePenalty:3,nthChildPenalty:6};for(const r of Object.keys(a))t[r]=Number.isFinite(e[r])?Math.abs(e[r]):a[r];return t},"#config"),j=C(function*(e,t,n){var p;let a=e,r=0;function*l(g,w=[],_={count:0}){if(!(_.count>=t.maxCandidatesPerLevel)){if(!g.length){_.count++,yield w;return}for(const b of g[0]){if(_.count>=t.maxCandidatesPerLevel)return;yield*l(g.slice(1),w.concat(b),_)}}}C(l,"combine");const S=[];for(;a&&a!==n;){S.push(h(p=c,i,G).call(p,a,t,r));const g=[...l(S)];g.sort((w,_)=>{var b,L;return h(b=c,i,U).call(b,w,t)-h(L=c,i,U).call(L,_,t)});for(const w of g)yield{candidate:w,level:r};a=a.parentElement,r++}},"#find"),F=C(function*(e,t,n,a){var r,l;if(!(e.length<=2))for(let S=1;S<e.length-1;S++){const p=[...e];p.splice(S,1),h(r=c,i,N).call(r,t,n,p,a)&&(yield*h(l=c,i,F).call(l,p,t,n,a),yield p)}},"#optimize"),G=C(function(e,t,n=0){var b,L;const a=[],r=e.getAttribute("id");r&&t.idFilter(r)&&a.push({compound:"#"+CSS.escape(r),penalty:t.idPenalty,level:n});const l=e.tagName.toLowerCase();if(t.tagFilter(l)){a.push({compound:l,penalty:t.tagPenalty,level:n});const o=h(b=c,i,$).call(b,e,l);o!==-1&&a.push({compound:`${l}:nth-of-type(${o})`,penalty:t.nthOfTypePenalty,level:n});const u=h(L=c,i,$).call(L,e);u!==-1&&a.push({compound:`:nth-child(${u})`,penalty:t.nthChildPenalty,level:n})}const S=C((o,u)=>{if(!Array.isArray(o)||o.length<2||!Number.isFinite(u))return;const m=Math.min(8,o.length);for(let y=0;y<m;y++){a.push({compound:`${l}${o[y]}`,penalty:u,level:n});for(let P=y+1;P<m;P++){const s=`${o[y]}${o[P]}`;a.push({compound:s,penalty:u,level:n}),a.push({compound:`${l}${s}`,penalty:u,level:n})}}},"mergeTwo"),p=C((o,u)=>{if(!Array.isArray(o)||o.length<3||!Number.isFinite(u))return;const m=Math.min(8,o.length);for(let y=0;y<m;y++)for(let P=y+1;P<m;P++)for(let s=P+1;s<m;s++){const d=`${o[y]}${o[P]}${o[s]}`;a.push({compound:d,penalty:u,level:n}),a.push({compound:`${l}${d}`,penalty:u,level:n})}},"mergeThree"),g=[];for(let o=0;o<e.classList.length;o++)if(t.classFilter(e.classList[o])){const u=`.${CSS.escape(e.classList[o])}`;g.push(u),a.push({compound:u,penalty:t.classPenalty,level:n})}S(g,t.classPenalty);const w=[],_=C(o=>o.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),"safeValue");for(let o=0;o<e.attributes.length;o++){const u=e.attributes[o].name.toLowerCase(),m=`${e.attributes[o].value}`;if(!(u==="id"||u==="class")&&t.attrFilter(u,m)){const y=`[${CSS.escape(u)}${m.length?`="${_(m)}"`:""}]`;w.push(y),a.push({compound:y,penalty:t.attrPenalty,level:n});const P=m.match(/^(\w{2,12})/g);if(P&&P[0].length<m.length){const d=`[${CSS.escape(u)}^="${_(P[0])}"]`;a.push({compound:d,penalty:t.attrMatchPenalty,level:n})}const s=m.match(/(\w{2,12})$/g);if(s&&s[0].length<m.length){const d=`[${CSS.escape(u)}$="${_(s[0])}"]`;a.push({compound:d,penalty:t.attrMatchPenalty,level:n})}}}return S(w,t.attrPenalty),p([...g.slice(0,4),...w.slice(0,4)],Math.min(t.attrPenalty,t.classPenalty)),a},"#path"),R=C(function(e){if(!e.length)return"";let t=e[0],n=t.compound;for(let a=1;a<e.length;a++){const r=(e[a].level??0)-1===t.level;n=`${e[a].compound} ${r?"> ":""}${n}`,t=e[a]}return n},"#selector"),U=C(function(e,t){const n=e.reduce((r,l)=>r+l.compound.length,0),a=t.lengthPenaltyThreshold>0&&n>t.lengthPenaltyThreshold?n/t.lengthPenaltyThreshold:1;return Math.round(1e3*e.reduce((r,l)=>r*l.penalty*1,1)*a)/1e3},"#penalty"),$=C(function(e,t){if(!e.parentNode)return-1;let n=e.parentNode.firstChild;if(!n)return-1;let a=0;for(;n&&(Node.ELEMENT_NODE===n.nodeType&&(typeof t!="string"||n.tagName.toLowerCase()===t)&&a++,n!==e);)n=n.nextSibling;return a},"#indexOf"),N=C(function(e,t,n,a){var r;try{const l=a.querySelectorAll(h(r=c,i,R).call(r,n));return t.fuzziness>=100||t.fuzziness>0&&Math.floor(Math.random()*100)<t.fuzziness?l[0]===e:l.length===1}catch{}return!1},"#matches"),A(c,i),C(c,"Uindow_CSS");let T=c;const Q=T.findOne.bind(T),X=T.findAll.bind(T);0&&(module.exports={findAll,findOne});
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["src/index.ts"],
+  "mappings": "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",
+  "names": ["index_exports", "__export", "findAll", "findOne", "__toCommonJS", "_Uindow_CSS_static", "config_fn", "find_fn", "optimize_fn", "path_fn", "selector_fn", "penalty_fn", "indexOf_fn", "matches_fn", "_Uindow_CSS", "element", "options", "_a", "_b", "_c", "_d", "_e", "_f", "_g", "config", "__privateMethod", "startTime", "root", "shadowRoot", "pathsPerLevel", "candidates", "candidate", "level", "fallbackPath", "path", "current", "tag", "idxOfType", "a", "b", "results", "selectors", "append", "__name", "selector", "extendedMaxResults", "treatRaw", "optimized", "n", "v", "integers", "key", "floats", "curr", "combine", "paths", "counter", "node", "pathList", "index", "shorter", "elementId", "nthIdx", "mergeTwo", "items", "penalty", "end", "i", "j", "mergeThree", "k", "classSelectors", "attrSelectors", "safeValue", "val", "attrName", "attrValue", "startWord", "startSelector", "endWord", "endSelector", "isParent", "length", "acc", "pLength", "filterTag", "child", "domElements", "__privateAdd", "Uindow_CSS", "findOne", "findAll"]
+}

package/index.mjs

@@ -0,0 +1,28 @@
+/**
+ * Uindow's CSS Selector Generator
+ * 
+ * @architect Mark Jivko <mark@uindow.com>
+ * @copyright © 2026 Uindow™ (https://uindow.com)
+ * @license MIT
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files
+ * (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software,
+ * and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+ * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+var G=Object.defineProperty;var O=_=>{throw TypeError(_)};var P=(_,e)=>G(_,"name",{value:e,configurable:!0});var I=(_,e,t)=>e.has(_)||O("Cannot "+t);var v=(_,e,t)=>e.has(_)?O("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(_):e.set(_,t);var h=(_,e,t)=>(I(_,e,"access private method"),t);var i,A,D,N,j,E,U,R,$;const c=class c{static findOne(e,t={}){return(typeof t!="object"||t===null)&&(t={}),c.findAll(e,{...t,maxResults:1})[0]}static findAll(e,t={}){var b,L,o,u,f,S,y;if(Node.ELEMENT_NODE!==e?.nodeType)throw new Error("Cannot generate a CSS selector for this element");if(e.tagName.toLowerCase()==="html")return[{selector:"html",penalty:0}];const n=h(b=c,i,A).call(b,t),a=performance.now(),r=(()=>{const s=e.getRootNode?.();return s?.constructor?.name==="ShadowRoot"?s:Node.DOCUMENT_NODE===n.root.nodeType?n.root:n.root.ownerDocument??n.root})(),l={},m=[];for(const{candidate:s,level:d}of h(L=c,i,D).call(L,e,n,r)){if(performance.now()-a>n.timeout)break;if(typeof l[d]>"u"&&(l[d]=0),!(l[d]>=n.maxPathsPerLevel)&&h(o=c,i,$).call(o,e,n,s,r)&&(m.push({path:s,penalty:h(u=c,i,U).call(u,s,n)}),l[d]++,m.length>=n.maxPathsTotal))break}if(m.length===0){const s=(()=>{var F,k;const d=[];let M=0,x=e;for(;x&&x!==r;){const z=x.tagName.toLowerCase(),H=h(F=c,i,R).call(F,x,z);if(H===-1)return[];d.push({compound:`${z}:nth-of-type(${H})`,penalty:n.nthOfTypePenalty,level:M}),x=x.parentElement,M++}return h(k=c,i,$).call(k,e,n,d,r)?d:[]})();if(!s.length)throw new Error("No fallback CSS selector was not found");return[{selector:h(f=c,i,E).call(f,s),penalty:h(S=c,i,U).call(S,s,n)}]}m.sort((s,d)=>s.penalty-d.penalty);const C=[],p=new Set,g=P(s=>{var M,x;const d=h(M=c,i,E).call(M,s);!d||p.has(d)||(p.add(d),C.push({selector:d,penalty:h(x=c,i,U).call(x,s,n)}))},"append"),w=n.maxResults*Math.round(1+n.effort/100*49);t:for(const{path:s}of m){for(const d of h(y=c,i,N).call(y,s,e,n,r))if(g(d),C.length>=w)break t;g(s)}return C.sort((s,d)=>s.penalty-d.penalty),C.slice(0,n.maxResults)}};i=new WeakSet,A=P(function(e={}){(typeof e!="object"||e===null)&&(e={});const t={};t.root=e.root instanceof HTMLElement?e.root:document.documentElement,t.idFilter=typeof e.idFilter=="function"?e.idFilter:()=>!0,t.tagFilter=typeof e.tagFilter=="function"?e.tagFilter:()=>!0,t.classFilter=typeof e.classFilter=="function"?e.classFilter:r=>!r.match(/^(is-|has-|js-|css-)/),t.attrFilter=typeof e.attrFilter=="function"?e.attrFilter:(r,l)=>!/(?:width|height|style)$/i.test(r)&&l.length<=32&&!/^(?:\w+:)?\/\/?/i.test(l);const n={lengthPenaltyThreshold:32,maxCandidatesPerLevel:2500,maxPathsPerLevel:50,maxPathsTotal:1e3,maxResults:25,fuzziness:0,effort:50,timeout:1500};for(const r of Object.keys(n))t[r]=Number.isInteger(e[r])?Math.abs(e[r]):n[r];t.fuzziness>100&&(t.fuzziness=100),t.effort>100&&(t.effort=100),t.lengthPenaltyThreshold<1&&(t.lengthPenaltyThreshold=1),t.maxResults<1&&(t.maxResults=1),t.maxPathsTotal<t.maxResults&&(t.maxPathsTotal=t.maxResults),t.maxPathsPerLevel<t.maxResults&&(t.maxPathsPerLevel=t.maxResults),t.maxCandidatesPerLevel<t.maxPathsPerLevel&&(t.maxCandidatesPerLevel=t.maxPathsPerLevel);const a={idPenalty:1,tagPenalty:1.1,classPenalty:1.3,attrPenalty:1.25,attrMatchPenalty:1.2,nthOfTypePenalty:3,nthChildPenalty:6};for(const r of Object.keys(a))t[r]=Number.isFinite(e[r])?Math.abs(e[r]):a[r];return t},"#config"),D=P(function*(e,t,n){var C;let a=e,r=0;function*l(p,g=[],w={count:0}){if(!(w.count>=t.maxCandidatesPerLevel)){if(!p.length){w.count++,yield g;return}for(const b of p[0]){if(w.count>=t.maxCandidatesPerLevel)return;yield*l(p.slice(1),g.concat(b),w)}}}P(l,"combine");const m=[];for(;a&&a!==n;){m.push(h(C=c,i,j).call(C,a,t,r));const p=[...l(m)];p.sort((g,w)=>{var b,L;return h(b=c,i,U).call(b,g,t)-h(L=c,i,U).call(L,w,t)});for(const g of p)yield{candidate:g,level:r};a=a.parentElement,r++}},"#find"),N=P(function*(e,t,n,a){var r,l;if(!(e.length<=2))for(let m=1;m<e.length-1;m++){const C=[...e];C.splice(m,1),h(r=c,i,$).call(r,t,n,C,a)&&(yield*h(l=c,i,N).call(l,C,t,n,a),yield C)}},"#optimize"),j=P(function(e,t,n=0){var b,L;const a=[],r=e.getAttribute("id");r&&t.idFilter(r)&&a.push({compound:"#"+CSS.escape(r),penalty:t.idPenalty,level:n});const l=e.tagName.toLowerCase();if(t.tagFilter(l)){a.push({compound:l,penalty:t.tagPenalty,level:n});const o=h(b=c,i,R).call(b,e,l);o!==-1&&a.push({compound:`${l}:nth-of-type(${o})`,penalty:t.nthOfTypePenalty,level:n});const u=h(L=c,i,R).call(L,e);u!==-1&&a.push({compound:`:nth-child(${u})`,penalty:t.nthChildPenalty,level:n})}const m=P((o,u)=>{if(!Array.isArray(o)||o.length<2||!Number.isFinite(u))return;const f=Math.min(8,o.length);for(let S=0;S<f;S++){a.push({compound:`${l}${o[S]}`,penalty:u,level:n});for(let y=S+1;y<f;y++){const s=`${o[S]}${o[y]}`;a.push({compound:s,penalty:u,level:n}),a.push({compound:`${l}${s}`,penalty:u,level:n})}}},"mergeTwo"),C=P((o,u)=>{if(!Array.isArray(o)||o.length<3||!Number.isFinite(u))return;const f=Math.min(8,o.length);for(let S=0;S<f;S++)for(let y=S+1;y<f;y++)for(let s=y+1;s<f;s++){const d=`${o[S]}${o[y]}${o[s]}`;a.push({compound:d,penalty:u,level:n}),a.push({compound:`${l}${d}`,penalty:u,level:n})}},"mergeThree"),p=[];for(let o=0;o<e.classList.length;o++)if(t.classFilter(e.classList[o])){const u=`.${CSS.escape(e.classList[o])}`;p.push(u),a.push({compound:u,penalty:t.classPenalty,level:n})}m(p,t.classPenalty);const g=[],w=P(o=>o.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),"safeValue");for(let o=0;o<e.attributes.length;o++){const u=e.attributes[o].name.toLowerCase(),f=`${e.attributes[o].value}`;if(!(u==="id"||u==="class")&&t.attrFilter(u,f)){const S=`[${CSS.escape(u)}${f.length?`="${w(f)}"`:""}]`;g.push(S),a.push({compound:S,penalty:t.attrPenalty,level:n});const y=f.match(/^(\w{2,12})/g);if(y&&y[0].length<f.length){const d=`[${CSS.escape(u)}^="${w(y[0])}"]`;a.push({compound:d,penalty:t.attrMatchPenalty,level:n})}const s=f.match(/(\w{2,12})$/g);if(s&&s[0].length<f.length){const d=`[${CSS.escape(u)}$="${w(s[0])}"]`;a.push({compound:d,penalty:t.attrMatchPenalty,level:n})}}}return m(g,t.attrPenalty),C([...p.slice(0,4),...g.slice(0,4)],Math.min(t.attrPenalty,t.classPenalty)),a},"#path"),E=P(function(e){if(!e.length)return"";let t=e[0],n=t.compound;for(let a=1;a<e.length;a++){const r=(e[a].level??0)-1===t.level;n=`${e[a].compound} ${r?"> ":""}${n}`,t=e[a]}return n},"#selector"),U=P(function(e,t){const n=e.reduce((r,l)=>r+l.compound.length,0),a=t.lengthPenaltyThreshold>0&&n>t.lengthPenaltyThreshold?n/t.lengthPenaltyThreshold:1;return Math.round(1e3*e.reduce((r,l)=>r*l.penalty*1,1)*a)/1e3},"#penalty"),R=P(function(e,t){if(!e.parentNode)return-1;let n=e.parentNode.firstChild;if(!n)return-1;let a=0;for(;n&&(Node.ELEMENT_NODE===n.nodeType&&(typeof t!="string"||n.tagName.toLowerCase()===t)&&a++,n!==e);)n=n.nextSibling;return a},"#indexOf"),$=P(function(e,t,n,a){var r;try{const l=a.querySelectorAll(h(r=c,i,E).call(r,n));return t.fuzziness>=100||t.fuzziness>0&&Math.floor(Math.random()*100)<t.fuzziness?l[0]===e:l.length===1}catch{}return!1},"#matches"),v(c,i),P(c,"Uindow_CSS");let T=c;const W=T.findOne.bind(T),q=T.findAll.bind(T);export{q as findAll,W as findOne};
+//# sourceMappingURL=index.mjs.map

package/index.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["src/index.ts"],
+  "mappings": "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",
+  "names": ["_Uindow_CSS_static", "config_fn", "find_fn", "optimize_fn", "path_fn", "selector_fn", "penalty_fn", "indexOf_fn", "matches_fn", "_Uindow_CSS", "element", "options", "_a", "_b", "_c", "_d", "_e", "_f", "_g", "config", "__privateMethod", "startTime", "root", "shadowRoot", "pathsPerLevel", "candidates", "candidate", "level", "fallbackPath", "path", "current", "tag", "idxOfType", "a", "b", "results", "selectors", "append", "__name", "selector", "extendedMaxResults", "treatRaw", "optimized", "n", "v", "integers", "key", "floats", "curr", "combine", "paths", "counter", "node", "pathList", "index", "shorter", "elementId", "nthIdx", "mergeTwo", "items", "penalty", "end", "i", "j", "mergeThree", "k", "classSelectors", "attrSelectors", "safeValue", "val", "attrName", "attrValue", "startWord", "startSelector", "endWord", "endSelector", "isParent", "length", "acc", "pLength", "filterTag", "child", "domElements", "__privateAdd", "Uindow_CSS", "findOne", "findAll"]
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@uindow/css",
+	"version": "1.0.1",
+	"description": "CSS Selector Generator",
+	"main": "index.js",
+	"module": "index.mjs",
+	"types": "types/index.d.ts",
+	"exports": {
+		".": {
+			"require": "./index.js",
+			"import": "./index.mjs"
+		}
+	},
+	"files": [
+		"index.js",
+		"index.js.map",
+		"index.mjs",
+		"index.mjs.map",
+		"types/index.d.ts"
+	],
+	"license": "MIT",
+	"author": "Mark Jivko <mark@uindow.com> (https://uindow.com)",
+	"homepage": "https://uindow.com",
+	"keywords": [
+		"css",
+		"uindow",
+		"selector",
+		"generator",
+		"css-selector",
+		"dom-selector",
+		"css-selector-generator",
+		"dom-selector-generator"
+	],
+	"scripts": {
+		"format": "prettier --write \"**/*.{js,cjs,ts}\"",
+		"lint": "eslint --fix --cache \"src/**/*.ts\"",
+		"build": "npm run lint && tsc && npm run format && node ./tools/build.cjs"
+	},
+	"devDependencies": {
+		"@typescript-eslint/eslint-plugin": "8.60.0",
+		"esbuild": "0.25.9",
+		"eslint": "8.57.1",
+		"eslint-config-prettier": "8.10.0",
+		"eslint-plugin-prettier": "4.2.1",
+		"prettier": "2.8.8",
+		"typescript": "6.0.3"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/uindow/css.git"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/types/index.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Uindow's CSS Selector Generator
+ *
+ * @architect Mark Jivko <mark@uindow.com>
+ * @copyright © 2026-present Uindow™ (https://uindow.com)
+ * @license MIT
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files
+ * (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge,
+ * publish, distribute, sublicense, and/or sell copies of the Software,
+ * and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+ * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/**
+ * Configuration options for the CSS selector generator
+ */
+export interface Uindow_CSS_Config {
+	/**
+	 * The root element to search from. Selectors will be built relative to this
+	 * element; nothing above it will appear in any generated selector.
+	 *
+	 * @default document.documentElement
+	 */
+	root: HTMLElement | Document;
+	/**
+	 * Function that decides whether an HTML ID attribute may be used in a selector.
+	 * Defaults to allowing all IDs.
+	 */
+	idFilter: (name: string) => boolean;
+	/**
+	 * Penalty applied to id selectors.
+	 * Example: `#id`
+	 *
+	 * A lower value tends to yield more ID-based CSS selectors.
+	 *
+	 * @default 1
+	 */
+	idPenalty: number;
+	/**
+	 * Function that decides whether an HTML tag name may be used in a selector.
+	 * Defaults to allowing all tags.
+	 */
+	tagFilter: (name: string) => boolean;
+	/**
+	 * Penalty applied to tag selectors.
+	 * Example: `div`
+	 *
+	 * A lower value tends to yield more tag-based CSS selectors.
+	 *
+	 * @default 1.1
+	 */
+	tagPenalty: number;
+	/**
+	 * Function that decides whether a CSS class name may be used in a selector.
+	 * Defaults to disallowing `is-*|has-*|js-*|css-*` classes.
+	 */
+	classFilter: (name: string) => boolean;
+	/**
+	 * Penalty applied to class name selectors.
+	 * Example: `.button`
+	 *
+	 * A lower value tends to yield more class-based CSS selectors.
+	 *
+	 * @default 1.3
+	 */
+	classPenalty: number;
+	/**
+	 * Function that decides whether an attribute `(name, value)` pair may be used
+	 * in a selector. Defaults to allowing any attribute except `*style|*width|*height`
+	 * that is shorter than 32 characters, and not a URL.
+	 */
+	attrFilter: (name: string, value: string) => boolean;
+	/**
+	 * Penalty applied to attribute selectors.
+	 * Example: `[name]`, `[value="1"]`
+	 *
+	 * A lower value tends to yield more attribute-based CSS selectors.
+	 *
+	 * @default 1.25
+	 */
+	attrPenalty: number;
+	/**
+	 * Penalty applied to prefix-matched and suffix-matched attribute selectors.
+	 * Example prefix-matched attribute selector: `[name^="a"]`
+	 * Example suffix-matched attribute selector: `[name$="z"]`
+	 *
+	 * A lower value tends to yield more CSS selectors that contain
+	 * prefix-matched and suffix-matched attribute selectors.
+	 *
+	 * @default 1.2
+	 */
+	attrMatchPenalty: number;
+	/**
+	 * Penalty applied to nth-of-type selectors.
+	 * Example: `div:nth-of-type(1)`
+	 *
+	 * A lower value tends to yield more nth-of-type CSS selectors.
+	 *
+	 * @default 3
+	 */
+	nthOfTypePenalty: number;
+	/**
+	 * Penalty applied to nth-child selectors.
+	 * Example: `:nth-child(1)`
+	 *
+	 * A lower value tends to yield more nth-child CSS selectors.
+	 *
+	 * @default 6
+	 */
+	nthChildPenalty: number;
+	/**
+	 * Apply a penalty to CSS selectors whose length exceeds this number of characters.
+	 *
+	 * A lower value tends to yield shorter CSS selectors.
+	 * Must be greater than or equal to 1.
+	 *
+	 * @default 32
+	 */
+	lengthPenaltyThreshold: number;
+	/**
+	 * Hard cap on the number of candidates yielded per level.
+	 * Useful for very deep or very wide DOMs where the search space is large.
+	 *
+	 * Must be greater than or equal to `maxPathsPerLevel`.
+	 *
+	 * @default 2500
+	 */
+	maxCandidatesPerLevel: number;
+	/**
+	 * Hard cap on the number of unique paths yielded per level.
+	 * Useful for very deep or very wide DOMs where the search space is large.
+	 *
+	 * Must be greater than or equal to `maxResults`.
+	 *
+	 * @default 50
+	 */
+	maxPathsPerLevel: number;
+	/**
+	 * Hard cap on the number of unique paths yielded in total.
+	 * Useful for very deep or very wide DOMs where the search space is large.
+	 *
+	 * Must be greater than or equal to `maxResults`.
+	 *
+	 * @default 1000
+	 */
+	maxPathsTotal: number;
+	/**
+	 * Maximum number of optimized selectors to return, sorted by increasing penalty.
+	 *
+	 * Must be greater than or equal to 1.
+	 *
+	 * @default 25
+	 */
+	maxResults: number;
+	/**
+	 * Trade exclusivity for shorter selectors.
+	 * Fuzziness defines the percentage of CSS selectors that match the target element first,
+	 * while potentially also matching additional elements on the page.
+	 * Set to `0` to ensure CSS selectors match the target element exclusively.
+	 * Must be a positive integer between `0` and `100`.
+	 *
+	 * A higher value tends to yield shorter CSS selectors.
+	 *
+	 * @default 0
+	 */
+	fuzziness: number;
+	/**
+	 * Trade processing time for shorter selectors.
+	 * Spend more time optimizing candidate selectors for shorter and more desirable paths.
+	 * Must be a positive integer between `0` and `100`.
+	 *
+	 * A higher value tends to yield shorter CSS selectors at the cost of extra processing time.
+	 *
+	 * @default 50
+	 */
+	effort: number;
+	/**
+	 * Maximum time in milliseconds to spend searching before giving up and
+	 * returning however many results have been found so far, or the nth-of-type fallback
+	 * if none were found.
+	 *
+	 * An small additional delay will be incurred after the search, during the
+	 * CSS path optimization phase.
+	 *
+	 * @default 1500
+	 */
+	timeout: number;
+}
+/**
+ * CSS selector result
+ */
+export interface Uindow_CSS_Result {
+	/**
+	 * Optimized CSS selector
+	 */
+	selector: string;
+	/**
+	 * CSS selector penalty (the lower, the better)
+	 */
+	penalty: number;
+}
+export declare const findOne: (element: HTMLElement, options?: Partial<Uindow_CSS_Config>) => Uindow_CSS_Result;
+export declare const findAll: (element: HTMLElement, options?: Partial<Uindow_CSS_Config>) => Uindow_CSS_Result[];