nextjs-cms 0.9.40 → 0.9.42

package/dist/core/helpers/watermark.d.ts

@@ -0,0 +1,96 @@
+import * as z from 'zod';
+export declare const watermarkPositionEnum: z.ZodEnum<{
+    "top-left": "top-left";
+    top: "top";
+    "top-right": "top-right";
+    left: "left";
+    center: "center";
+    right: "right";
+    "bottom-left": "bottom-left";
+    bottom: "bottom";
+    "bottom-right": "bottom-right";
+}>;
+export type WatermarkPosition = z.infer<typeof watermarkPositionEnum>;
+/**
+ * Watermark object schema — shared by the global, gallery, and field config sites.
+ * `imagePath` is required; everything else falls back to WATERMARK_DEFAULTS.
+ */
+export declare const watermarkObjectSchema: z.ZodObject<{
+    /** Path to the watermark image, resolved relative to process.cwd() unless absolute. PNG w/ alpha recommended. */
+    imagePath: z.ZodString;
+    /** Placement, mapped to a sharp gravity. Default 'center'. */
+    position: z.ZodOptional<z.ZodEnum<{
+        "top-left": "top-left";
+        top: "top";
+        "top-right": "top-right";
+        left: "left";
+        center: "center";
+        right: "right";
+        "bottom-left": "bottom-left";
+        bottom: "bottom";
+        "bottom-right": "bottom-right";
+    }>>;
+    /** Watermark width as a fraction (0–1) of the output image width. Default 0.2. */
+    size: z.ZodOptional<z.ZodNumber>;
+    /** Overlay opacity (0–1). Default 0.5. */
+    opacity: z.ZodOptional<z.ZodNumber>;
+    /** Inset in px from the chosen edge/corner. Ignored for 'center' and when tiling. Default 0. */
+    margin: z.ZodOptional<z.ZodNumber>;
+    /** Repeat the mark across the whole image (ignores position + margin). Default false. */
+    tile: z.ZodOptional<z.ZodBoolean>;
+    /** Also composite the mark onto the generated thumbnail. Default false. */
+    applyToThumbnail: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const watermarkConfigSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    /** Path to the watermark image, resolved relative to process.cwd() unless absolute. PNG w/ alpha recommended. */
+    imagePath: z.ZodString;
+    /** Placement, mapped to a sharp gravity. Default 'center'. */
+    position: z.ZodOptional<z.ZodEnum<{
+        "top-left": "top-left";
+        top: "top";
+        "top-right": "top-right";
+        left: "left";
+        center: "center";
+        right: "right";
+        "bottom-left": "bottom-left";
+        bottom: "bottom";
+        "bottom-right": "bottom-right";
+    }>>;
+    /** Watermark width as a fraction (0–1) of the output image width. Default 0.2. */
+    size: z.ZodOptional<z.ZodNumber>;
+    /** Overlay opacity (0–1). Default 0.5. */
+    opacity: z.ZodOptional<z.ZodNumber>;
+    /** Inset in px from the chosen edge/corner. Ignored for 'center' and when tiling. Default 0. */
+    margin: z.ZodOptional<z.ZodNumber>;
+    /** Repeat the mark across the whole image (ignores position + margin). Default false. */
+    tile: z.ZodOptional<z.ZodBoolean>;
+    /** Also composite the mark onto the generated thumbnail. Default false. */
+    applyToThumbnail: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>]>;
+export type WatermarkObject = z.infer<typeof watermarkObjectSchema>;
+export type WatermarkConfig = z.infer<typeof watermarkConfigSchema>;
+export type ResolvedWatermark = {
+    imagePath: string;
+    position: WatermarkPosition;
+    size: number;
+    opacity: number;
+    margin: number;
+    tile: boolean;
+    applyToThumbnail: boolean;
+};
+export declare const WATERMARK_DEFAULTS: {
+    position: WatermarkPosition;
+    size: number;
+    opacity: number;
+    margin: number;
+    tile: boolean;
+    applyToThumbnail: boolean;
+};
+/**
+ * Resolve a watermark config for one level against the global config.
+ * - undefined  -> inherit `global`
+ * - false      -> off (returns null)
+ * - object     -> full replacement (imagePath required)
+ */
+export declare function resolveWatermark(level: WatermarkConfig | undefined, global: WatermarkConfig): ResolvedWatermark | null;
+//# sourceMappingURL=watermark.d.ts.map

