@cardanvil/frame-kit 0.3.1 → 0.5.0

package/dist/schema/frame.js

@@ -23,6 +23,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,

package/dist/schema/frameMeta.d.ts

@@ -14,6 +14,7 @@ export declare const FrameMetaSchema: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
     entry: z.ZodDefault<z.ZodString>;
     export: z.ZodDefault<z.ZodString>;
+    private: z.ZodDefault<z.ZodBoolean>;
     author: z.ZodObject<{
         name: z.ZodString;
         url: z.ZodOptional<z.ZodURL>;

package/dist/schema/frameMeta.js

@@ -33,6 +33,18 @@ export const FrameMetaSchema = z.object({
     entry: z.string().default("./index.ts"),
     /** Named export to read from `entry`. */
     export: z.string().default("default"),
+    /**
+     * Keeps the frame out of every build: it is never packaged, never indexed
+     * and never released. `validate` still loads and checks it, so a frame
+     * nobody ships cannot quietly rot.
+     *
+     * The author template's `example` frame is the case this exists for. It has
+     * to stay in the repository because `new-frame` copies it, but an id is
+     * permanent identity — publishing it would put the same
+     * `com.example.example` in every release by every author who forgot to
+     * delete it.
+     */
+    private: z.boolean().default(false),
     author: z.object({
         name: z.string().min(1),
         url: z.url().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardanvil/frame-kit",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "The contract Card Anvil frames are authored against: schemas, types, authoring helpers, and the distributable manifest format.",
   "license": "MIT",
   "type": "module",

package/schema/frame-meta.schema.json

@@ -40,6 +40,10 @@
       "minLength": 1,
       "type": "string"
     },
+    "private": {
+      "default": false,
+      "type": "boolean"
+    },
     "slug": {
       "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
       "type": "string"