pantoken-root / packages/core/src / modifyExpression

ฟังก์ชัน: modifyExpression() ​

modifyExpression(base, modify): string

เบต้า

The CSS-expression form of applyModify: ค่าการคำนวณเหมือนกัน แต่ถูกนำไปใช้กับ base ขณะทาสี แทนที่จะเป็นค่าสีแบบเฮ็กซ์ในเวลาสร้าง (build time), ดังนั้นต้นกำเนิด var(--instui-…) จะยังคงอยู่ในสไตล์ชีต และยังคงติดตามสิ่งที่โทเค็นนั้นแก้ได้ (รวมถึงคู่ light-dark() และการชี้จุดใหม่ของ primitive ที่มันสืบทอดมาในเวลารันไทม์)).

Relative colour syntax resolves l บนสเกล 0–100 ทั้งใน hsl() และ lch(), และช่องแชนเนลแอลฟาที่ถูกละไว้จะสืบทอดค่าจากต้นกำเนิด — สอดคล้องกับการส่งผ่านค่าแอลฟาของ applyModify.

พารามิเตอร์ ​

base ​

string

สีพื้นฐาน (ค่าตรง, var(--token), หรือผลลัพธ์จาก helper ที่ซ้อนกัน).

modify ​

TokenModify

พื้นที่สีที่ตัวปรับทำงานอยู่ (เช่น "hsl").

คืนค่า ​

string

นิพจน์ color-mix().

ตัวอย่าง ​

ts
import { modifyExpression } from "@pantoken/core";

modifyExpression("var(--x)", { type: "alpha", value: 0.2, space: "hsl" });
// → "color-mix(in srgb, var(--x) 20%, transparent)"
modifyExpression("var(--x)", { type: "darken", value: 0.1, space: "hsl" });
// → "hsl(from var(--x) h s calc(l * 0.9))"
modifyExpression("var(--x)", { type: "lighten", value: 0.1, space: "hsl" });
// → "hsl(from var(--x) h s calc(l + (100 - l) * 0.1))"