@womp/kookie-ui 0.7.0 → 0.8.1

package/schemas/shell-panel.json

@@ -4,7 +4,12 @@
     "Shell-panelSchema": {
       "type": "object",
       "properties": {
+        "id": {
+          "description": "The pane id. A Trigger points `aria-controls` at it.",
+          "type": "string"
+        },
         "presentation": {
+          "description": "Presentation mode. With no value the panel follows the Rail's.",
           "anyOf": [
             {
               "type": "string",
@@ -19,141 +24,241 @@
               "type": "object",
               "properties": {
                 "initial": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "xs": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "sm": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "md": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "lg": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "xl": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 }
               },
               "additionalProperties": false
             }
-          ],
-          "description": "Responsive presentation configuration"
+          ]
         },
-        "mode": {
-          "type": "string",
-          "enum": [
-            "expanded",
-            "collapsed"
-          ],
-          "description": "Pane state mode"
+        "expandedSize": {
+          "default": 288,
+          "description": "Open width in pixels",
+          "type": "number"
+        },
+        "inset": {
+          "description": "Lifts the pane off the frame and paints the backdrop behind it",
+          "type": "boolean"
+        },
+        "className": {
+          "description": "Additional CSS class name",
+          "type": "string"
+        },
+        "style": {
+          "description": "Inline styles",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": [
+              "string",
+              "number"
+            ]
+          }
         },
-        "defaultMode": {
+        "children": {},
+        "open": {
+          "description": "The open state, when controlled. A responsive object is deprecated.",
           "anyOf": [
             {
-              "$ref": "#/definitions/Shell-panelSchema/properties/mode"
+              "type": "boolean"
             },
             {
-              "type": "object",
-              "properties": {
-                "initial": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "xs": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
+              "anyOf": [
+                {
+                  "type": "boolean"
                 },
-                "sm": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "md": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "lg": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "xl": {
-                  "$ref": "#/definitions/Shell-panelSchema/properties/mode",
-                  "description": "Pane state mode"
+                {
+                  "type": "object",
+                  "properties": {
+                    "initial": {
+                      "type": "boolean"
+                    },
+                    "xs": {
+                      "type": "boolean"
+                    },
+                    "sm": {
+                      "type": "boolean"
+                    },
+                    "md": {
+                      "type": "boolean"
+                    },
+                    "lg": {
+                      "type": "boolean"
+                    },
+                    "xl": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
                 }
-              },
-              "additionalProperties": false
+              ],
+              "description": "Responsive open state"
             }
-          ],
-          "description": "Responsive pane mode configuration"
+          ]
         },
-        "expandedSize": {
-          "type": "number",
-          "default": 288,
-          "description": "Default width in pixels"
+        "defaultOpen": {
+          "description": "The starting state. A responsive object leaves the pane untouched, with that object as the answer at each breakpoint.",
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "initial": {
+                      "type": "boolean"
+                    },
+                    "xs": {
+                      "type": "boolean"
+                    },
+                    "sm": {
+                      "type": "boolean"
+                    },
+                    "md": {
+                      "type": "boolean"
+                    },
+                    "lg": {
+                      "type": "boolean"
+                    },
+                    "xl": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Responsive open state"
+            }
+          ]
         },
         "minSize": {
-          "type": "number",
-          "default": 200,
-          "description": "Minimum width when resizing"
+          "default": 100,
+          "description": "Minimum width when resizing",
+          "type": "number"
         },
         "maxSize": {
-          "type": "number",
           "default": 800,
-          "description": "Maximum width when resizing"
+          "description": "Maximum width when resizing",
+          "type": "number"
         },
         "resizable": {
-          "type": "boolean",
           "default": false,
-          "description": "Whether the panel can be resized"
+          "description": "Whether the panel can be resized",
+          "type": "boolean"
         },
         "collapsible": {
-          "type": "boolean",
           "default": true,
-          "description": "Whether the panel can be collapsed via resize handle"
+          "description": "Whether a double-click on the handle closes the panel",
+          "type": "boolean"
+        },
+        "size": {
+          "description": "The size, when controlled",
+          "type": [
+            "number",
+            "string"
+          ]
+        },
+        "defaultSize": {
+          "description": "The starting size",
+          "type": [
+            "number",
+            "string"
+          ]
+        },
+        "sizeUpdate": {
+          "description": "Rate-limits onSizeChange across repeated resize ends, such as key presses on the handle. A drag calls it once, when the drag ends; use onResize for live sizes.",
+          "type": "string",
+          "enum": [
+            "throttle",
+            "debounce"
+          ]
+        },
+        "sizeUpdateMs": {
+          "type": "number"
         },
-        "resizer": {},
         "snapPoints": {
+          "description": "Deprecated, removed in 1.0",
           "type": "array",
           "items": {
             "type": "number"
           }
         },
         "snapTolerance": {
+          "description": "Deprecated, removed in 1.0",
           "type": "number"
         },
         "collapseThreshold": {
+          "description": "Deprecated, removed in 1.0",
           "type": "number"
         },
         "paneId": {
+          "description": "Deprecated, removed in 1.0",
           "type": "string"
         },
         "persistence": {
           "type": "object",
           "properties": {},
-          "additionalProperties": false,
-          "description": "Size persistence adapter"
-        },
-        "className": {
-          "type": "string"
-        },
-        "style": {
-          "type": "object",
-          "additionalProperties": {
-            "type": [
-              "string",
-              "number"
-            ]
-          }
-        },
-        "children": {}
+          "description": "Deprecated, removed in 1.0. Keep the size in your own state with `size`/`onSizeChange`.",
+          "additionalProperties": false
+        }
       },
       "additionalProperties": false
     }
