pantoken / packages/utils/src / makeResolver

دالة: makeResolver()

makeResolver(base, options?): (value) => string

بيتا

بناء محلل (resolver) يوسّع المراجع var(--x) إلى قيم نهائية ملموسة مقابل base (بالإضافة إلى أي overrides). مع mode يقوم بطي light-dark() إلى ذلك الفرع؛ وبدونها، يترك light-dark() كما هو.

المعلمات

base

قراءة فقط Token[]

مجموعة الرموز التي تُستخدم لحل المراجع مقابلها.

options?

ResolveOptions = {}

ResolveOptions.

القيم المرجعة

دالة تقوم بحل سلسلة قيمة.

(value) => string

أمثلة

وسّع سلسلة المراجع إلى قيمتها النهائية الملموسة

import { makeResolver } from "@pantoken/utils";
import type { Token } from "@pantoken/model";

const ir: Token[] = [
  { name: "--instui-leaf", syntax: "<color>", inherits: true, value: "#0374B5" },
  { name: "--instui-brand", syntax: "*", inherits: true, value: "var(--instui-leaf)" },
];

const resolve = makeResolver(ir);
resolve("var(--instui-brand)"); // → "#0374B5"

اطوِ light-dark() باستخدام وضعية، أو اتركها بدون واحدة

import { makeResolver } from "@pantoken/utils";
import type { Token } from "@pantoken/model";

const ir: Token[] = [
  { name: "--instui-bg", syntax: "*", inherits: true, value: "light-dark(#fff, #000)" },
];

makeResolver(ir)("var(--instui-bg)");                 // → "light-dark(#fff, #000)"
makeResolver(ir, { mode: "light" })("var(--instui-bg)"); // → "#fff"
makeResolver(ir, { mode: "dark" })("var(--instui-bg)");  // → "#000"

طبّق تجاوزات طبقية تتفوق عند تصادم الأسماء

import { makeResolver } from "@pantoken/utils";
import type { Token } from "@pantoken/model";

const ir: Token[] = [
  { name: "--instui-leaf", syntax: "<color>", inherits: true, value: "#0374B5" },
  { name: "--instui-brand", syntax: "*", inherits: true, value: "var(--instui-leaf)" },
];
const overrides: Token[] = [
  { name: "--instui-leaf", syntax: "<color>", inherits: true, value: "#000" },
];

makeResolver(ir, { overrides })("var(--instui-brand)"); // → "#000"