الإضافات

يمد ملحق pantoken مخرجات الرموز أو CSS بدون تفرع حزمة. تُبنى واحدة باستخدام definePlugin من @pantoken/plugin-kit، ثم تُمرر إلى buildTokens أو toCss.

تأليف ملحق

زوّد definePlugin بالخطافات (hooks) التي تنفذها. يُرجع ملحقًا عاديًا، معوّماً بالقدرات المستدلّة من تلك الخطافات. يمكن للملحق توسيع تمثيل IR (tokens, icons), مخرجات CSS (css), أو كليهما.

import { definePlugin } from "@pantoken/plugin-kit";

export const brand = () =>
  definePlugin({
    name: "@acme/brand",
    tokens: (ctx) => [...ctx.tokens /* add records */],
    css: () => ({ append: ":root { /* … */ }" }),
  });

التسجيل الواعي بالقدرات

تشغّل buildTokens و toCss checkPlugins على الإضافات التي تمررها. يعطي تحذيرًا — لا يرمي خطأ — عندما لا يحتوي الملحق على خطاف مطابق للمرحلة التي تم تسجيله فيها، لذلك يتم تخطي ملحق مخصص للرموز فقط مرّر إلى toCss مع ملاحظة بدلًا من أن يفعل لا شيء بصمت.

تركيب الإضافات

ابنِ فوق ملحق آخر باستخدام extendPlugin، أو ادمج الأقران باستخدام mergePlugin:

import { extendPlugin, mergePlugin } from "@pantoken/plugin-kit";

const themed = extendPlugin(brand(), { css: () => ({ append: "/* extra */" }) });
const both = mergePlugin(brand(), icons());

تتألف الخطافات في نفس المرحلة: يشغّل tokens الأساسي ثم الإضافة، يدمج css المساهمتين، و icons يشغّل كليهما.

التحقق من مخرجات الملحق

شغّل فحوصات الانحراف المشتركة من @pantoken/utils على مخرجات ملحقك في اختباره، حتى يفشل الإملاء الخاطئ أو إعادة تسمية رمز بسرعة ومحليًا:

import { danglingReferences, unknownReferences } from "@pantoken/utils";
import { tokens } from "@pantoken/tokens";

// A self-contained contribution defines what it references, so nothing should dangle.
expect(danglingReferences(myPlugin().css!({ tokens, css: "" }).append ?? "")).toEqual([]);

// A contribution that only references tokens defined elsewhere: every target must be a real token.
expect(unknownReferences(myBridgeCss, tokens)).toEqual([]);