@notionhq/custom-blocks-dev-shell 0.1.9 → 0.1.11

package/dist/assets/index-D7A1CDPg.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.2.4 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-black:#000;--color-white:#fff;--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--font-weight-normal:400;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--leading-relaxed:1.625;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--radius-2xl:1rem;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--color-ink:#32302c;--color-ink-muted:#6b6b68;--color-ink-faint:#9b9a97;--color-ink-fainter:#b3b3b0;--color-nav-ink:#2c2c2b;--color-paper:#fbfbfa;--color-hairline:#e6e5e3;--color-ui-hover:#3b14000d;--color-panel:#42230308;--color-canvas-dark:#191919;--color-pill-dark:#ffffff0e;--color-dark-ink:#ffffffcf;--color-dark-ink-muted:#ffffff75;--color-sidebar:#f7f7f5;--color-sidebar-active:#00000008;--color-sidebar-ink:#5f5e59;--color-sidebar-ink-strong:#1d1b16;--color-sidebar-ink-muted:#7d7a75;--color-hairline-soft:#f0efed;--color-toggle:#e9e9e7;--color-accent:#2383e2;--color-mismatch-ink:#a33}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light}}@layer components;@layer utilities{.pointer-events-none{pointer-events:none}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing) * 0)}.start{inset-inline-start:var(--spacing)}.end{inset-inline-end:var(--spacing)}.top-0{top:calc(var(--spacing) * 0)}.top-1\/2{top:50%}.top-full{top:100%}.right-0{right:calc(var(--spacing) * 0)}.right-1\.5{right:calc(var(--spacing) * 1.5)}.bottom-full{bottom:100%}.left-0{left:calc(var(--spacing) * 0)}.z-50{z-index:50}.row-1{grid-row:1}.row-2{grid-row:2}.mx-auto{margin-inline:auto}.mt-1{margin-top:calc(var(--spacing) * 1)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-3{margin-top:calc(var(--spacing) * 3)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mb-1{margin-bottom:calc(var(--spacing) * 1)}.block{display:block}.flex{display:flex}.hidden{display:none}.inline{display:inline}.inline-flex{display:inline-flex}.table{display:table}.size-4{width:calc(var(--spacing) * 4);height:calc(var(--spacing) * 4)}.size-5{width:calc(var(--spacing) * 5);height:calc(var(--spacing) * 5)}.size-6{width:calc(var(--spacing) * 6);height:calc(var(--spacing) * 6)}.size-7{width:calc(var(--spacing) * 7);height:calc(var(--spacing) * 7)}.h-6{height:calc(var(--spacing) * 6)}.h-7{height:calc(var(--spacing) * 7)}.h-9{height:calc(var(--spacing) * 9)}.h-100{height:calc(var(--spacing) * 100)}.h-\[30px\]{height:30px}.h-\[38px\]{height:38px}.h-screen{height:100vh}.max-h-\[85vh\]{max-height:85vh}.min-h-0{min-height:calc(var(--spacing) * 0)}.w-70{width:calc(var(--spacing) * 70)}.w-\[172px\]{width:172px}.w-full{width:100%}.max-w-190{max-width:calc(var(--spacing) * 190)}.max-w-\[720px\]{max-width:720px}.max-w-\[960px\]{max-width:960px}.max-w-full{max-width:100%}.min-w-0{min-width:calc(var(--spacing) * 0)}.min-w-40{min-width:calc(var(--spacing) * 40)}.flex-1{flex:1}.flex-none{flex:none}.shrink-0{flex-shrink:0}.border-collapse{border-collapse:collapse}.-translate-y-1\/2{--tw-translate-y:calc(calc(1 / 2 * 100%) * -1);translate:var(--tw-translate-x) var(--tw-translate-y)}.cursor-pointer{cursor:pointer}.resize{resize:both}.list-disc{list-style-type:disc}.appearance-none{appearance:none}.flex-col{flex-direction:column}.items-center{align-items:center}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.gap-1{gap:calc(var(--spacing) * 1)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-6{gap:calc(var(--spacing) * 6)}.gap-px{gap:1px}.self-start{align-self:flex-start}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-2xl{border-radius:var(--radius-2xl)}.rounded-\[4px\]{border-radius:4px}.rounded-\[6px\]{border-radius:6px}.rounded-\[10px\]{border-radius:10px}.rounded-\[12px\]{border-radius:12px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-xl{border-radius:var(--radius-xl)}.border{border-style:var(--tw-border-style);border-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-hairline{border-color:var(--color-hairline)}.border-hairline-soft{border-color:var(--color-hairline-soft)}.bg-accent{background-color:var(--color-accent)}.bg-black\/40{background-color:#0006}@supports (color:color-mix(in lab, red, red)){.bg-black\/40{background-color:color-mix(in oklab, var(--color-black) 40%, transparent)}}.bg-canvas-dark{background-color:var(--color-canvas-dark)}.bg-panel{background-color:var(--color-panel)}.bg-paper{background-color:var(--color-paper)}.bg-pill-dark{background-color:var(--color-pill-dark)}.bg-sidebar{background-color:var(--color-sidebar)}.bg-sidebar-active{background-color:var(--color-sidebar-active)}.bg-toggle{background-color:var(--color-toggle)}.bg-ui-hover{background-color:var(--color-ui-hover)}.bg-white{background-color:var(--color-white)}.p-1{padding:calc(var(--spacing) * 1)}.p-2{padding:calc(var(--spacing) * 2)}.p-4{padding:calc(var(--spacing) * 4)}.p-6{padding:calc(var(--spacing) * 6)}.px-1{padding-inline:calc(var(--spacing) * 1)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-6{padding-inline:calc(var(--spacing) * 6)}.px-10{padding-inline:calc(var(--spacing) * 10)}.py-1{padding-block:calc(var(--spacing) * 1)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-4{padding-block:calc(var(--spacing) * 4)}.py-6{padding-block:calc(var(--spacing) * 6)}.py-8{padding-block:calc(var(--spacing) * 8)}.py-10{padding-block:calc(var(--spacing) * 10)}.pt-10{padding-top:calc(var(--spacing) * 10)}.pt-24{padding-top:calc(var(--spacing) * 24)}.pr-1{padding-right:calc(var(--spacing) * 1)}.pr-1\.5{padding-right:calc(var(--spacing) * 1.5)}.pr-6{padding-right:calc(var(--spacing) * 6)}.pb-1{padding-bottom:calc(var(--spacing) * 1)}.pb-2{padding-bottom:calc(var(--spacing) * 2)}.pb-6{padding-bottom:calc(var(--spacing) * 6)}.pl-0\.5{padding-left:calc(var(--spacing) * .5)}.pl-2{padding-left:calc(var(--spacing) * 2)}.pl-3{padding-left:calc(var(--spacing) * 3)}.pl-5{padding-left:calc(var(--spacing) * 5)}.text-center{text-align:center}.text-left{text-align:left}.align-top{vertical-align:top}.font-mono{font-family:var(--font-mono)}.text-body{letter-spacing:-.154px;font-size:14px;line-height:20px}.text-caption{font-size:12px;line-height:16px}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[11px\]{font-size:11px}.text-\[13px\]{font-size:13px}.text-\[17px\]{font-size:17px}.text-\[32px\]{font-size:32px}.text-\[40px\]{font-size:40px}.leading-4{--tw-leading:calc(var(--spacing) * 4);line-height:calc(var(--spacing) * 4)}.leading-10{--tw-leading:calc(var(--spacing) * 10);line-height:calc(var(--spacing) * 10)}.leading-\[1\.2\]{--tw-leading:1.2;line-height:1.2}.leading-\[22px\]{--tw-leading:22px;line-height:22px}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-normal{--tw-font-weight:var(--font-weight-normal);font-weight:var(--font-weight-normal)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-\[-0\.442px\]{--tw-tracking:-.442px;letter-spacing:-.442px}.tracking-\[-1\.55px\]{--tw-tracking:-1.55px;letter-spacing:-1.55px}.whitespace-nowrap{white-space:nowrap}.text-dark-ink{color:var(--color-dark-ink)}.text-dark-ink-muted{color:var(--color-dark-ink-muted)}.text-ink{color:var(--color-ink)}.text-ink-faint{color:var(--color-ink-faint)}.text-ink-fainter{color:var(--color-ink-fainter)}.text-ink-muted{color:var(--color-ink-muted)}.text-mismatch-ink{color:var(--color-mismatch-ink)}.text-nav-ink{color:var(--color-nav-ink)}.text-sidebar-ink{color:var(--color-sidebar-ink)}.text-sidebar-ink-muted{color:var(--color-sidebar-ink-muted)}.text-sidebar-ink-strong{color:var(--color-sidebar-ink-strong)}.text-white{color:var(--color-white)}.opacity-0{opacity:0}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-\[0_4px_12px_rgb\(0_0_0\/10\%\)\]{--tw-shadow:0 4px 12px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-\[0_12px_40px_rgb\(0_0_0\/25\%\)\]{--tw-shadow:0 12px 40px var(--tw-shadow-color,#00000040);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}@media (hover:hover){.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}}.last\:border-b-0:last-child{border-bottom-style:var(--tw-border-style);border-bottom-width:0}@media (hover:hover){.hover\:bg-sidebar-active:hover{background-color:var(--color-sidebar-active)}.hover\:bg-ui-hover:hover{background-color:var(--color-ui-hover)}.hover\:opacity-90:hover{opacity:.9}}.focus-visible\:opacity-100:focus-visible{opacity:1}}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}