package/dist/core/helpers/watermark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watermark.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/watermark.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;EAUhC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAC9B,iHAAiH;;IAEjH,8DAA8D;;;;;;;;;;;;IAE9D,kFAAkF;;IAElF,0CAA0C;;IAE1C,gGAAgG;;IAEhG,yFAAyF;;IAEzF,2EAA2E;;kBAE7E,CAAA;AAEF,eAAO,MAAM,qBAAqB;IAhB9B,iHAAiH;;IAEjH,8DAA8D;;;;;;;;;;;;IAE9D,kFAAkF;;IAElF,0CAA0C;;IAE1C,gGAAgG;;IAEhG,yFAAyF;;IAEzF,2EAA2E;;oBAIQ,CAAA;AAEvF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,gBAAgB,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,kBAAkB;cACL,iBAAiB;;;;;;CAM1C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,MAAM,EAAE,eAAe,GACxB,iBAAiB,GAAG,IAAI,CAY1B"}

package/dist/core/helpers/watermark.js

@@ -0,0 +1,61 @@
+import * as z from 'zod';
+export const watermarkPositionEnum = z.enum([
+    'top-left',
+    'top',
+    'top-right',
+    'left',
+    'center',
+    'right',
+    'bottom-left',
+    'bottom',
+    'bottom-right',
+]);
+/**
+ * Watermark object schema — shared by the global, gallery, and field config sites.
+ * `imagePath` is required; everything else falls back to WATERMARK_DEFAULTS.
+ */
+export const watermarkObjectSchema = z.strictObject({
+    /** Path to the watermark image, resolved relative to process.cwd() unless absolute. PNG w/ alpha recommended. */
+    imagePath: z.string(),
+    /** Placement, mapped to a sharp gravity. Default 'center'. */
+    position: watermarkPositionEnum.optional(),
+    /** Watermark width as a fraction (0–1) of the output image width. Default 0.2. */
+    size: z.number().min(0).max(1).optional(),
+    /** Overlay opacity (0–1). Default 0.5. */
+    opacity: z.number().min(0).max(1).optional(),
+    /** Inset in px from the chosen edge/corner. Ignored for 'center' and when tiling. Default 0. */
+    margin: z.number().min(0).optional(),
+    /** Repeat the mark across the whole image (ignores position + margin). Default false. */
+    tile: z.boolean().optional(),
+    /** Also composite the mark onto the generated thumbnail. Default false. */
+    applyToThumbnail: z.boolean().optional(),
+});
+export const watermarkConfigSchema = z.union([z.literal(false), watermarkObjectSchema]);
+export const WATERMARK_DEFAULTS = {
+    position: 'center',
+    size: 0.2,
+    opacity: 0.5,
+    margin: 0,
+    tile: false,
+    applyToThumbnail: false,
+};
+/**
+ * Resolve a watermark config for one level against the global config.
+ * - undefined  -> inherit `global`
+ * - false      -> off (returns null)
+ * - object     -> full replacement (imagePath required)
+ */
+export function resolveWatermark(level, global) {
+    const chosen = level ?? global;
+    if (chosen === false)
+        return null;
+    return {
+        imagePath: chosen.imagePath,
+        position: chosen.position ?? WATERMARK_DEFAULTS.position,
+        size: chosen.size ?? WATERMARK_DEFAULTS.size,
+        opacity: chosen.opacity ?? WATERMARK_DEFAULTS.opacity,
+        margin: chosen.margin ?? WATERMARK_DEFAULTS.margin,
+        tile: chosen.tile ?? WATERMARK_DEFAULTS.tile,
+        applyToThumbnail: chosen.applyToThumbnail ?? WATERMARK_DEFAULTS.applyToThumbnail,
+    };
+}