hugoWebsite/node_modules/tailwindcss/lib/lib/offsets.js
Jeremy Nusser 0ab675d92b Initial commit... 🎉🎉🎉
2022-10-28 17:20:35 -05:00

217 lines
7 KiB
JavaScript

// @ts-check
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
Object.defineProperty(exports, "Offsets", {
enumerable: true,
get: ()=>Offsets
});
const _bigSign = /*#__PURE__*/ _interopRequireDefault(require("../util/bigSign"));
function _interopRequireDefault(obj) {
return obj && obj.__esModule ? obj : {
default: obj
};
}
class Offsets {
constructor(){
/**
* Offsets for the next rule in a given layer
*
* @type {Record<Layer, bigint>}
*/ this.offsets = {
defaults: 0n,
base: 0n,
components: 0n,
utilities: 0n,
variants: 0n,
user: 0n
};
/**
* Positions for a given layer
*
* @type {Record<Layer, bigint>}
*/ this.layerPositions = {
defaults: 0n,
base: 1n,
components: 2n,
utilities: 3n,
// There isn't technically a "user" layer, but we need to give it a position
// Because it's used for ordering user-css from @apply
user: 4n,
variants: 5n
};
/**
* The total number of functions currently registered across all variants (including arbitrary variants)
*
* @type {bigint}
*/ this.reservedVariantBits = 0n;
/**
* Positions for a given variant
*
* @type {Map<string, bigint>}
*/ this.variantOffsets = new Map();
}
/**
* @param {Layer} layer
* @returns {RuleOffset}
*/ create(layer) {
return {
layer,
parentLayer: layer,
arbitrary: 0n,
variants: 0n,
parallelIndex: 0n,
index: this.offsets[layer]++,
options: []
};
}
/**
* @returns {RuleOffset}
*/ arbitraryProperty() {
return {
...this.create("utilities"),
arbitrary: 1n
};
}
/**
* Get the offset for a variant
*
* @param {string} variant
* @param {number} index
* @returns {RuleOffset}
*/ forVariant(variant, index = 0) {
let offset = this.variantOffsets.get(variant);
if (offset === undefined) {
throw new Error(`Cannot find offset for unknown variant ${variant}`);
}
return {
...this.create("variants"),
variants: offset << BigInt(index)
};
}
/**
* @param {RuleOffset} rule
* @param {RuleOffset} variant
* @param {VariantOption} options
* @returns {RuleOffset}
*/ applyVariantOffset(rule, variant, options) {
return {
...rule,
layer: "variants",
parentLayer: rule.layer === "variants" ? rule.parentLayer : rule.layer,
variants: rule.variants | variant.variants,
options: options.sort ? [].concat(options, rule.options) : rule.options,
// TODO: Technically this is wrong. We should be handling parallel index on a per variant basis.
// We'll take the max of all the parallel indexes for now.
// @ts-ignore
parallelIndex: max([
rule.parallelIndex,
variant.parallelIndex
])
};
}
/**
* @param {RuleOffset} offset
* @param {number} parallelIndex
* @returns {RuleOffset}
*/ applyParallelOffset(offset, parallelIndex) {
return {
...offset,
parallelIndex: BigInt(parallelIndex)
};
}
/**
* Each variant gets 1 bit per function / rule registered.
* This is because multiple variants can be applied to a single rule and we need to know which ones are present and which ones are not.
* Additionally, every unique group of variants is grouped together in the stylesheet.
*
* This grouping is order-independent. For instance, we do not differentiate between `hover:focus` and `focus:hover`.
*
* @param {string[]} variants
* @param {(name: string) => number} getLength
*/ recordVariants(variants, getLength) {
for (let variant of variants){
this.recordVariant(variant, getLength(variant));
}
}
/**
* The same as `recordVariants` but for a single arbitrary variant at runtime.
* @param {string} variant
* @param {number} fnCount
*
* @returns {RuleOffset} The highest offset for this variant
*/ recordVariant(variant, fnCount = 1) {
this.variantOffsets.set(variant, 1n << this.reservedVariantBits);
// Ensure space is reserved for each "function" in the parallel variant
// by offsetting the next variant by the number of parallel variants
// in the one we just added.
// Single functions that return parallel variants are NOT handled separately here
// They're offset by 1 (or the number of functions) as usual
// And each rule returned is tracked separately since the functions are evaluated lazily.
// @see `RuleOffset.parallelIndex`
this.reservedVariantBits += BigInt(fnCount);
return {
...this.create("variants"),
variants: 1n << this.reservedVariantBits
};
}
/**
* @param {RuleOffset} a
* @param {RuleOffset} b
* @returns {bigint}
*/ compare(a, b) {
// Sort layers together
if (a.layer !== b.layer) {
return this.layerPositions[a.layer] - this.layerPositions[b.layer];
}
// Sort based on the sorting function
for (let aOptions of a.options){
for (let bOptions of b.options){
if (aOptions.id !== bOptions.id) continue;
if (!aOptions.sort || !bOptions.sort) continue;
let result = aOptions.sort({
value: aOptions.value,
modifier: aOptions.modifier
}, {
value: bOptions.value,
modifier: bOptions.modifier
});
if (result !== 0) return result;
}
}
// Sort variants in the order they were registered
if (a.variants !== b.variants) {
return a.variants - b.variants;
}
// Make sure each rule returned by a parallel variant is sorted in ascending order
if (a.parallelIndex !== b.parallelIndex) {
return a.parallelIndex - b.parallelIndex;
}
// Always sort arbitrary properties after other utilities
if (a.arbitrary !== b.arbitrary) {
return a.arbitrary - b.arbitrary;
}
// Sort utilities, components, etc… in the order they were registered
return a.index - b.index;
}
/**
* @template T
* @param {[RuleOffset, T][]} list
* @returns {[RuleOffset, T][]}
*/ sort(list) {
return list.sort(([a], [b])=>(0, _bigSign.default)(this.compare(a, b)));
}
}
/**
*
* @param {bigint[]} nums
* @returns {bigint|null}
*/ function max(nums) {
let max = null;
for (const num of nums){
max = max !== null && max !== void 0 ? max : num;
max = max > num ? max : num;
}
return max;
}