jskelet 0.6.4 → 0.6.6

package/src/server/og-raster.mjs

@@ -0,0 +1,21 @@
+/**
+ * Yüzlü OG PNG'si.
+ *
+ * fontconfig `FONTCONFIG_FILE`'ı süreç açılırken okur. Üst süreçte sonradan
+ * atanan ortam değişkeni (özellikle Windows CRT `getenv`) görünmez; bu yüzden
+ * çizim, dosyayı baştan gören bu süreçte yapılır.
+ */
+const sharpMod = await import(process.env.JSKELET_SHARP);
+const sharp = sharpMod.default ?? sharpMod;
+
+/** @type {Buffer[]} */
+const chunks = [];
+for await (const chunk of process.stdin) chunks.push(chunk);
+
+const width = Number(process.env.JSKELET_OG_WIDTH);
+const height = Number(process.env.JSKELET_OG_HEIGHT);
+const body = await sharp(Buffer.concat(chunks))
+  .resize(width, height, { fit: "fill" })
+  .png()
+  .toBuffer();
+process.stdout.write(body);

package/types/config/defaults.d.ts

@@ -420,6 +420,30 @@ export declare const DEFAULT_SECURITY: {
         headerName: string;
     };
 };
+/**
+ * Client bundle (esbuild) ayarları.
+ *
+ * `groups` / `chunkGroup` esbuild'in native manualChunks'ı olmadığı için
+ * framework plugin'i ile uygulanır — ayrıntı `src/build/chunk-groups.mjs`.
+ */
+export declare const DEFAULT_BUILD: {
+    client: {
+        /** esbuild `splitting`; kapalıyken gruplama yok sayılır. */
+        splitting: boolean;
+        /**
+         * İsim → matcher listesi. Bare paket (`chart.js`), yol öneki
+         * (`./client/chrome/`) veya `@/` öneki.
+         * @type {Record<string, string[]>}
+         */
+        groups: Record<string, string[]>;
+        /**
+         * Modül kimliğini (mutlak yol veya bare specifier) grup adına map eder.
+         * `groups` ile çakışınca hook kazanır.
+         * @type {((id: string) => string | null | undefined) | null}
+         */
+        chunkGroup: ((id: string) => string | null | undefined) | null;
+    };
+};
 /**
  * Build-zamanı görsel adımı + opsiyonel runtime uzak görsel proxy.
  *

package/types/config/index.d.ts

@@ -220,6 +220,18 @@ export type ResolvedConfig = {
      * Client bundle'a gömülecek env anahtarları.
      */
     clientEnv: string[];
+    /**
+     * Client bundling (esbuild splitting / chunk groups).
+     */
+    build: BuildConfig;
+};
+export type BuildClientConfig = {
+    splitting: boolean;
+    groups: Record<string, string[]>;
+    chunkGroup: ((id: string) => string | null | undefined) | null;
+};
+export type BuildConfig = {
+    client: BuildClientConfig;
 };
 export type ImagesRemoteConfig = {
     enabled: boolean;
@@ -279,6 +291,13 @@ export type SecurityConfig = {
         headerName: string;
     };
 };
+/**
+ * Client build ayarları (`build.client`). Bozuk tipler uyarıyla varsayılana düşer.
+ *
+ * @param {unknown} raw
+ * @returns {BuildConfig}
+ */
+export declare function normalizeBuild(raw: unknown): BuildConfig;
 /**
  * Config'i okur, normalize eder ve modül durumuna yazar. Sunucu ve build
  * süreçleri açılışta bir kez çağırır.

package/types/server/og-image.d.ts

@@ -24,12 +24,31 @@ export type OgCardOptions = {
      */
     accent?: string;
 };