package/dist/index.html

@@ -4,8 +4,8 @@
 		<meta charset="UTF-8" />
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<title>Workers local shell</title>
-		<script type="module" crossorigin src="/assets/index-CHk4nghz.js"></script>
-		<link rel="stylesheet" crossorigin href="/assets/index-x1e1jng3.css">
+		<script type="module" crossorigin src="/assets/index-BWWoeYho.js"></script>
+		<link rel="stylesheet" crossorigin href="/assets/index-D7A1CDPg.css">
 	</head>
 	<body>
 		<div id="root"></div>

package/dist-cli/block-server.js

@@ -74,6 +74,14 @@ export default {
 	...resolved,
 	root: here("${toRoot}"),
 	cacheDir: here("${toCache}"),
+	define: {
+		...(resolved.define ?? {}),
+		// Initialization handshake scenarios fixture uses this key to identify the
+		// selected scenario, via the custom block capability key. The key needs to be
+		// serialized as a JavaScript string literal, then serialized again for this
+		// generated config.
+		"import.meta.env.VITE_CUSTOM_BLOCK_KEY": ${JSON.stringify(JSON.stringify(key))},
+	},
 	plugins: [serveWorkerManifest, ...(resolved.plugins ?? [])],
 }
 `);

package/dist-cli/convert-values.js

@@ -0,0 +1,241 @@
+import * as v from "valibot";
+import { unreachable } from "./utils.js";
+/**
+ * Convert one public API property value object to a local data source value.
+ * Returns undefined for empty values (blank cells are normal API output; the
+ * key is omitted from the row).
+ */
+export function convertPublicApiPropertyValue(publicType, value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const payload = value[publicType];
+    if (payload === null || payload === undefined) {
+        return undefined;
+    }
+    switch (publicType) {
+        case "title":
+        case "rich_text":
+            return payload
+                .map(part => part.plain_text ?? "")
+                .join("");
+        case "number":
+            return payload;
+        case "checkbox":
+            return payload;
+        case "url":
+        case "email":
+        case "phone_number":
+            return payload;
+        case "select":
+        case "status":
+            return payload.name;
+        case "multi_select":
+            return payload.map(option => option.name ?? "");
+        case "date":
+            return publicDateToLocal(payload);
+        case "people":
+            return payload.map(user => ({
+                id: user.id,
+                table: "notion_user",
+            }));
+        case "files":
+            return filesToText(payload);
+        case "relation":
+            return payload.map(target => ({
+                id: target.id,
+                table: "block",
+            }));
+        case "unique_id": {
+            const uniqueId = payload;
+            return uniqueId.prefix
+                ? `${uniqueId.prefix}-${uniqueId.number}`
+                : String(uniqueId.number);
+        }
+        // The production host still serializes formula, rollup, and
+        // last_visited_time as plain text. Match it so fixtures predict what a
+        // block receives from the real host.
+        case "formula":
+            return formulaToText(payload);
+        case "rollup":
+            return rollupToText(payload);
+        case "last_visited_time":
+            return payload;
+        case "created_time":
+        case "last_edited_time":
+            return timestampToLocal(payload);
+        case "created_by":
+        case "last_edited_by":
+            return [{ id: payload.id, table: "notion_user" }];
+        case "verification":
+            return payload.state;
+        case "button":
+            // Buttons carry no data; there is nothing to sample.
+            return undefined;
+        case "place":
+        case "location":
+            // No public API payload converter yet: keep something inspectable.
+            return JSON.stringify(payload);
+        default:
+            return unreachable(publicType);
+    }
+}
+function filesToText(files) {
+    return files
+        .map(file => file.name ?? "")
+        .filter(name => name.length > 0)
+        .join(", ");
+}
+function formulaToText(formula) {
+    switch (formula.type) {
+        case "string":
+            return formula.string ?? undefined;
+        case "number":
+            return formula.number != null ? String(formula.number) : undefined;
+        case "boolean":
+            return formula.boolean != null ? String(formula.boolean) : undefined;
+        case "date":
+            return formula.date ? dateToText(formula.date) : undefined;
+        default:
+            return undefined;
+    }
+}
+function rollupToText(rollup) {
+    switch (rollup.type) {
+        case "number":
+            return rollup.number != null ? String(rollup.number) : undefined;
+        case "date":
+            return rollup.date ? dateToText(rollup.date) : undefined;
+        default: {
+            const raw = rollup.type === undefined
+                ? undefined
+                : rollup[rollup.type];
+            return raw === null || raw === undefined ? undefined : JSON.stringify(raw);
+        }
+    }
+}
+/**
+ * Best-effort text for a public API date payload: matches production's
+ * string shape, not its exact date formatting.
+ */
+function dateToText(date) {
+    return date.end ? `${date.start} → ${date.end}` : date.start;
+}
+/**
+ * Public API date value (`{ start, end, time_zone }`, ISO 8601 strings) to
+ * the local `NotionDateValue` shape. Date-only starts become `date` /
+ * `daterange`; timestamped starts become `datetime` / `datetimerange`.
+ */
+function publicDateToLocal(date) {
+    const start = date.start;
+    const end = date.end ?? undefined;
+    const timeZone = date.time_zone ?? undefined;
+    if (!start.includes("T")) {
+        return end === undefined
+            ? { type: "date", start_date: start.slice(0, 10) }
+            : {
+                type: "daterange",
+                start_date: start.slice(0, 10),
+                end_date: end.slice(0, 10),
+            };
+    }
+    if (end === undefined) {
+        return {
+            type: "datetime",
+            start_date: start.slice(0, 10),
+            start_time: start.slice(11, 16),
+            ...(timeZone !== undefined ? { time_zone: timeZone } : {}),
+        };
+    }
+    return {
+        type: "datetimerange",
+        start_date: start.slice(0, 10),
+        start_time: start.slice(11, 16),
+        end_date: end.slice(0, 10),
+        end_time: end.slice(11, 16),
+        ...(timeZone !== undefined ? { time_zone: timeZone } : {}),
+    };
+}
+function timestampToLocal(timestamp) {
+    return timestamp.includes("T")
+        ? {
+            type: "datetime",
+            start_date: timestamp.slice(0, 10),
+            start_time: timestamp.slice(11, 16),
+        }
+        : { type: "date", start_date: timestamp.slice(0, 10) };
+}
+const stringValue = v.string();
+const numberValue = v.pipe(v.number(), v.finite());
+const booleanValue = v.boolean();
+const stringArrayValue = v.array(v.string());
+const pointerArrayValue = v.array(v.object({ id: v.string(), table: v.string() }));
+const dateValue = v.variant("type", [
+    v.object({ type: v.literal("date"), start_date: v.string() }),
+    v.object({
+        type: v.literal("daterange"),
+        start_date: v.string(),
+        end_date: v.string(),
+    }),
+    v.object({
+        type: v.literal("datetime"),
+        start_date: v.string(),
+        start_time: v.string(),
+    }),
+    v.object({
+        type: v.literal("datetimerange"),
+        start_date: v.string(),
+        start_time: v.string(),
+        end_date: v.string(),
+        end_time: v.string(),
+    }),
+]);
+const anyLocalValue = v.union([
+    stringValue,
+    numberValue,
+    booleanValue,
+    dateValue,
+    stringArrayValue,
+    pointerArrayValue,
+]);
+const _valueUnionsMatch = true;
+void _valueUnionsMatch;
+/**
+ * The value shape each property type must hold in a local file. Mirrors the
+ * production host's serialization: the types production still serializes as
+ * text are pinned to strings here, deliberately stricter than the dev
+ * shell's binding-time checks.
+ */
+const VALUE_SCHEMAS = {
+    title: stringValue,
+    rich_text: stringValue,
+    url: stringValue,
+    email: stringValue,
+    phone_number: stringValue,
+    select: stringValue,
+    status: stringValue,
+    number: numberValue,
+    checkbox: booleanValue,
+    multi_select: stringArrayValue,
+    date: dateValue,
+    created_time: dateValue,
+    last_edited_time: dateValue,
+    people: pointerArrayValue,
+    relation: pointerArrayValue,
+    created_by: pointerArrayValue,
+    last_edited_by: pointerArrayValue,
+    unique_id: stringValue,
+    files: stringValue,
+    formula: stringValue,
+    rollup: stringValue,
+    verification: stringValue,
+    place: stringValue,
+    location: stringValue,
+    last_visited_time: stringValue,
+};
+export function matchesPropertyType(value, type) {
+    return v.is(VALUE_SCHEMAS[type] ?? anyLocalValue, value);
+}
+export function isDataSourceValue(value) {
+    return v.is(anyLocalValue, value);
+}

package/dist-cli/convert.js

@@ -0,0 +1,227 @@
+/**
+ * `convert` subcommand: translate a sampled Notion data source (public API
+ * shapes: schema `properties`, query `results`) into the dev shell's local
+ * JSON data source format, validate the result, and print it to stdout.
+ * `ntn customblocks sample` pipes through this via stdin; it also runs
+ * standalone: `npx @notionhq/custom-blocks-dev-shell convert --in sample.json`.
+ */
+import { readFileSync } from "node:fs";
+import * as v from "valibot";
+import { convertPublicApiPropertyValue, isDataSourceValue, matchesPropertyType, } from "./convert-values.js";
+import { NOTION_PROPERTY_TYPES, sourceFileSchema } from "./data-sources.js";
+import { claimUniqueKey, slugify } from "./utils.js";
+const SUPPORTED_TYPES = new Set(NOTION_PROPERTY_TYPES);
+/** The spelling of "text" in the local file format. */
+const UNSUPPORTED_TYPE_FALLBACK = "rich_text";
+export function parseConvertArgs(argv) {
+    const args = {
+        input: undefined,
+        key: undefined,
+        name: undefined,
+    };
+    const takeValue = (name, index) => {
+        const value = argv[index];
+        if (value === undefined || value.startsWith("--")) {
+            throw new Error(`${name} requires a value.`);
+        }
+        return value;
+    };
+    for (let index = 0; index < argv.length; index++) {
+        const arg = argv[index];
+        if (arg === "--in") {
+            args.input = takeValue("--in", ++index);
+        }
+        else if (arg.startsWith("--in=")) {
+            args.input = arg.slice("--in=".length);
+        }
+        else if (arg === "--key") {
+            args.key = takeValue("--key", ++index);
+        }
+        else if (arg.startsWith("--key=")) {
+            args.key = arg.slice("--key=".length);
+        }
+        else if (arg === "--name") {
+            args.name = takeValue("--name", ++index);
+        }
+        else if (arg.startsWith("--name=")) {
+            args.name = arg.slice("--name=".length);
+        }
+        else {
+            throw new Error(`Unknown convert option "${arg}". Supported: --in <file>, --key <key>, --name <name>.`);
+        }
+    }
+    return args;
+}
+const sampleInputSchema = v.pipe(v.looseObject({
+    name: v.optional(v.string()),
+    properties: v.optional(v.record(v.string(), v.looseObject({ type: v.string() }))),
+    results: v.optional(v.array(v.looseObject({
+        id: v.string(),
+        properties: v.optional(v.record(v.string(), v.unknown())),
+    }))),
+}), v.check(input => input.properties !== undefined || input.results !== undefined, "expected a schema under `properties` and/or sampled pages under `results`"));
+/**
+ * Convert a sampled data source (public API shapes) into a local data source
+ * object. The input carries the schema under `properties` and/or sampled
+ * pages under `results` (query output verbatim). The emitted object always
+ * carries a `schema` — taken from `properties` when present, otherwise
+ * inferred from the row values — because the shell derives table columns and
+ * bindings from the schema alone.
+ */
+export function convertSample(input, overrides = {}) {
+    const parsed = v.safeParse(sampleInputSchema, input);
+    if (!parsed.success) {
+        const issue = parsed.issues[0];
+        const path = v.getDotPath(issue);
+        throw new Error(`Input is not a sampled data source: ${path ? `${path}: ` : ""}${issue.message}`);
+    }
+    const sample = parsed.output;
+    const warnings = [];
+    const mappings = buildPropertyMappings(sample.properties, sample.results, warnings);
+    const key = overrides.key ?? slugify(sample.name ?? "") ?? "data_source";
+    const name = overrides.name ?? (sample.name || undefined) ?? key;
+    const schema = {};
+    for (const mapping of mappings.values()) {
+        schema[mapping.key] = { name: mapping.name, type: mapping.type };
+    }
+    const source = {
+        type: "syncedFromProd",
+        key,
+        name,
+        schema,
+        rows: (sample.results ?? []).map(row => convertRow(row, mappings)),
+    };
+    validateSource(source);
+    return { source, warnings };
+}
+/**
+ * One mapping per public property name. For schema-only and full samples the
+ * mappings come from `properties`; for rows-only samples they are derived
+ * from the `type` field each row value carries.
+ */
+function buildPropertyMappings(properties, sampledRows, warnings) {
+    const mappings = new Map();
+    // `id` is the row identifier; a property named "ID" must not overwrite it.
+    const usedKeys = new Set(["id"]);
+    const add = (propertyName, publicType) => {
+        if (mappings.has(propertyName)) {
+            return;
+        }
+        const unsupported = !SUPPORTED_TYPES.has(publicType);
+        if (unsupported) {
+            warnings.push(`Property ${JSON.stringify(propertyName)}: public API type ` +
+                `${JSON.stringify(publicType)} is not supported by custom blocks; ` +
+                `converted to text ("${UNSUPPORTED_TYPE_FALLBACK}") with the ` +
+                `placeholder value ${JSON.stringify(`unsupported type: ${publicType}`)}.`);
+        }
+        mappings.set(propertyName, {
+            key: claimUniqueKey(slugify(propertyName) ?? "property", usedKeys),
+            name: propertyName,
+            type: unsupported ? UNSUPPORTED_TYPE_FALLBACK : publicType,
+            publicType,
+            unsupported,
+        });
+    };
+    for (const [propertyName, property] of Object.entries(properties ?? {})) {
+        add(propertyName, property.type);
+    }
+    for (const row of sampledRows ?? []) {
+        for (const [propertyName, value] of Object.entries(row.properties ?? {})) {
+            const publicType = value?.type;
+            if (typeof publicType === "string") {
+                add(propertyName, publicType);
+            }
+        }
+    }
+    return mappings;
+}
+function convertRow(row, mappings) {
+    const converted = { id: row.id };
+    for (const [propertyName, value] of Object.entries(row.properties ?? {})) {
+        const mapping = mappings.get(propertyName);
+        if (mapping === undefined) {
+            continue;
+        }
+        if (mapping.unsupported) {
+            converted[mapping.key] = `unsupported type: ${mapping.publicType}`;
+            continue;
+        }
+        const local = convertPublicApiPropertyValue(mapping.publicType, value);
+        if (local !== undefined) {
+            converted[mapping.key] = local;
+        }
+    }
+    return converted;
+}
+/**
+ * Validate the built source the same way the dev shell will at spin-up, plus
+ * a row-value pass the loader doesn't do: every emitted value must match its
+ * declared schema type. Failures here are conversion bugs or malformed input;
+ * the command must never print a file the shell would reject.
+ */
+export function validateSource(source) {
+    const hasSchema = source.schema !== undefined;
+    const result = v.safeParse(sourceFileSchema, source);
+    if (!result.success) {
+        const issue = result.issues[0];
+        const path = v.getDotPath(issue);
+        throw new Error(`Converted data source is invalid: ${path ? `${path}: ` : ""}${issue.message}`);
+    }
+    const schema = (source.schema ?? {});
+    const rows = (source.rows ?? []);
+    const issues = [];
+    for (const row of rows) {
+        for (const [key, value] of Object.entries(row)) {
+            if (key === "id") {
+                continue;
+            }
+            const declared = hasSchema ? schema[key] : undefined;
+            if (hasSchema && declared === undefined) {
+                issues.push(`row ${JSON.stringify(row.id)}: ${JSON.stringify(key)} is not in the schema`);
+                continue;
+            }
+            const matches = declared
+                ? matchesPropertyType(value, declared.type)
+                : isDataSourceValue(value);
+            if (!matches) {
+                issues.push(`row ${JSON.stringify(row.id)}: ${JSON.stringify(key)} does not match ${declared ? `type ${JSON.stringify(declared.type)}` : "any supported value shape"}`);
+            }
+        }
+    }
+    if (issues.length > 0) {
+        throw new Error(`Converted rows are invalid: ${issues.join("; ")}`);
+    }
+}
+export async function runConvert(argv) {
+    const args = parseConvertArgs(argv);
+    let raw;
+    if (args.input !== undefined) {
+        try {
+            raw = readFileSync(args.input, "utf-8");
+        }
+        catch (error) {
+            throw new Error(`Could not read ${args.input}: ${error.message}`);
+        }
+    }
+    else {
+        if (process.stdin.isTTY) {
+            throw new Error("No input: pipe `ntn customblocks sample` output to convert, or pass --in <file>.");
+        }
+        raw = readFileSync(0, "utf-8");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Input is not valid JSON — ${error.message}`);
+    }
+    const { source, warnings } = convertSample(parsed, {
+        ...(args.key !== undefined ? { key: args.key } : {}),
+        ...(args.name !== undefined ? { name: args.name } : {}),
+    });
+    for (const warning of warnings) {
+        console.warn(warning);
+    }
+    process.stdout.write(`${JSON.stringify(source, null, "\t")}\n`);
+}

