@cardanvil/frame-kit 0.4.0 → 0.6.0

package/dist/schema/frame.js

@@ -15,6 +15,12 @@ export const TextBoxSchema = BoundsSchema.extend({
     outlineWidth: z.number().optional(),
     verticalAlign: z.enum(["top", "center"]).optional(),
     textAlign: z.enum(["left", "center", "right"]).optional(),
+    /** Extra spacing between characters, in px (Konva `letterSpacing`),
+     * expressed at the box's own `fontSize` — each run scales it by its font
+     * size so it reads as constant tracking. Non-zero spacing switches Konva
+     * to per-character drawing with kerning off; the canvas measurement path
+     * mirrors that so measured widths match the render. */
+    letterSpacing: z.number().optional(),
     /** Per-box font family override. When set, the renderer uses this instead
      * of the language-resolved default (e.g. title font). */
     fontFamily: z.string().optional(),
@@ -23,6 +29,17 @@ export const TextBoxSchema = BoundsSchema.extend({
      * true when omitted (matches the original behavior). Set to false to
      * disable the shadow (e.g. flipside mana-cost badges on light backgrounds). */
     shadow: z.boolean().optional(),
+    /** Shaped-text mask: a full-canvas-sized PNG whose opaque pixels define the
+     * region text in this box may occupy. Alpha is what matters (any pixel with
+     * alpha > ~12% counts as inside), so color is irrelevant. Each wrapped line
+     * is measured against the mask's horizontal extent at the line's vertical
+     * band instead of the box's plain rectangle; lines are aligned/centered
+     * within that extent. The box still bounds everything: a mask region wider
+     * than the box is clamped to it, and a mask region narrower than the box
+     * shrinks the usable width. When the box has no width at a line's vertical
+     * position (the shape is absent there), the line falls back to the full box
+     * width. */
+    mask: AssetUrlSchema.optional(),
 });
 export const CardBoxesSchema = z.object({
     art: BoundsSchema,
@@ -144,25 +161,35 @@ export const defaultNicknameConfig = {
     x: 378,
     y: 577,
 };
+/**
+ * A hint rendered under a template setting's control, for anything the label
+ * alone can't carry — what the setting changes, or when to reach for it.
+ * Optional everywhere; a setting without one renders exactly as before.
+ */
+const helperText = z.string().optional();
 export const TemplateSettingConfigSchema = z.union([
     z.object({
         type: z.literal("boolean"),
         label: z.string(),
+        helperText,
         defaultValue: z.boolean(),
     }),
     z.object({
         type: z.literal("string"),
         label: z.string(),
+        helperText,
         defaultValue: z.string(),
     }),
     z.object({
         type: z.literal("number"),
         label: z.string(),
+        helperText,
         defaultValue: z.string(),
     }),
     z.object({
         type: z.literal("select"),
         label: z.string(),
+        helperText,
         defaultValue: z.string(),
         options: z.array(z.string()),
     }),

package/dist/schema/frameAssets.d.ts

@@ -505,13 +505,15 @@ export type FrameAssets = z.infer<typeof FrameAssetsSchema>;
 /**
  * Section masks the renderer actually reads. `rightHalf` overrides the global
  * default (`globalMasks.rightHalf`) when a layout ships its own. The legacy
- * `frame`/`border` mask keys are intentionally absent — nothing reads them.
+ * `frame` mask key is intentionally absent — nothing reads it.
  */
 export declare const LayoutMasksSchema: z.ZodObject<{
     pinlines: z.ZodOptional<z.ZodString>;
     titleAndType: z.ZodOptional<z.ZodString>;
     rules: z.ZodOptional<z.ZodString>;
     noBorder: z.ZodOptional<z.ZodString>;
+    border: z.ZodOptional<z.ZodString>;
+    borderFull: z.ZodOptional<z.ZodString>;
     legendary: z.ZodOptional<z.ZodString>;
     legendaryTransform: z.ZodOptional<z.ZodString>;
     noBorderTransform: z.ZodOptional<z.ZodString>;

package/dist/schema/frameAssets.js

@@ -149,13 +149,35 @@ export const FrameAssetsSchema = z.object({
 /**
  * Section masks the renderer actually reads. `rightHalf` overrides the global
  * default (`globalMasks.rightHalf`) when a layout ships its own. The legacy
- * `frame`/`border` mask keys are intentionally absent — nothing reads them.
+ * `frame` mask key is intentionally absent — nothing reads it.
  */
 export const LayoutMasksSchema = z.object({
     pinlines: AssetUrlSchema.optional(),
     titleAndType: AssetUrlSchema.optional(),
     rules: AssetUrlSchema.optional(),
     noBorder: AssetUrlSchema.optional(),
+    /**
+     * Alpha mask opaque only over the outer border ring itself (everything
+     * else — art, text boxes, and the framing surface between them —
+     * transparent). Clipped via `destination-in` to isolate the ring's shape
+     * so the global border-color setting can recolor just that ring. Distinct
+     * from `noBorder`, which cuts the internal framing band too for the
+     * extended-art trim — the two are not interchangeable.
+     */
+    border: AssetUrlSchema.optional(),
+    /**
+     * Full-coverage variant of `border`, opaque over the whole outer ring
+     * including the strip the collector line sits on.
+     *
+     * A frame ships this only when its plain `border` mask deliberately covers
+     * *less* than the whole ring — m15's stops short of the collector strip, so
+     * that the default border recolor leaves the collector line on its original
+     * black. Declaring `borderFull` is therefore also what tells the renderer
+     * that `border` is a partial mask: see `useFullBorder` in `drawCardToStage`,
+     * which picks between the two and decides whether the collector text has to
+     * adapt to the border color.
+     */
+    borderFull: AssetUrlSchema.optional(),
     legendary: AssetUrlSchema.optional(),
     /** Legendary crown mask variant for transforming MDFC front faces — the
      * composited top-half frame uses a different legendary crown cutout than