+export type OgFontFace = {
+    /**
+     * Font dosyası. PNG için `ttf` veya `otf`
+     * (librsvg `woff` / `woff2` dosyasından kare basar). Uygulama köküne
+     * göreli ya da mutlak.
+     */
+    path: string;
+    /**
+     * SVG `font-family` adı. Dosyanın içindeki adla
+     * aynı olmak zorunda değil.
+     */
+    family: string;
+    /**
+     * Tek ağırlık (`700`) ya da aralık (`"100 900"`).
+     */
+    weight?: number | string;
+    style?: 'normal' | 'italic' | 'oblique';
+};
 export type OgImageOptions = OgCardOptions & {
     svg?: string;
     width?: number;
     height?: number;
     format?: 'png' | 'svg';
     cacheControl?: string;
+    fonts?: OgFontFace[];
 };
 export type OgImageResult = {
     body: Buffer;
@@ -47,6 +66,19 @@ export type OgImageResult = {
  * @property {string} [mutedColor] Açıklama / site adı
  * @property {string} [accent] Sol şerit rengi
  */
+/**
+ * OG metnine gömülen yüz. `path` + `family` yeter. PNG, dosyanın içindeki
+ * ağırlığı kullanır; `weight` yalnızca SVG yanıtındaki `@font-face` içindir.
+ *
+ * @typedef {object} OgFontFace
+ * @property {string} path Font dosyası. PNG için `ttf` veya `otf`
+ *   (librsvg `woff` / `woff2` dosyasından kare basar). Uygulama köküne
+ *   göreli ya da mutlak.
+ * @property {string} family SVG `font-family` adı. Dosyanın içindeki adla
+ *   aynı olmak zorunda değil.
+ * @property {number | string} [weight] Tek ağırlık (`700`) ya da aralık (`"100 900"`).
+ * @property {'normal' | 'italic' | 'oblique'} [style]
+ */
 /**
  * @typedef {OgCardOptions & {
  *   svg?: string,
@@ -54,6 +86,7 @@ export type OgImageResult = {
  *   height?: number,
  *   format?: 'png' | 'svg',
  *   cacheControl?: string,
+ *   fonts?: OgFontFace[],
  * }} OgImageOptions
  */
 /**
@@ -79,15 +112,23 @@ export declare function escapeXml(value: unknown): string;
 export declare function wrapText(text: string, maxChars: number, maxLines: number): string[];
 /**
  * Hazır kart SVG'si. Uygulama kendi SVG'sini vermek isterse `svg` kullanır.
- * @param {OgCardOptions & { width?: number, height?: number }} options
+ * @param {OgCardOptions & { width?: number, height?: number, fontFamily?: string }} options
  * @returns {string}
  */
 export declare function buildOgSvg(options?: OgCardOptions & {
     width?: number;
     height?: number;
+    fontFamily?: string;
 }): string;
 /**
  * SVG veya kart alanlarından PNG/SVG gövde üretir.
+ *
+ * PNG'de `ttf` / `otf` fontconfig'e eklenir ve kart bu `family` adlarını
+ * kullanır. `woff` / `woff2` yalnızca sharp yokken (ya da `format: "svg"`)
+ * `@font-face` olarak gömülür; librsvg onlardan kare basar. Dosya okunamazsa
+ * görsel yine üretilir, o yüz atlanır. Çalışma imajında `fontconfig` paketi
+ * gerekir.
+ *
  * @param {OgImageOptions} [options]
  * @returns {Promise<OgImageResult>}
  */
@@ -135,10 +176,12 @@ export declare function ogHandler(factory: (ctx: {
 export declare class ImageResponse {
     #private;
     /**
-     * @param {string | OgCardOptions} element
+     * @param {string | (OgCardOptions & { fonts?: OgFontFace[] })} element
      * @param {Omit<OgImageOptions, keyof OgCardOptions | 'svg'> & { width?: number, height?: number }} [init]
      */
-    constructor(element: string | OgCardOptions, init?: Omit<OgImageOptions, keyof OgCardOptions | 'svg'> & {
+    constructor(element: string | (OgCardOptions & {
+        fonts?: OgFontFace[];
+    }), init?: Omit<OgImageOptions, keyof OgCardOptions | 'svg'> & {
         width?: number;
         height?: number;
     });