@@ -162,6 +267,5 @@
   "title": "Shell-panel Component Props",
   "description": "Props schema for the shell-panel component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-09-10T19:04:45.608Z",
   "source": "Zod schema"
 }

package/schemas/shell-rail.d.ts

@@ -0,0 +1,2 @@
+declare const schema: any;
+export default schema;

package/schemas/shell-rail.json

@@ -4,7 +4,13 @@
     "Shell-railSchema": {
       "type": "object",
       "properties": {
+        "id": {
+          "description": "The pane id. A Trigger points `aria-controls` at it.",
+          "type": "string"
+        },
         "presentation": {
+          "default": "fixed",
+          "description": "Presentation mode",
           "anyOf": [
             {
               "type": "string",
@@ -19,105 +25,173 @@
               "type": "object",
               "properties": {
                 "initial": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "xs": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "sm": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "md": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "lg": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 },
                 "xl": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/presentation/anyOf/0",
+                  "type": "string",
+                  "enum": [
+                    "fixed",
+                    "overlay",
+                    "stacked"
+                  ],
                   "description": "Presentation mode"
                 }
               },
               "additionalProperties": false
             }
-          ],
-          "description": "Responsive presentation configuration"
-        },
-        "mode": {
-          "type": "string",
-          "enum": [
-            "expanded",
-            "collapsed"
-          ],
-          "description": "Pane state mode"
-        },
-        "defaultMode": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/Shell-railSchema/properties/mode"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "initial": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "xs": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "sm": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "md": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "lg": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                },
-                "xl": {
-                  "$ref": "#/definitions/Shell-railSchema/properties/mode",
-                  "description": "Pane state mode"
-                }
-              },
-              "additionalProperties": false
-            }
-          ],
-          "description": "Responsive pane mode configuration"
+          ]
         },
         "expandedSize": {
-          "type": "number",
           "default": 64,
-          "description": "Default width in pixels"
+          "description": "Width in pixels",
+          "type": "number"
         },
-        "collapsible": {
+        "inset": {
+          "description": "Lifts the pane off the frame and paints the backdrop behind it",
           "type": "boolean"
         },
         "className": {
-          "type": "string",
-          "description": "Additional CSS class name"
+          "description": "Additional CSS class name",
+          "type": "string"
         },
         "style": {
+          "description": "Inline styles",
           "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
           "additionalProperties": {
             "type": [
               "string",
               "number"
             ]
-          },
-          "description": "Inline styles"
+          }
+        },
+        "children": {},
+        "open": {
+          "description": "The open state, when controlled. A responsive object is deprecated.",
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "initial": {
+                      "type": "boolean"
+                    },
+                    "xs": {
+                      "type": "boolean"
+                    },
+                    "sm": {
+                      "type": "boolean"
+                    },
+                    "md": {
+                      "type": "boolean"
+                    },
+                    "lg": {
+                      "type": "boolean"
+                    },
+                    "xl": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Responsive open state"
+            }
+          ]
         },
-        "children": {
-          "description": "Rail content"
+        "defaultOpen": {
+          "description": "The starting state. A responsive object leaves the pane untouched, with that object as the answer at each breakpoint.",
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "initial": {
+                      "type": "boolean"
+                    },
+                    "xs": {
+                      "type": "boolean"
+                    },
+                    "sm": {
+                      "type": "boolean"
+                    },
+                    "md": {
+                      "type": "boolean"
+                    },
+                    "lg": {
+                      "type": "boolean"
+                    },
+                    "xl": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Responsive open state"
+            }
+          ]
+        },
+        "collapsible": {
+          "type": "boolean"
         }
       },
       "additionalProperties": false
@@ -127,6 +201,5 @@
   "title": "Shell-rail Component Props",
   "description": "Props schema for the shell-rail component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-09-10T19:04:45.608Z",
   "source": "Zod schema"
 }

package/schemas/shell-root.d.ts

@@ -0,0 +1,2 @@
+declare const schema: any;
+export default schema;

package/schemas/shell-root.json

@@ -5,6 +5,8 @@
       "type": "object",
       "properties": {
         "height": {
+          "default": "full",
+          "description": "Height of the frame. `full` is 100dvh, with 100vh where dvh is not supported.",
           "anyOf": [
             {
               "type": "string",
@@ -20,26 +22,27 @@
             {
               "type": "number"
             }
-          ],
-          "default": "full",
-          "description": "Height of the shell container"
+          ]
         },
         "className": {
-          "type": "string",
-          "description": "Additional CSS class name"
+          "description": "Additional CSS class name",
+          "type": "string"
         },
         "style": {
+          "description": "Inline styles",
           "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
           "additionalProperties": {
             "type": [
               "string",
               "number"
             ]
-          },
-          "description": "Inline styles"
+          }
         },
         "children": {
-          "description": "Shell components"
+          "description": "The Shell parts, and anything else, rendered in order"
         }
       },
       "additionalProperties": false
@@ -49,6 +52,5 @@
   "title": "Shell-root Component Props",
   "description": "Props schema for the shell-root component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-09-10T19:04:45.607Z",
   "source": "Zod schema"
 }

package/schemas/shell-sidebar.d.ts

@@ -0,0 +1,2 @@
+declare const schema: any;
+export default schema;