@protoyard/core 1.1.3 → 1.2.0

package/README.md

@@ -9,7 +9,7 @@ Nothing here imports Svelte, Dexie or Node APIs.
 
 | File | What it defines |
 | --- | --- |
-| `manifest.ts` | `PrototypeManifestSchema` for `protoyard.json` (id, slug, kind, platform, `preview` (viewport, `shell`, `device`, `orientation`, `chrome` with fictional-only origins, optional `layout`), storage namespace + schemaVersion, build flags, scenario ids), `ShellSchema`, `resolveShell` (`auto` → `phone` for mobile, else `none`), the optional marketplace `catalog` block (`CatalogSchema`, `CATALOG_CATEGORIES`), `parseManifest`, `MANIFEST_FILENAME` |
+| `manifest.ts` | `PrototypeManifestSchema` for `protoyard.json` (id, slug, kind, platform, `preview`, storage namespace + schemaVersion, build flags, scenario ids), `DevtoolsOptionsSchema` (`launcher.hidden`, pixel `offset`, `tone`), `DemoBadgeSchema` (legacy booleans or `{ layer, avoid, phone }`), `ShellSchema`, `resolveShell`, marketplace catalog metadata, `parseManifest`, `MANIFEST_FILENAME` |
 | `slug.ts` | `checkSlug` / `isValidSlug` / `slugify`, reserved slugs. This is the path-safety gate for the CLI. |
 | `prototype.ts` | `definePrototype` and `PrototypeDefinition` (manifest, `DatabaseDefinition` versions/migrations, scenarios, `generate`, optional context-free `generateWorld(scenario)` used for scenario loads, `generatorVersion`, `policy`, `integrity`, `themes`, `timeline`, `applyEvent`), `WorldSeed`, `GenerateContext`, `RESERVED_TABLES` |
 | `scenario.ts` | `ScenarioSchema` and its independent axes (organization, actor, density, activity, environment, appearance, generator knobs), `defineScenario`, `parseScenarioLink` / `buildScenarioLink` for safe reproducible links (including `?shell=` and `?layout=`) |

package/dist/manifest.d.ts

@@ -158,6 +158,46 @@ export declare const PreviewSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export type PreviewSettings = z.infer<typeof PreviewSchema>;
+export declare const DevtoolsLauncherSchema: z.ZodObject<{
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    offset: z.ZodOptional<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        subtle: "subtle";
+        contrast: "contrast";
+    }>>;
+}, z.core.$strict>;
+export declare const DevtoolsOptionsSchema: z.ZodObject<{
+    launcher: z.ZodOptional<z.ZodObject<{
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        offset: z.ZodOptional<z.ZodObject<{
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            subtle: "subtle";
+            contrast: "contrast";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DevtoolsOptions = z.infer<typeof DevtoolsOptionsSchema>;
+export declare const DemoBadgeSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    layer: z.ZodOptional<z.ZodEnum<{
+        "above-app": "above-app";
+        "below-overlays": "below-overlays";
+    }>>;
+    avoid: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    phone: z.ZodOptional<z.ZodEnum<{
+        hidden: "hidden";
+        compact: "compact";
+        corner: "corner";
+    }>>;
+}, z.core.$strict>]>;
+export type DemoBadgeOptions = z.infer<typeof DemoBadgeSchema>;
 /**
  * Marketplace categories: one shared list, so the gallery never shows two
  * spellings of the same shelf. Add a value here instead of free-form text.
@@ -462,13 +502,38 @@ export declare const PrototypeManifestSchema: z.ZodObject<{
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
+    devtools: z.ZodOptional<z.ZodObject<{
+        launcher: z.ZodOptional<z.ZodObject<{
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            offset: z.ZodOptional<z.ZodObject<{
+                x: z.ZodOptional<z.ZodNumber>;
+                y: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            tone: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                subtle: "subtle";
+                contrast: "contrast";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     storage: z.ZodObject<{
         namespace: z.ZodString;
         schemaVersion: z.ZodNumber;
     }, z.core.$strip>;
     build: z.ZodDefault<z.ZodObject<{
         includeDevtools: z.ZodDefault<z.ZodBoolean>;
-        demoBadge: z.ZodDefault<z.ZodBoolean>;
+        demoBadge: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            layer: z.ZodOptional<z.ZodEnum<{
+                "above-app": "above-app";
+                "below-overlays": "below-overlays";
+            }>>;
+            avoid: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            phone: z.ZodOptional<z.ZodEnum<{
+                hidden: "hidden";
+                compact: "compact";
+                corner: "corner";
+            }>>;
+        }, z.core.$strict>]>>;
         base: z.ZodDefault<z.ZodString>;
         offline: z.ZodDefault<z.ZodBoolean>;
         frameWhenEmbedded: z.ZodDefault<z.ZodBoolean>;
@@ -585,7 +650,11 @@ export declare function safeParseManifest(input: unknown): z.ZodSafeParseResult<
     };
     build: {
         includeDevtools: boolean;
-        demoBadge: boolean;
+        demoBadge: boolean | {
+            layer?: "above-app" | "below-overlays" | undefined;
+            avoid?: string[] | undefined;
+            phone?: "hidden" | "compact" | "corner" | undefined;
+        };
         base: string;
         offline: boolean;
         frameWhenEmbedded: boolean;
@@ -603,6 +672,16 @@ export declare function safeParseManifest(input: unknown): z.ZodSafeParseResult<
     icon?: string | undefined;
     thumbnail?: string | undefined;
     defaultScenario?: string | undefined;
+    devtools?: {
+        launcher?: {
+            hidden?: boolean | undefined;
+            offset?: {
+                x?: number | undefined;
+                y?: number | undefined;
+            } | undefined;
+            tone?: "default" | "subtle" | "contrast" | undefined;
+        } | undefined;
+    } | undefined;
     catalog?: {
         category: "marketing" | "starter" | "productivity" | "communication" | "sales" | "support" | "finance" | "commerce" | "marketplace" | "ai" | "analytics" | "developer-tools" | "design" | "education" | "health" | "hr" | "operations" | "media" | "social" | "travel" | "real-estate" | "internal-tools";
         platforms: ("desktop" | "mobile" | "tablet" | "web" | "widget" | "extension" | "plugin")[];

package/dist/manifest.js

@@ -70,6 +70,29 @@ export const PreviewSchema = z.object({
     /** App layout (ADR-023); absent: `custom`, the prototype renders its own. */
     layout: LayoutSettingsSchema.optional(),
 });
