create-ailk 0.30.0 → 0.31.0

package/component-catalog.json

@@ -9,7 +9,7 @@
       "importPath": "@working-theory/ui/sections",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/sections",
-      "count": 57
+      "count": 60
     },
     {
       "name": "blocks",
@@ -133,6 +133,17 @@
     }
   ],
   "components": [
+    {
+      "name": "AddToCalendar",
+      "tier": "sections",
+      "sourcePath": "packages/ui/src/sections/AddToCalendar.tsx",
+      "importPath": "@working-theory/ui/sections",
+      "exported": true,
+      "description": "An Event page's \"Add to calendar\" control. A Server Component of three plain links built by `eventCalendarLinks` in `@working-theory/schema`: Google Calendar and Outlook open in a new tab; Apple Calendar downloads the `.ics`. Rendered directly by `renderPage` for every Event page with a start date (the `BlogPost` precedent of a section a caller renders with typed props), never authored in `sections[]`.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "AlertSection",
       "tier": "sections",
@@ -474,6 +485,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "HeroTypedHeadline",
+      "tier": "sections",
+      "sourcePath": "packages/ui/src/sections/HeroTypedHeadline.tsx",
+      "importPath": "@working-theory/ui/sections",
+      "exported": false,
+      "description": "The centred Hero's `typing` opt-in. The headline, then each subheadline sentence, types on its own line with a caret: solid while letters appear, blinking at every pause and after the last line. THE FULL TEXT IS ALWAYS IN THE DOM: each row renders its typed part and its untyped rest, and only the split point moves.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "Items",
       "tier": "sections",
@@ -584,6 +606,17 @@
       "descriptionGrade": "strong",
       "sectionType": "pricing"
     },
+    {
+      "name": "ProjectListings",
+      "tier": "sections",
+      "sourcePath": "packages/ui/src/sections/ProjectListings.tsx",
+      "importPath": "@working-theory/ui/sections",
+      "exported": false,
+      "description": "The site's public project listings — each a name linking to /projects/<slug>, newest decided first, at most `limit` (default 6), no logos. Use it on the home to show what the site lists; the rows are filled at render from the site's public project listings, never authored, and with none (or the API unreachable) the section is removed from the page. Author only the eyebrow, headline, description and `limit`.",
+      "descriptionSource": "registry",
+      "descriptionGrade": "strong",
+      "sectionType": "project-listings"
+    },
     {
       "name": "ReportHeader",
       "tier": "sections",
@@ -3934,6 +3967,10 @@
                   "headline": {
                     "type": "string"
                   },
+                  "headlineHref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
                   "description": {
                     "type": "string"
                   },
@@ -4227,6 +4264,10 @@
               "headline": {
                 "type": "string"
               },
+              "headlineHref": {
+                "type": "string",
+                "minLength": 1
+              },
               "description": {
                 "type": "string"
               },
@@ -4460,6 +4501,10 @@
                           "headline": {
                             "type": "string"
                           },
+                          "headlineHref": {
+                            "type": "string",
+                            "minLength": 1
+                          },
                           "description": {
                             "type": "string"
                           },
@@ -4748,6 +4793,37 @@
               "chips"
             ]
           },
+          "newsletter": {
+            "type": "object",
+            "properties": {
+              "action": {
+                "type": "string",
+                "minLength": 1
+              },
+              "placeholder": {
+                "type": "string"
+              },
+              "submitLabel": {
+                "type": "string",
+                "minLength": 1
+              },
+              "siteId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[a-zA-Z0-9._-]+$"
+              },
+              "source": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            },
+            "required": [
+              "action",
+              "submitLabel"
+            ]
+          },
           "fill": {
             "type": "string",
             "enum": [
@@ -4906,6 +4982,43 @@
               }
             },
             "additionalProperties": false
+          },
+          "typing": {
+            "type": "object",
+            "properties": {
+              "startDelayMs": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 10000
+              },
+              "pauseMs": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 10000
+              },
+              "typeMs": {
+                "type": "integer",
+                "minimum": 20,
+                "maximum": 500
+              },
+              "caretWidth": {
+                "type": "string",
+                "enum": [
+                  "hairline",
+                  "medium",
+                  "wide"
+                ]
+              },
+              "caretColor": {
+                "type": "string",
+                "enum": [
+                  "fg",
+                  "brand",
+                  "accent"
+                ]
+              }
+            },
+            "additionalProperties": false
           }
         },
         "required": [
@@ -4923,7 +5036,8 @@
         "gapBelow",
         "measure",
         "ctaSize",
-        "fill"
+        "fill",
+        "typing"
       ]
     },
     {
@@ -4950,6 +5064,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -5150,6 +5268,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -5215,7 +5346,8 @@
               "minimal",
               "tile",
               "tiles",
-              "list"
+              "list",
+              "numeral"
             ]
           },
           "tileHover": {
@@ -5238,6 +5370,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -5285,6 +5421,11 @@
                 "eyebrow": {
                   "type": "string"
                 },
+                "numeral": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 12
+                },
                 "title": {
                   "type": "string"
                 },
@@ -5483,6 +5624,60 @@
               "countText"
             ],
             "additionalProperties": false