package/dist-cli/data-sources.js

@@ -17,7 +17,7 @@ const DEV_SHELL_DATA_SOURCE_TYPES = [
 // plain node, which can't import the SDK's published TS source at runtime.
 // The `satisfies` below plus the type-only import keep the two lists locked
 // together — a drift on either side fails typecheck.
-const NOTION_PROPERTY_TYPES = [
+export const NOTION_PROPERTY_TYPES = [
     "title",
     "rich_text",
     "number",
@@ -57,8 +57,8 @@ export function readDataSources(dataDir) {
         .sort((left, right) => left.name.localeCompare(right.name));
 }
 const nonEmptyString = v.pipe(v.string(), v.nonEmpty());
-const sourceFileSchema = v.object({
-    type: v.optional(v.literal("worker"), "worker"),
+export const sourceFileSchema = v.object({
+    type: v.optional(v.picklist(DEV_SHELL_DATA_SOURCE_TYPES), "worker"),
     key: v.optional(nonEmptyString),
     name: v.optional(nonEmptyString),
     icon: v.optional(v.string()),

package/dist-cli/main.js

@@ -1,6 +1,6 @@
 /**
  * Entry point for the published dev-shell CLI (`npx`-run from a worker
- * project). Mirrors the worker mode of the repo's `scripts/dev.ts`: build the
+ * project). Mirrors the repo's `scripts/dev.ts`: build the
  * worker, extract its manifest, serve one Vite dev server per custom block
  * (using the worker's own Vite install), and serve the prebuilt dev-shell UI
  * with the block registry injected at runtime.
@@ -11,6 +11,7 @@ import { createRequire } from "node:module";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { BLOCK_BASE_PORT, buildBlockRegistry, SHELL_PORT, writeBlockViteConfig, } from "./block-server.js";
+import { runConvert } from "./convert.js";
 import { readDataSources } from "./data-sources.js";
 import { materializeWorkerSchemaDataSources } from "./materialize.js";
 import { serveUi } from "./serve-ui.js";
@@ -102,7 +103,14 @@ function resolveViteBin(workerDir) {
 }
 const procs = [];
 async function main() {
-    const cliArgs = parseCliArgs(process.argv.slice(2));
+    const argv = process.argv.slice(2);
+    // One-shot subcommands return before any dev-server machinery starts;
+    // with no subcommand the CLI is the dev shell, as it always was.
+    if (argv[0] === "convert") {
+        await runConvert(argv.slice(1));
+        return;
+    }
+    const cliArgs = parseCliArgs(argv);
     const workerDir = resolveWorkerDir(cliArgs.worker);
     if (!existsSync(resolve(workerDir, "node_modules"))) {
         throw new Error(`No node_modules in ${workerDir}. Install the worker's dependencies first ` +
@@ -172,7 +180,6 @@ async function main() {
     }
     try {
         await serveUi(distDir, cliArgs.shellPort, {
-            mode: "worker",
             blocks: registry,
             dataSources,
         });
@@ -218,7 +225,7 @@ function shutdown(signal) {
         return;
     }
     shuttingDown = true;
-    if (signal !== "exit") {
+    if (signal !== "exit" && procs.length > 0) {
         console.log(`\n${dim}Shutting down...${reset}`);
     }
     for (const p of procs) {

package/dist-cli/materialize.js

@@ -16,7 +16,7 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { blockCapabilities } from "./worker-manifest.js";
-// Worker authoring type names → public data-source (NotionPropertyType) names.
+// Worker authoring type names → public data source (NotionPropertyType) names.
 const TYPE_ALIASES = {
     text: "rich_text",
     file: "files",

package/dist-cli/utils.js

@@ -0,0 +1,26 @@
+/**
+ * Throws when a discriminated union switch is not exhaustive.
+ */
+export function unreachable(value) {
+    throw new Error(`[custom-blocks-dev-shell] Unexpected value encountered: ${JSON.stringify(value)}`);
+}
+/** Lowercase, non-alphanumerics collapsed to `_`; undefined when nothing survives. */
+export function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    return slug.length > 0 ? slug : undefined;
+}
+/**
+ * Claim `base` as a key in `used`, suffixing `_2`, `_3`, … while it is
+ * already taken. Mutates `used` so later claims see this one.
+ */
+export function claimUniqueKey(base, used) {
+    let key = base;
+    for (let counter = 2; used.has(key); counter++) {
+        key = `${base}_${counter}`;
+    }
+    used.add(key);
+    return key;
+}

package/docs/bindings.md

@@ -2,7 +2,7 @@
 
 The shell lists your worker's blocks in the sidebar and renders the selected
 block in a mock Notion host. Blocks start fully unbound: nothing renders
-until every data-source slot the block declares is connected to a source and
+until every data source slot the block declares is connected to a source and
 every declared property is mapped.
 
 ## Connecting data