+export const DevtoolsLauncherSchema = z
+    .object({
+    hidden: z.boolean().optional(),
+    offset: z
+        .object({ x: z.number().finite().optional(), y: z.number().finite().optional() })
+        .strict()
+        .optional(),
+    tone: z.enum(['default', 'subtle', 'contrast']).optional(),
+})
+    .strict();
+export const DevtoolsOptionsSchema = z
+    .object({ launcher: DevtoolsLauncherSchema.optional() })
+    .strict();
+export const DemoBadgeSchema = z.union([
+    z.boolean(),
+    z
+        .object({
+        layer: z.enum(['above-app', 'below-overlays']).optional(),
+        avoid: z.array(z.string().min(1)).optional(),
+        phone: z.enum(['compact', 'hidden', 'corner']).optional(),
+    })
+        .strict(),
+]);
 /**
  * Marketplace categories: one shared list, so the gallery never shows two
  * spellings of the same shelf. Add a value here instead of free-form text.
@@ -253,6 +276,8 @@ export const PrototypeManifestSchema = z
     defaultTheme: ThemeIdRefSchema.default('violet'),
     defaultMode: ColorModeSchema.default('system'),
     preview: PreviewSchema.default({ viewport: 'desktop', shell: 'auto' }),
+    /** Optional presentation controls for Protoyard's runtime DevTools launcher. */
+    devtools: DevtoolsOptionsSchema.optional(),
     storage: z.object({
         namespace: NamespaceSchema,
         schemaVersion: z.number().int().positive(),
@@ -262,7 +287,7 @@ export const PrototypeManifestSchema = z
         /** Include the floating DevTools panel in standalone builds. */
         includeDevtools: z.boolean().default(false),
         /** Show a small "Prototype" badge in standalone builds. */
-        demoBadge: z.boolean().default(true),
+        demoBadge: DemoBadgeSchema.default(true),
         /** Public base path. `./` produces relocatable output. */
         base: z.string().default('./'),
         /**

package/dist/overrides.d.ts

@@ -107,8 +107,8 @@ export declare const OverridesSchema: z.ZodObject<{
     }>>;
     motion: z.ZodOptional<z.ZodEnum<{
         none: "none";
-        standard: "standard";
         subtle: "subtle";
+        standard: "standard";
         expressive: "expressive";
     }>>;
     actorId: z.ZodOptional<z.ZodString>;

package/dist/scenario.d.ts

@@ -78,8 +78,8 @@ export declare const ScenarioAppearanceSchema: z.ZodObject<{
     }>>;
     motion: z.ZodOptional<z.ZodEnum<{
         none: "none";
-        standard: "standard";
         subtle: "subtle";
+        standard: "standard";
         expressive: "expressive";
     }>>;
     themeId: z.ZodOptional<z.ZodString>;
@@ -235,8 +235,8 @@ export declare const ScenarioSchema: z.ZodObject<{
         }>>;
         motion: z.ZodOptional<z.ZodEnum<{
             none: "none";
-            standard: "standard";
             subtle: "subtle";
+            standard: "standard";
             expressive: "expressive";
         }>>;
         themeId: z.ZodOptional<z.ZodString>;

package/dist/theme.d.ts

@@ -98,8 +98,8 @@ export declare const StylePresetOverridesSchema: z.ZodObject<{
     }>>;
     motion: z.ZodOptional<z.ZodEnum<{
         none: "none";
-        standard: "standard";
         subtle: "subtle";
+        standard: "standard";
         expressive: "expressive";
     }>>;
 }, z.core.$strip>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protoyard/core",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Framework-agnostic contracts for Protoyard: manifests, scenarios, personas, permissions, simulation clock, environment, snapshots and themes.",
   "license": "MIT",
   "type": "module",