@vibesdotdev/platform 0.0.0-stage → 1.0.0-rc.2

package/dist/schemas/components/starter-fixtures.js

@@ -0,0 +1,208 @@
+/**
+ * A minimal "form" starter — the simplest applet: collects user input.
+ * Svelte entrypoint; applet-owned storage for submissions (instance) and
+ * draft values (viewer); a submit event; one optional capability request
+ * (notification.send) with a user-facing reason.
+ */
+export const FORM_STARTER = {
+    contractVersion: 1,
+    name: 'Form',
+    description: 'A minimal applet that collects structured user input and emits a submit event.',
+    entrypoint: { kind: 'svelte', path: 'applet.svelte' },
+    props: {
+        title: { type: 'string', description: 'Form title' },
+        fields: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    label: { type: 'string' },
+                    type: { type: 'string', enum: ['text', 'number', 'email', 'choice'] },
+                    required: { type: 'boolean' }
+                }
+            }
+        }
+    },
+    storage: [
+        {
+            id: 'submissions',
+            authority: 'applet-owned',
+            scope: 'instance',
+            schemaVersion: 1,
+            recordSchema: {
+                type: 'object',
+                properties: {
+                    values: { type: 'object' },
+                    submittedAt: { type: 'string', format: 'date-time' }
+                },
+                required: ['values']
+            }
+        },
+        {
+            id: 'draft-values',
+            authority: 'applet-owned',
+            scope: 'viewer',
+            schemaVersion: 1,
+            recordSchema: {
+                type: 'object',
+                properties: { values: { type: 'object' } }
+            }
+        }
+    ],
+    events: [
+        {
+            type: 'submit',
+            payload: {
+                values: { type: 'object' }
+            }
+        }
+    ],
+    capabilities: [
+        {
+            tag: 'notification.send',
+            reason: 'Notifies you when someone submits the form.',
+            required: false
+        }
+    ],
+    motion: {
+        duration: 200,
+        entrance: true,
+        respectReducedMotion: true
+    },
+    scenarios: [
+        {
+            name: 'empty-form',
+            description: 'A fresh form with no values entered.',
+            props: {
+                title: 'Contact Us',
+                fields: [
+                    { name: 'email', label: 'Email', type: 'email', required: true },
+                    { name: 'message', label: 'Message', type: 'text', required: true }
+                ]
+            },
+            expectedState: { submitted: false, values: {} }
+        },
+        {
+            name: 'filled-form',
+            description: 'A form with values entered but not yet submitted.',
+            props: {
+                title: 'Contact Us',
+                fields: [
+                    { name: 'email', label: 'Email', type: 'email', required: true },
+                    { name: 'message', label: 'Message', type: 'text', required: true }
+                ]
+            },
+            expectedState: {
+                submitted: false,
+                values: { email: 'test@example.com', message: 'Hello' }
+            }
+        },
+        {
+            name: 'submitted-form',
+            description: 'A form that has been submitted.',
+            props: {
+                title: 'Contact Us',
+                fields: [
+                    { name: 'email', label: 'Email', type: 'email', required: true },
+                    { name: 'message', label: 'Message', type: 'text', required: true }
+                ]
+            },
+            expectedState: { submitted: true, values: { email: 'test@example.com', message: 'Hello' } }
+        }
+    ]
+};
+/**
+ * A "choice" starter — presents options and records a selection.
+ * HTML entrypoint (`window.vibes`); applet-owned storage for selections
+ * (instance); a choose event; one optional capability request
+ * (workboard.create) with a user-facing reason.
+ */
+export const CHOICE_STARTER = {
+    contractVersion: 1,
+    name: 'Choice',
+    description: 'Presents options and records a selection. Emits a choose event.',
+    entrypoint: { kind: 'svelte', path: 'Applet.svelte' },
+    props: {
+        question: { type: 'string', description: 'The question to ask' },
+        options: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    label: { type: 'string' },
+                    description: { type: 'string' }
+                }
+            }
+        }
+    },
+    storage: [
+        {
+            id: 'selections',
+            authority: 'applet-owned',
+            scope: 'instance',
+            schemaVersion: 1,
+            recordSchema: {
+                type: 'object',
+                properties: {
+                    optionId: { type: 'string' },
+                    chosenAt: { type: 'string', format: 'date-time' }
+                },
+                required: ['optionId']
+            }
+        }
+    ],
+    events: [
+        {
+            type: 'choose',
+            payload: {
+                optionId: { type: 'string' }
+            }
+        }
+    ],
+    capabilities: [
+        {
+            tag: 'workboard.create',
+            reason: 'Creates a workboard item for the winning choice.',
+            required: false
+        }
+    ],
+    motion: {
+        duration: 200,
+        entrance: true,
+        respectReducedMotion: true
+    },
+    scenarios: [
+        {
+            name: 'no-selection',
+            description: 'A choice applet with no option selected.',
+            props: {
+                question: 'Which plan do you prefer?',
+                options: [
+                    { id: 'basic', label: 'Basic', description: 'For individuals' },
+                    { id: 'pro', label: 'Pro', description: 'For teams' }
+                ]
+            },
+            expectedState: { selectedOptionId: null }
+        },
+        {
+            name: 'with-selection',
+            description: 'A choice applet with an option selected.',
+            props: {
+                question: 'Which plan do you prefer?',
+                options: [
+                    { id: 'basic', label: 'Basic', description: 'For individuals' },
+                    { id: 'pro', label: 'Pro', description: 'For teams' }
+                ]
+            },
+            expectedState: { selectedOptionId: 'pro' }
+        }
+    ]
+};
+/** All canonical starter fixtures. */
+export const STARTER_FIXTURES = {
+    form: FORM_STARTER,
+    choice: CHOICE_STARTER
+};
+//# sourceMappingURL=starter-fixtures.js.map

