nextjs-cms 0.9.41 → 0.10.0

package/dist/core/helpers/background.js

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+/**
+ * Padding colour schema — shared by every field that resizes images, so the shape stays
+ * identical across them. Only meaningful alongside `fit: 'contain'`, where the image is padded
+ * out to the full box; fields fall back to `media.images.background` from the CMS config when
+ * it is omitted.
+ *
+ * `alpha: 0` only survives in formats with an alpha channel (webp, png). Encoding transparent
+ * padding to jpeg flattens it to black, so pick an opaque colour for jpeg output.
+ */
+export const backgroundSchema = z
+    .strictObject({
+    r: z.number().min(0).max(255).describe('Red channel (0-255)'),
+    g: z.number().min(0).max(255).describe('Green channel (0-255)'),
+    b: z.number().min(0).max(255).describe('Blue channel (0-255)'),
+    alpha: z.number().min(0).max(1).describe('Alpha channel (0-1)'),
+})
+    .describe('Background color for image padding (used with fit: contain)');

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

@@ -2,5 +2,9 @@ export { is } from './entity.js';
 export { entityKind } from './entity.js';
 export type { LZEntity } from './entity.js';
 export { hasOwnEntityKind } from './entity.js';
-export { evaluateConditionalRule, evaluateConditionalRuleGroup, normalizeConditionalRules } from './conditional-rules.js';
+export { evaluateConditionalRule, evaluateConditionalRuleGroup, normalizeConditionalRules, } from './conditional-rules.js';
+export { backgroundSchema } from './background.js';
+export type { Background } from './background.js';
+export { watermarkPositionEnum, watermarkObjectSchema, watermarkConfigSchema, WATERMARK_DEFAULTS, resolveWatermark, } from './watermark.js';
+export type { WatermarkPosition, WatermarkObject, WatermarkConfig, ResolvedWatermark } from './watermark.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C,OAAO,EACH,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/core/helpers/index.js

@@ -4,4 +4,6 @@ export { hasOwnEntityKind } from './entity.js';
 // Note: the `and` / `or` authoring wrappers are re-exported from `core/fields` (alongside the field
 // factories that section configs use), so they are intentionally not re-exported here to avoid a
 // duplicate export when `core/index` merges both barrels.
-export { evaluateConditionalRule, evaluateConditionalRuleGroup, normalizeConditionalRules } from './conditional-rules.js';
+export { evaluateConditionalRule, evaluateConditionalRuleGroup, normalizeConditionalRules, } from './conditional-rules.js';
+export { backgroundSchema } from './background.js';
+export { watermarkPositionEnum, watermarkObjectSchema, watermarkConfigSchema, WATERMARK_DEFAULTS, resolveWatermark, } from './watermark.js';

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,
+    };
+}