fix(schema): make visible optional for validation

packages/core/src/schema.test.ts

@@ -14,7 +14,7 @@ const testSchema = defineSchema((s) => ({
         type: s.ref("catalog.components"),
         props: s.propsOf("catalog.components"),
         children: s.array(s.string()),
-        visible: s.any(),
+        visible: { ...s.any(), ...s.optional() },
       }),
     ),
   }),
@@ -583,6 +583,21 @@ describe("catalog.validate", () => {
     expect(result.data).toEqual(spec);
   });
 
+  it("does not require optional visible fields", () => {
+    const result = catalog.validate({
+      root: "card-1",
+      elements: {
+        "card-1": {
+          type: "Card",
+          props: { title: "Hello" },
+          children: [],
+        },
+      },
+    });
+
+    expect(result.success).toBe(true);
+  });
+
   it("rejects spec with wrong root type", () => {
     const result = catalog.validate({ root: 123, elements: {} });
     expect(result.success).toBe(false);

packages/core/src/schema.ts

@@ -327,8 +327,16 @@ export type InferSpec<TDef extends SchemaDefinition, TCatalog> = TDef extends {
   ? InferSpecObject<Shape, TCatalog>
   : unknown;
 
+type OptionalSpecKeys<Shape> = {
+  [K in keyof Shape]: Shape[K] extends { optional: true } ? K : never;
+}[keyof Shape];
+
+type RequiredSpecKeys<Shape> = Exclude<keyof Shape, OptionalSpecKeys<Shape>>;
+
 type InferSpecObject<Shape, TCatalog> = {
-  [K in keyof Shape]: InferSpecField<Shape[K], TCatalog>;
+  [K in RequiredSpecKeys<Shape>]: InferSpecField<Shape[K], TCatalog>;
+} & {
+  [K in OptionalSpecKeys<Shape>]?: InferSpecField<Shape[K], TCatalog>;
 };
 
 type InferSpecField<T, TCatalog> =

packages/image/src/schema.ts

@@ -18,7 +18,7 @@ export const schema = defineSchema(
           type: s.ref("catalog.components"),
           props: s.propsOf("catalog.components"),
           children: s.array(s.string()),
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/ink/src/schema.ts

@@ -22,7 +22,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/next/src/schema.ts

@@ -233,7 +233,7 @@ export const schema = defineSchema(
                 type: s.ref("catalog.components"),
                 props: s.propsOf("catalog.components"),
                 children: s.array(s.string()),
-                visible: s.any(),
+                visible: { ...s.any(), ...s.optional() },
               }),
             ),
             state: s.any(),
@@ -264,7 +264,7 @@ export const schema = defineSchema(
               type: s.ref("catalog.components"),
               props: s.propsOf("catalog.components"),
               children: s.array(s.string()),
-              visible: s.any(),
+              visible: { ...s.any(), ...s.optional() },
             }),
           ),
           state: s.any(),

packages/react-email/src/schema.ts

@@ -18,7 +18,7 @@ export const schema = defineSchema(
           type: s.ref("catalog.components"),
           props: s.propsOf("catalog.components"),
           children: s.array(s.string()),
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/react-native/src/schema.ts

@@ -23,7 +23,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/react-pdf/src/schema.ts

@@ -18,7 +18,7 @@ export const schema = defineSchema(
           type: s.ref("catalog.components"),
           props: s.propsOf("catalog.components"),
           children: s.array(s.string()),
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/react/src/schema.ts

@@ -23,7 +23,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/solid/src/schema.ts

@@ -23,7 +23,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/svelte/src/schema.ts

@@ -23,7 +23,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),

packages/vue/src/schema.ts

@@ -23,7 +23,7 @@ export const schema = defineSchema(
           /** Child element keys (flat reference) */
           children: s.array(s.string()),
           /** Visibility condition */
-          visible: s.any(),
+          visible: { ...s.any(), ...s.optional() },
         }),
       ),
     }),