package/dist/schemas/components/starter-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-fixtures.js","sourceRoot":"","sources":["../../../src/schemas/components/starter-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/schemas/components/starter.d.ts

@@ -0,0 +1,429 @@
+/**
+ * Applet starter contract — the versioned authoring contract a new Applet
+ * Component starts from. Owned by the Platform component family (Platform owns
+ * Component source, manifests, and releases); VibesKit owns only the UI
+ * primitives (theme/motion/accessibility) the starter's components compose.
+ *
+ * A component author building an Applet declares:
+ * - Entrypoint (one HTML or Svelte file — this fixes the browser-runtime
+ *   binding: HTML receives the minimized client as `window.vibes`, Svelte
+ *   receives it through the `vibes` prop)
+ * - Props declaration (what the host injects)
+ * - Applet-owned storage declarations (instance/viewer scoped — the storage
+ *   the runtime binds without any capability grant)
+ * - Event declarations (what the applet emits)
+ * - Capability requests with user-facing reasons (browsing-user/external
+ *   authority only; applet-owned storage is deliberately not a capability)
+ * - Loading/empty/error/form/choice UI states (composed from VibesKit
+ *   primitives; coverage is checked by the component preflight)
+ * - Motion preferences (reduced-motion-aware)
+ * - Scenario fixtures (test cases for draft preview)
+ *
+ * This module is the pure schema + contract validator. It mirrors the Applets
+ * definition contract (`@vibesdotdev/applets` `appletDefinitionManifestSchema`)
+ * BY VALUE — platform does not import applets (the package edge runs the other
+ * way); the applets package's composition tests lock the mirror. Helpers:
+ * `starterComponentManifest()` derives the author-declared
+ * `componentManifestSchema` record, and `starterDefinitionSkeleton()` seeds
+ * the immutable Applet definition manifest (the build completes the file
+ * inventory and Asset references). No second executable definition.
+ */
+import * as z from 'zod/v4';
+import { boundedJsonValueSchema } from '@vibesdotdev/shared/schemas';
+import type { ComponentManifest } from './common.ts';
+/**
+ * Starter contract version — incremented when the contract changes.
+ * Authors pin to an exact version; migration is explicit.
+ */
+export declare const STARTER_CONTRACT_VERSION: 1;
+/**
+ * The Applet DEFINITION MANIFEST version a starter seeds — a different namespace
+ * from `STARTER_CONTRACT_VERSION`, which versions the author-facing starter.
+ *
+ * They were conflated: the skeleton emitted `schemaVersion: starter.contractVersion`,
+ * so a starter could only ever produce a v1 manifest, and v1 forbids
+ * `contributes`. A starter could therefore never declare a contributed tool no
+ * matter what else changed. Two numbers that happened to both be 1 read as one
+ * concept until they had to disagree.
+ *
+ * Mirrors the applets manifest contract by value; `platform` cannot
+ * import `@vibesdotdev/applets` because the package edge runs the other way.
+ */
+export declare const APPLET_MANIFEST_SCHEMA_VERSION: 2;
+/**
+ * The brokered capability vocabulary, mirrored from
+ * `appletCapabilityKindSchema` in `@vibesdotdev/applets`.
+ *
+ * Free-form tags here meant a starter validated happily and then failed at BUILD
+ * with "Unknown Applet capability tag" — the author learns at the wrong moment,
+ * from the wrong layer. Mirrored by value because the package edge runs the
+ * other way; the applets-side composition test locks the two together.
+ */
+export declare const starterCapabilityKindSchema: z.ZodEnum<{
+    "storage.read": "storage.read";
+    "storage.write": "storage.write";
+    "network.fetch": "network.fetch";
+    "clipboard.read": "clipboard.read";
+    "clipboard.write": "clipboard.write";
+    "geolocation.read": "geolocation.read";
+    "notification.send": "notification.send";
+    "workboard.create": "workboard.create";
+    "workboard.update": "workboard.update";
+    "applet.snapshot.create": "applet.snapshot.create";
+    "applet.snapshot.update": "applet.snapshot.update";
+    "output.create": "output.create";
+    "output.update": "output.update";
+}>;
+/**
+ * The canonical applet UI states every starter must cover.
+ * Each maps to a component composed from VibesKit primitives; the component
+ * preflight checks coverage, this module checks the contract.
+ */
+export declare const STARTER_UI_STATES: readonly ["loading", "empty", "error", "form", "choice"];
+export type StarterUiState = (typeof STARTER_UI_STATES)[number];
+/**
+ * Entrypoint declaration — one Svelte file.
+ *
+ * `html` is deliberately NOT declarable here. Nothing compiles or serves an HTML
+ * entrypoint: `apps/platform-web`'s compiler runs `svelteCompile` and has no
+ * html branch, and the runner mounts through a compiled module's `__mount`
+ * export, which an HTML file does not have. A starter could declare one and
+ * never publish it.
+ *
+ * Declarable-and-unpublishable is the defect this branch removes, not a roadmap
+ * item — the same call already made for `indexes`. The applets MANIFEST still
+ * accepts `html` at schemaVersion 1, because published releases are immutable
+ * and digest-pinned and cannot be corrected in place; what changes is that no
+ * new one can be declared.
+ */
+export declare const starterEntrypointSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        svelte: "svelte";
+    }>;
+    path: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Applet-owned storage declaration — instance/viewer scoped records the
+ * runtime binds without a capability grant. Mirrors the Applets
+ * `appletOwnStorageDescriptorSchema` contract by value, FIELD FOR FIELD: a
+ * key this mirror omits is not merely unvalidated, it is silently stripped by
+ * the plain object parse, so the author's value disappears without an error
+ * and Applets never sees the declaration it would have rejected. Every key of
+ * the Applets descriptor must appear here with the same bounds; the applets
+ * package's composition tests lock the parity from the consumer side.
+ */
+export declare const starterStorageDeclarationSchema: z.ZodObject<{
+    id: z.ZodString;
+    authority: z.ZodDefault<z.ZodEnum<{
+        "applet-owned": "applet-owned";
+        "author-owned": "author-owned";
+        "viewer-owned": "viewer-owned";
+    }>>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        instance: "instance";
+        viewer: "viewer";
+    }>>;
+    schemaVersion: z.ZodNumber;
+    recordSchema: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>;
+    quotaBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Capability request — browsing-user or external authority with a user-facing
+ * reason. Applet-owned storage is deliberately not a capability. Mirrors the
+ * Applets `appletCapabilityRequestSchema` contract by value.
+ */
+export declare const starterCapabilityRequestSchema: z.ZodObject<{
+    tag: z.ZodEnum<{
+        "storage.read": "storage.read";
+        "storage.write": "storage.write";
+        "network.fetch": "network.fetch";
+        "clipboard.read": "clipboard.read";
+        "clipboard.write": "clipboard.write";
+        "geolocation.read": "geolocation.read";
+        "notification.send": "notification.send";
+        "workboard.create": "workboard.create";
+        "workboard.update": "workboard.update";
+        "applet.snapshot.create": "applet.snapshot.create";
+        "applet.snapshot.update": "applet.snapshot.update";
+        "output.create": "output.create";
+        "output.update": "output.update";
+    }>;
+    reason: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Motion preference for the starter — reduced-motion-aware. */
+export declare const starterMotionSchema: z.ZodObject<{
+    duration: z.ZodNumber;
+    entrance: z.ZodBoolean;
+    respectReducedMotion: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Event declaration — a typed event the applet emits. */
+export declare const starterEventDeclarationSchema: z.ZodObject<{
+    type: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/** Scenario fixture — a test case for draft preview. */
+export declare const starterScenarioSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    props: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>, z.ZodTransform<string | number | boolean | import("@vibesdotdev/kernel/schemas/json").JsonObject | import("@vibesdotdev/kernel/schemas/json").JsonArray | null, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+    expectedState: z.ZodOptional<z.ZodPipe<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>, z.ZodTransform<string | number | boolean | import("@vibesdotdev/kernel/schemas/json").JsonObject | import("@vibesdotdev/kernel/schemas/json").JsonArray | null, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strip>;
+/**
+ * KNOWN NARROWING, stated so it is not mistaken for an oversight: the starter
+ * mirror carries `tools` and `cli` only. `config` and `events` contributions,
+ * and CLI `arguments`/`options`, are expressible on the Applets manifest but
+ * NOT authorable through a starter yet. Unknown keys are refused loudly rather
+ * than stripped, so an author who tries gets an error instead of silence.
+ */
+export declare const starterContributesSchema: z.ZodObject<{
+    tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>;
+        outputSchema: z.ZodOptional<z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>>;
+        impl: z.ZodObject<{
+            surface: z.ZodEnum<{
+                server: "server";
+                client: "client";
+            }>;
+            entry: z.ZodString;
+            export: z.ZodString;
+        }, z.core.$strict>;
+        requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            "storage.read": "storage.read";
+            "storage.write": "storage.write";
+            "network.fetch": "network.fetch";
+            "clipboard.read": "clipboard.read";
+            "clipboard.write": "clipboard.write";
+            "geolocation.read": "geolocation.read";
+            "notification.send": "notification.send";
+            "workboard.create": "workboard.create";
+            "workboard.update": "workboard.update";
+            "applet.snapshot.create": "applet.snapshot.create";
+            "applet.snapshot.update": "applet.snapshot.update";
+            "output.create": "output.create";
+            "output.update": "output.update";
+        }>>>;
+    }, z.core.$strict>>>;
+    cli: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodString;
+        impl: z.ZodObject<{
+            surface: z.ZodEnum<{
+                server: "server";
+                client: "client";
+            }>;
+            entry: z.ZodString;
+            export: z.ZodString;
+        }, z.core.$strict>;
+        requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            "storage.read": "storage.read";
+            "storage.write": "storage.write";
+            "network.fetch": "network.fetch";
+            "clipboard.read": "clipboard.read";
+            "clipboard.write": "clipboard.write";
+            "geolocation.read": "geolocation.read";
+            "notification.send": "notification.send";
+            "workboard.create": "workboard.create";
+            "workboard.update": "workboard.update";
+            "applet.snapshot.create": "applet.snapshot.create";
+            "applet.snapshot.update": "applet.snapshot.update";
+            "output.create": "output.create";
+            "output.update": "output.update";
+        }>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type StarterContributes = z.infer<typeof starterContributesSchema>;
+export declare const appletStarterSchema: z.ZodObject<{
+    contractVersion: z.ZodLiteral<1>;
+    name: z.ZodString;
+    description: z.ZodString;
+    entrypoint: z.ZodObject<{
+        kind: z.ZodEnum<{
+            svelte: "svelte";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strip>;
+    props: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>, z.ZodTransform<string | number | boolean | import("@vibesdotdev/kernel/schemas/json").JsonObject | import("@vibesdotdev/kernel/schemas/json").JsonArray | null, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+    storage: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        authority: z.ZodDefault<z.ZodEnum<{
+            "applet-owned": "applet-owned";
+            "author-owned": "author-owned";
+            "viewer-owned": "viewer-owned";
+        }>>;
+        scope: z.ZodDefault<z.ZodEnum<{
+            instance: "instance";
+            viewer: "viewer";
+        }>>;
+        schemaVersion: z.ZodNumber;
+        recordSchema: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>;
+        quotaBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    events: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tag: z.ZodEnum<{
+            "storage.read": "storage.read";
+            "storage.write": "storage.write";
+            "network.fetch": "network.fetch";
+            "clipboard.read": "clipboard.read";
+            "clipboard.write": "clipboard.write";
+            "geolocation.read": "geolocation.read";
+            "notification.send": "notification.send";
+            "workboard.create": "workboard.create";
+            "workboard.update": "workboard.update";
+            "applet.snapshot.create": "applet.snapshot.create";
+            "applet.snapshot.update": "applet.snapshot.update";
+            "output.create": "output.create";
+            "output.update": "output.update";
+        }>;
+        reason: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    motion: z.ZodObject<{
+        duration: z.ZodNumber;
+        entrance: z.ZodBoolean;
+        respectReducedMotion: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    scenarios: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        props: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>, z.ZodTransform<string | number | boolean | import("@vibesdotdev/kernel/schemas/json").JsonObject | import("@vibesdotdev/kernel/schemas/json").JsonArray | null, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+        expectedState: z.ZodOptional<z.ZodPipe<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>, z.ZodTransform<string | number | boolean | import("@vibesdotdev/kernel/schemas/json").JsonObject | import("@vibesdotdev/kernel/schemas/json").JsonArray | null, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$strip>>;
+    contributes: z.ZodOptional<z.ZodObject<{
+        tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            inputSchema: z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>;
+            outputSchema: z.ZodOptional<z.ZodPipe<z.ZodCustom<import("@vibesdotdev/shared/types").RecordObject, import("@vibesdotdev/shared/types").RecordObject>, z.ZodTransform<import("@vibesdotdev/shared/types").JsonObject, import("@vibesdotdev/shared/types").RecordObject>>>;
+            impl: z.ZodObject<{
+                surface: z.ZodEnum<{
+                    server: "server";
+                    client: "client";
+                }>;
+                entry: z.ZodString;
+                export: z.ZodString;
+            }, z.core.$strict>;
+            requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                "storage.read": "storage.read";
+                "storage.write": "storage.write";
+                "network.fetch": "network.fetch";
+                "clipboard.read": "clipboard.read";
+                "clipboard.write": "clipboard.write";
+                "geolocation.read": "geolocation.read";
+                "notification.send": "notification.send";
+                "workboard.create": "workboard.create";
+                "workboard.update": "workboard.update";
+                "applet.snapshot.create": "applet.snapshot.create";
+                "applet.snapshot.update": "applet.snapshot.update";
+                "output.create": "output.create";
+                "output.update": "output.update";
+            }>>>;
+        }, z.core.$strict>>>;
+        cli: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            description: z.ZodString;
+            impl: z.ZodObject<{
+                surface: z.ZodEnum<{
+                    server: "server";
+                    client: "client";
+                }>;
+                entry: z.ZodString;
+                export: z.ZodString;
+            }, z.core.$strict>;
+            requires: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                "storage.read": "storage.read";
+                "storage.write": "storage.write";
+                "network.fetch": "network.fetch";
+                "clipboard.read": "clipboard.read";
+                "clipboard.write": "clipboard.write";
+                "geolocation.read": "geolocation.read";
+                "notification.send": "notification.send";
+                "workboard.create": "workboard.create";
+                "workboard.update": "workboard.update";
+                "applet.snapshot.create": "applet.snapshot.create";
+                "applet.snapshot.update": "applet.snapshot.update";
+                "output.create": "output.create";
+                "output.update": "output.update";
+            }>>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type StarterEntrypoint = z.infer<typeof starterEntrypointSchema>;
+export type StarterStorageDeclaration = z.infer<typeof starterStorageDeclarationSchema>;
+export type StarterCapabilityRequest = z.infer<typeof starterCapabilityRequestSchema>;
+export type StarterMotion = z.infer<typeof starterMotionSchema>;
+export type StarterEventDeclaration = z.infer<typeof starterEventDeclarationSchema>;
+export type StarterScenario = z.infer<typeof starterScenarioSchema>;
+export type AppletStarter = z.infer<typeof appletStarterSchema>;
+/**
+ * The definition-manifest skeleton a starter seeds — entrypoint, storage, and
+ * capability requests. The build completes the immutable file inventory,
+ * Asset references, and composition pins before the Applets
+ * `appletDefinitionManifestSchema` validates the whole record.
+ */
+export interface StarterDefinitionSkeleton {
+    /** The APPLET manifest version — not the starter contract version. */
+    schemaVersion: typeof APPLET_MANIFEST_SCHEMA_VERSION;
+    contributes?: StarterContributes;
+    entrypoint: StarterEntrypoint;
+    storage: StarterStorageDeclaration[];
+    capabilities: StarterCapabilityRequest[];
+}
+/** Returns true if a value is a complete, valid starter contract. */
+export declare function isStarterComplete(starter: z.input<typeof boundedJsonValueSchema> | AppletStarter): starter is AppletStarter;
+/**
+ * Validates a starter and reports exactly what's missing — authoring feedback
+ * for the component preflight and draft preview.
+ */
+export declare function validateStarter(starter: unknown): {
+    ok: true;
+    value: AppletStarter;
+} | {
+    ok: false;
+    errors: string[];
+};
+/**
+ * Derives the author-declared Component manifest from a starter — the
+ * metadata record Platform pins on a Component release. Capability tags come
+ * from the starter's capability requests; the user-facing reasons ride in
+ * `extra` for the consent UI.
+ */
+export declare function starterComponentManifest(starter: AppletStarter, options?: {
+    surfaces?: string[];
+    shadowDom?: boolean;
+}): ComponentManifest;
+/**
+ * Seeds the Applet definition manifest from a starter. The result is a
+ * skeleton: the build adds the immutable file inventory (which must include
+ * the entrypoint), Asset references, and composition pins.
+ */
+export declare function starterDefinitionSkeleton(starter: AppletStarter): StarterDefinitionSkeleton;
+/**
+ * The named exports a starter's contributions require the compiled bundle to
+ * expose, in the compiler's terms.
+ *
+ * Deduplicated on the same `<entry>#<export>` key the compiler refuses
+ * duplicates on: a tool and a CLI command over one function is legitimate and
+ * must not become a publish failure. Server implementations are omitted — they
+ * are not in the browser bundle.
+ */
+export declare function starterCompileContributions(starter: AppletStarter): Array<{
+    entry: string;
+    exportName: string;
+}>;
+/**
+ * Returns the capability reasons as a user-facing map (tag → reason).
+ * Used by the consent UI to show why each capability is requested.
+ */
+export declare function capabilityReasonsMap(starter: AppletStarter): Record<string, string>;
+/** Returns true if a starter has at least one scenario fixture. */
+export declare function hasScenarios(starter: AppletStarter): boolean;
+/** Returns the default scenario (first one) for initial draft preview. */
+export declare function defaultScenario(starter: AppletStarter): StarterScenario;
+//# sourceMappingURL=starter.d.ts.map

package/dist/schemas/components/starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter.d.ts","sourceRoot":"","sources":["../../../src/schemas/components/starter.ts"],"names":[],"mappings":"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"}