+          },
+          "actions": {
+            "minItems": 1,
+            "maxItems": 2,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "link",
+                    "button"
+                  ]
+                },
+                "label": {
+                  "type": "string"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "external": {
+                  "type": "boolean"
+                },
+                "variant": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "outline",
+                    "ghost",
+                    "link",
+                    "destructive"
+                  ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
+                }
+              },
+              "required": [
+                "kind",
+                "label",
+                "href"
+              ]
+            }
           }
         },
         "required": [
@@ -5528,6 +5723,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "subtitle": {
             "type": "string"
           },
@@ -5609,6 +5808,15 @@
               "above"
             ]
           },
+          "mediaWidth": {
+            "type": "string",
+            "enum": [
+              "full",
+              "sm",
+              "md",
+              "lg"
+            ]
+          },
           "cta": {
             "type": "object",
             "properties": {
@@ -5731,6 +5939,7 @@
       "look": [
         "variant",
         "mediaPosition",
+        "mediaWidth",
         "accentStyle",
         "glow",
         "surface",
@@ -5751,6 +5960,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "eyebrow": {
             "type": "string"
           },
@@ -5913,6 +6126,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -5961,6 +6178,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -6090,6 +6320,21 @@
               "start",
               "center"
             ]
+          },
+          "tags": {
+            "maxItems": 20,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,63}$"
+            }
+          },
+          "pinned": {
+            "maxItems": 100,
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         }
       },
@@ -6122,6 +6367,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -6155,6 +6404,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -6259,6 +6521,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "leadQuote": {
             "type": "object",
             "properties": {
@@ -6498,6 +6764,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "separation": {
             "type": "string",
             "enum": [
@@ -6629,6 +6899,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "separation": {
             "type": "string",
             "enum": [
@@ -6770,6 +7044,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -7423,6 +7701,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -7583,6 +7865,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "headlineStyle": {
             "type": "string",
             "enum": [
@@ -7689,6 +7975,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -7778,6 +8077,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -7950,6 +8253,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -8079,6 +8386,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -8157,6 +8468,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -8718,6 +9033,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -8841,6 +9160,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -8973,6 +9296,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9179,6 +9506,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -9227,6 +9567,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9432,6 +9776,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9627,6 +9975,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9698,6 +10050,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9710,6 +10066,10 @@
           "action": {
             "type": "string"
           },
+          "magnet": {
+            "type": "string",
+            "const": "newsletter"
+          },
           "siteId": {
             "type": "string",
             "minLength": 1,
@@ -9797,10 +10157,7 @@
           "successMessage": {
             "type": "string"
           }
-        },
-        "required": [
-          "action"
-        ]
+        }
       },
       "schemaError": null,
       "look": [
@@ -9819,6 +10176,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -9854,6 +10215,21 @@
               "list",
               "columns"
             ]
+          },
+          "tags": {
+            "maxItems": 20,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,63}$"
+            }
+          },
+          "pinned": {
+            "maxItems": 200,
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
@@ -10421,6 +10797,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -10454,6 +10834,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -10706,6 +11099,21 @@
               "default",
               "strong"
             ]
+          },
+          "tags": {
+            "maxItems": 20,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,63}$"
+            }
+          },
+          "pinned": {
+            "maxItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
@@ -10808,6 +11216,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -10939,6 +11351,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -11222,6 +11638,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -11277,6 +11697,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -11351,6 +11775,19 @@
                     "link",
                     "destructive"
                   ]
+                },
+                "icon": {
+                  "type": "string",
+                  "enum": [
+                    "github",
+                    "arrow-right",
+                    "external-link",
+                    "download",
+                    "calendar",
+                    "mail",
+                    "book-open",
+                    "play"
+                  ]
                 }
               },
               "required": [
@@ -11621,6 +12058,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "src": {
             "type": "string",
             "minLength": 1
@@ -11765,6 +12206,10 @@
           "headline": {
             "type": "string"
           },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
           "description": {
             "type": "string"
           },
@@ -11858,6 +12303,72 @@
         "surface"
       ]
     },
+    {
+      "type": "project-listings",
+      "component": "ProjectListings",
+      "whenToUse": "The site's public project listings — each a name linking to /projects/<slug>, newest decided first, at most `limit` (default 6), no logos. Use it on the home to show what the site lists; the rows are filled at render from the site's public project listings, never authored, and with none (or the API unreachable) the section is removed from the page. Author only the eyebrow, headline, description and `limit`. Not for logos — that is `logoCloud`.",
+      "schema": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "type": "object",
+        "properties": {
+          "eyebrow": {
+            "type": "string"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "headlineHref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": {
+            "type": "string"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 24
+          },
+          "entries": {
+            "maxItems": 24,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "href": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "name",
+                "href"
+              ]
+            }
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "none",
+              "gray-100",
+              "wash",
+              "wash-secondary",
+              "gradient-brand",
+              "gradient-dark",
+              "solid-dark"
+            ]
+          }
+        }
+      },
+      "schemaError": null,
+      "look": [
+        "surface"
+      ]
+    },
     {
       "type": "booker",
       "component": "Booker",
@@ -13355,7 +13866,7 @@
         },
         {
           "name": "spacing",
-          "leafCount": 15,
+          "leafCount": 16,
           "leaves": [
             {
               "path": "spacing.controlX",
@@ -13412,6 +13923,11 @@
               "type": "string",
               "value": "calc(2 * (var(--control-height-big) + var(--spacing-block-tight)))"
             },
+            {
+              "path": "spacing.heroMark",
+              "type": "string",
+              "value": "var(--spacing-block-loose)"
+            },
             {
               "path": "spacing.paragraph",
               "type": "string",