@vibesdotdev/applets 0.0.0-stage → 1.0.0-rc.3

package/dist/schemas/definition.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Immutable Applet definition metadata carried by one exact Component release.
+ *
+ * Platform continues to own source, compilation, bundles, and releases. This
+ * schema describes the Applet-specific contract of that release: one HTML or
+ * Svelte entrypoint, its immutable file inventory, Applet-owned storage,
+ * referenced Assets, composition pins, and capabilities over browsing-user or
+ * external data.
+ */
+import * as z from 'zod/v4';
+export declare const appletRelativePathSchema: z.ZodString;
+export declare const appletEntrypointKindSchema: z.ZodEnum<{
+    html: "html";
+    svelte: "svelte";
+}>;
+export declare const appletEntrypointSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        html: "html";
+        svelte: "svelte";
+    }>;
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const appletPackageFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    mediaType: z.ZodString;
+    digest: z.ZodString;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Applet-owned data is not a browsing-user capability. The runtime derives the
+ * Applet instance and viewer partition and exposes only these declared stores.
+ */
+export declare const appletOwnStorageDescriptorSchema: 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>;
+    writeConditions: 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>>>;
+}, z.core.$strip>;
+export declare const appletAssetRefSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    revision: z.ZodString;
+    digest: z.ZodString;
+    mountPath: z.ZodString;
+}, z.core.$strip>;
+export declare const appletCompositionSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        extends: "extends";
+        renders: "renders";
+    }>;
+    release: z.ZodObject<{
+        componentId: z.ZodUUID;
+        version: z.ZodString;
+        bundleHash: z.ZodString;
+        manifestHash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    slot: z.ZodString;
+    props: z.ZodDefault<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>;
+export declare const appletCapabilityRequestSchema: z.ZodObject<{
+    tag: z.ZodString;
+    reason: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * The principal an applet action runs AS (A2b).
+ *
+ * - `author` — the applet's owner: the local workspace user, or the instance
+ *   owner in the cloud. Owns paired resources and defines policy/conditions.
+ * - `viewer` — the runtime principal at render time: the same user locally,
+ *   the viewer session in the cloud, carrying its own runtime and auth.
+ */
+export declare const appletPrincipalSchema: z.ZodEnum<{
+    author: "author";
+    viewer: "viewer";
+}>;
+/**
+ * An approved server action (A2b).
+ *
+ * The handler is a REFERENCE into the release's own `files[]`, never inline
+ * code: dispatching one crosses the sandbox boundary exactly as a contributed
+ * implementation does, and the host never imports a release file. `policy`
+ * carries the author's declarative conditions, bounded like every other
+ * author-supplied value, and is evaluated server-side with the acting
+ * principal.
+ */
+export declare const appletServerActionSchema: z.ZodObject<{
+    id: z.ZodString;
+    principal: z.ZodEnum<{
+        author: "author";
+        viewer: "viewer";
+    }>;
+    handler: z.ZodObject<{
+        entry: z.ZodString;
+        export: z.ZodString;
+        surface: z.ZodLiteral<"server">;
+    }, z.core.$strict>;
+    policy: z.ZodDefault<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.$strict>;
+export declare const appletDefinitionManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    entrypoint: z.ZodObject<{
+        kind: z.ZodEnum<{
+            html: "html";
+            svelte: "svelte";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strip>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mediaType: z.ZodString;
+        digest: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strip>>;
+    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>;
+        writeConditions: 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>>>;
+    }, z.core.$strip>>>;
+    assets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        revision: z.ZodString;
+        digest: z.ZodString;
+        mountPath: z.ZodString;
+    }, z.core.$strip>>>;
+    composition: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        mode: z.ZodEnum<{
+            extends: "extends";
+            renders: "renders";
+        }>;
+        release: z.ZodObject<{
+            componentId: z.ZodUUID;
+            version: z.ZodString;
+            bundleHash: z.ZodString;
+            manifestHash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        slot: z.ZodString;
+        props: z.ZodDefault<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>>>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        reason: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    contributes: z.ZodOptional<z.ZodObject<{
+        config: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            description: z.ZodString;
+            valueSchema: 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>>;
+            default: 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>>>;
+            secret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        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;
+            arguments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+                variadic: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                flags: z.ZodString;
+                description: z.ZodString;
+                type: z.ZodDefault<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                }>>;
+                choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+            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>>>;
+        events: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            event: 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>>;
+    serverActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        principal: z.ZodEnum<{
+            author: "author";
+            viewer: "viewer";
+        }>;
+        handler: z.ZodObject<{
+            entry: z.ZodString;
+            export: z.ZodString;
+            surface: z.ZodLiteral<"server">;
+        }, z.core.$strict>;
+        policy: z.ZodDefault<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.$strict>>>;
+}, z.core.$strip>;
+export type AppletEntrypointKind = z.infer<typeof appletEntrypointKindSchema>;
+export type AppletEntrypoint = z.infer<typeof appletEntrypointSchema>;
+export type AppletPackageFile = z.infer<typeof appletPackageFileSchema>;
+export type AppletOwnStorageDescriptor = z.infer<typeof appletOwnStorageDescriptorSchema>;
+export type AppletAssetRef = z.infer<typeof appletAssetRefSchema>;
+export type AppletComposition = z.infer<typeof appletCompositionSchema>;
+export type AppletCapabilityRequest = z.infer<typeof appletCapabilityRequestSchema>;
+export type AppletPrincipal = z.infer<typeof appletPrincipalSchema>;
+export type AppletServerAction = z.infer<typeof appletServerActionSchema>;
+export type AppletDefinitionManifest = z.infer<typeof appletDefinitionManifestSchema>;
+export type AppletRuntimeInjection = 'window' | 'prop';
+/** HTML receives `window.vibes`; Svelte receives a `vibes` component prop. */
+export declare function appletRuntimeInjectionForEntrypoint(entrypoint: Pick<AppletEntrypoint, 'kind'>): AppletRuntimeInjection;
+//# sourceMappingURL=definition.d.ts.map

package/dist/schemas/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/schemas/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAS5B,eAAO,MAAM,wBAAwB,aAIyC,CAAC;AAE/E,eAAO,MAAM,0BAA0B;;;EAA6B,CAAC;AAErE,eAAO,MAAM,sBAAsB;;;;;;iBAchC,CAAC;AAEJ,eAAO,MAAM,uBAAuB;;;;;iBAUlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;iBAmE1C,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;iBAY/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAYlC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;EAA+B,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAc3B,CAAC;AAYX,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoRxC,CAAC;AAEJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,8EAA8E;AAC9E,wBAAgB,mCAAmC,CAClD,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GACxC,sBAAsB,CAExB"}