@syntrologie/adapt-guide 0.0.0-stage → 2.8.0-canary.621

package/dist/guide-widget.d.ts

@@ -0,0 +1,26 @@
+import { LitElement, nothing } from 'lit';
+export declare const GUIDE_PAGE_TAG = "syntro-guide-page";
+export declare class GuidePageWidget extends LitElement {
+    static styles: import("lit").CSSResult;
+    static properties: {
+        templates: {
+            attribute: boolean;
+        };
+    };
+    /** The store's own list of templates (the tile's props); null means every drawable one. */
+    templates: readonly string[] | null;
+    private _transport;
+    private _hints;
+    private _brand;
+    /** Nothing to draw for the life of this tile: unpublished, down, or no way to load it. */
+    private _gone;
+    constructor();
+    connectedCallback(): void;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
+    /** The first view is painted: the section takes its height now, never before. */
+    private _show;
+    /** Draw nothing and take no room, so the store's page reads as if the tile were not there. */
+    private _collapse;
+}
+export declare function registerGuidePageElement(): void;
+//# sourceMappingURL=guide-widget.d.ts.map

package/dist/guide-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-widget.d.ts","sourceRoot":"","sources":["../src/guide-widget.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAa,UAAU,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAErD,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,0BAwBpB;IAEF,OAAgB,UAAU;;;;MAExB;IAEF,2FAA2F;IACnF,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAE5C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAM;IACpB,0FAA0F;IAC1F,OAAO,CAAC,KAAK,CAAS;;IAOb,iBAAiB,IAAI,IAAI;IA+BzB,MAAM;IAgBf,iFAAiF;IACjF,OAAO,CAAC,KAAK,CAEX;IAEF,8FAA8F;IAC9F,OAAO,CAAC,SAAS,CAKf;CACH;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C"}

package/dist/runtime.d.ts

@@ -0,0 +1,41 @@
+/**
+ * adaptive-guide — Runtime manifest
+ *
+ * Registers <syntro-guide-page> as a side effect of importing this module and
+ * exposes the mountable the runtime's WidgetRegistry uses for
+ * `adaptive-guide:page`.
+ */
+import { type MountPlumbing } from '@syntrologie/sdk-contracts';
+import type { GuidePageProps } from './schema';
+/** The tile card adds `chromeless` to the props it passes down; the page has no use for it. */
+type MountedProps = GuidePageProps & MountPlumbing & {
+    chromeless?: boolean;
+};
+export declare const GuidePageMountable: {
+    mount(container: HTMLElement, config?: MountedProps | null): () => void;
+    /** A refetch or republish keeps the same page, so the shopper keeps their place in it. */
+    update(container: HTMLElement, config?: MountedProps | null): void;
+};
+export declare const runtime: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    /** No DOM-mutation executors: this tile renders only. */
+    executors: never[];
+    widgets: {
+        id: string;
+        component: {
+            mount(container: HTMLElement, config?: MountedProps | null): () => void;
+            /** A refetch or republish keeps the same page, so the shopper keeps their place in it. */
+            update(container: HTMLElement, config?: MountedProps | null): void;
+        };
+        metadata: {
+            name: string;
+            description: string;
+            icon: string;
+        };
+    }[];
+};
+export default runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,4BAA4B,CAAC;AAGpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,+FAA+F;AAC/F,KAAK,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E,eAAO,MAAM,kBAAkB;qBACZ,WAAW,WAAW,YAAY,GAAG,IAAI;IAW1D,0FAA0F;sBACxE,WAAW,WAAW,YAAY,GAAG,IAAI;CAO5D,CAAC;AAEF,eAAO,MAAM,OAAO;;;;;IAMlB,yDAAyD;;;;;6BA3BxC,WAAW,WAAW,YAAY,GAAG,IAAI;YAW1D,0FAA0F;8BACxE,WAAW,WAAW,YAAY,GAAG,IAAI;;;;;;;;CA6B5D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,12 @@
+import {
+  GuidePageMountable,
+  runtime,
+  runtime_default
+} from "./chunk-BVOACKL5.js";
+import "./chunk-IGIU6S7P.js";
+export {
+  GuidePageMountable,
+  runtime_default as default,
+  runtime
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/schema.d.ts

@@ -0,0 +1,47 @@
+/**
+ * adaptive-guide — Zod schema (source of truth for the tile's props)
+ *
+ * The guided page tile draws the store's published guide (the config's
+ * top-level `guide` block, which runtime-backend reads; the SDK never does).
+ * Its only prop is the store's own list of templates.
+ *
+ * This module is loaded by the schema generator in Node, so it never imports
+ * the page itself (that registers custom elements); the template names are
+ * listed here and a test holds them to the page's own registry.
+ */
+import { z } from 'zod';
+export declare const TEMPLATES: readonly ["pick_from_pictures", "what_you_need", "compare", "hero_pick", "product_detail"];
+export declare const guidePagePropsSchema: z.ZodObject<{
+    templates: z.ZodOptional<z.ZodArray<z.ZodEnum<["pick_from_pictures", "what_you_need", "compare", "hero_pick", "product_detail"]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    templates?: ("pick_from_pictures" | "what_you_need" | "compare" | "hero_pick" | "product_detail")[] | undefined;
+}, {
+    templates?: ("pick_from_pictures" | "what_you_need" | "compare" | "hero_pick" | "product_detail")[] | undefined;
+}>;
+export type GuidePageProps = z.infer<typeof guidePagePropsSchema>;
+export declare const tileWidgets: {
+    widget: string;
+    defName: string;
+    propsSchema: z.ZodObject<{
+        templates: z.ZodOptional<z.ZodArray<z.ZodEnum<["pick_from_pictures", "what_you_need", "compare", "hero_pick", "product_detail"]>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        templates?: ("pick_from_pictures" | "what_you_need" | "compare" | "hero_pick" | "product_detail")[] | undefined;
+    }, {
+        templates?: ("pick_from_pictures" | "what_you_need" | "compare" | "hero_pick" | "product_detail")[] | undefined;
+    }>;
+}[];
+export declare const CAPABILITIES_DOCUMENTATION: {
+    packageId: string;
+    plannerSummary: string;
+    description: string;
+    whenToUse: {
+        goal: string;
+        action: string;
+    }[];
+    conventions: {
+        name: string;
+        description: string;
+    }[];
+    events: never[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS,4FAMsB,CAAC;AAE7C,eAAO,MAAM,oBAAoB;;;;;;EAa9B,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,WAAW;;;;;;;;;;GAEvB,CAAC;AAMF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;CA0BtC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,51 @@
+import {
+  external_exports
+} from "./chunk-IGIU6S7P.js";
+
+// src/schema.ts
+var TEMPLATES = [
+  "pick_from_pictures",
+  "what_you_need",
+  "compare",
+  "hero_pick",
+  "product_detail"
+];
+var guidePagePropsSchema = external_exports.object({
+  templates: external_exports.array(external_exports.enum(TEMPLATES)).min(1).optional().describe(
+    "The store's own list of templates the guide may show. Absent: every template the page can draw."
+  )
+}).strict().describe(
+  "The guided page: the store's published guide, drawn full width in an inline slot anchored to the store's guided page block."
+);
+var tileWidgets = [
+  { widget: "adaptive-guide:page", defName: "guidePageProps", propsSchema: guidePagePropsSchema }
+];
+var CAPABILITIES_DOCUMENTATION = {
+  packageId: "adaptive-guide",
+  plannerSummary: "The store's guided page, drawn from its published guide block. Not a planner choice: the store's plan carries the tile and its inline slot.",
+  description: "The guided page as a tile: shoppers tap pictures to say what they need, then pick products for what they are missing. It draws the config's published guide block in an inline slot anchored to the store's guided page block.",
+  whenToUse: [
+    {
+      goal: "Show the store's published guide on the page that carries its guided page block",
+      action: 'Declare an inline slot anchored at [data-syntro-guide] and add a chromeless tile with widget: "adaptive-guide:page" in that slot'
+    }
+  ],
+  conventions: [
+    {
+      name: "Content comes from the guide block",
+      description: "Every picture, product and word comes from the config's top-level guide block, read by the server. The tile carries only the template list."
+    },
+    {
+      name: "Inline, never covering",
+      description: "The guide is a section of the page after its anchor, as tall as the viewport at most; its feed scrolls inside. Without the anchor, or when the guide is not published or is down, it takes no room."
+    }
+  ],
+  events: []
+};
+export {
+  CAPABILITIES_DOCUMENTATION,
+  TEMPLATES,
+  guidePagePropsSchema,
+  tileWidgets
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/schema.ts"],
+  "sourcesContent": ["/**\n * adaptive-guide \u2014 Zod schema (source of truth for the tile's props)\n *\n * The guided page tile draws the store's published guide (the config's\n * top-level `guide` block, which runtime-backend reads; the SDK never does).\n * Its only prop is the store's own list of templates.\n *\n * This module is loaded by the schema generator in Node, so it never imports\n * the page itself (that registers custom elements); the template names are\n * listed here and a test holds them to the page's own registry.\n */\n\nimport type { TemplateName } from '@syntrologie/canvas-postcard-guide/page';\nimport { z } from 'zod';\n\nexport const TEMPLATES = [\n  'pick_from_pictures',\n  'what_you_need',\n  'compare',\n  'hero_pick',\n  'product_detail',\n] as const satisfies readonly TemplateName[];\n\nexport const guidePagePropsSchema = z\n  .object({\n    templates: z\n      .array(z.enum(TEMPLATES))\n      .min(1)\n      .optional()\n      .describe(\n        \"The store's own list of templates the guide may show. Absent: every template the page can draw.\"\n      ),\n  })\n  .strict()\n  .describe(\n    \"The guided page: the store's published guide, drawn full width in an inline slot anchored to the store's guided page block.\"\n  );\n\nexport type GuidePageProps = z.infer<typeof guidePagePropsSchema>;\n\nexport const tileWidgets = [\n  { widget: 'adaptive-guide:page', defName: 'guidePageProps', propsSchema: guidePagePropsSchema },\n];\n\n// ============================================================================\n// Capabilities Documentation (injected into JSON Schema for LLM prompts)\n// ============================================================================\n\nexport const CAPABILITIES_DOCUMENTATION = {\n  packageId: 'adaptive-guide',\n  plannerSummary:\n    \"The store's guided page, drawn from its published guide block. Not a planner choice: the store's plan carries the tile and its inline slot.\",\n  description:\n    \"The guided page as a tile: shoppers tap pictures to say what they need, then pick products for what they are missing. It draws the config's published guide block in an inline slot anchored to the store's guided page block.\",\n  whenToUse: [\n    {\n      goal: \"Show the store's published guide on the page that carries its guided page block\",\n      action:\n        'Declare an inline slot anchored at [data-syntro-guide] and add a chromeless tile with widget: \"adaptive-guide:page\" in that slot',\n    },\n  ],\n  conventions: [\n    {\n      name: 'Content comes from the guide block',\n      description:\n        \"Every picture, product and word comes from the config's top-level guide block, read by the server. The tile carries only the template list.\",\n    },\n    {\n      name: 'Inline, never covering',\n      description:\n        'The guide is a section of the page after its anchor, as tall as the viewport at most; its feed scrolls inside. Without the anchor, or when the guide is not published or is down, it takes no room.',\n    },\n  ],\n  events: [],\n};\n"],
+  "mappings": ";;;;;AAeO,IAAM,YAAY;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB,iBACjC,OAAO;AAAA,EACN,WAAW,iBACR,MAAM,iBAAE,KAAK,SAAS,CAAC,EACvB,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC,EACA,OAAO,EACP;AAAA,EACC;AACF;AAIK,IAAM,cAAc;AAAA,EACzB,EAAE,QAAQ,uBAAuB,SAAS,kBAAkB,aAAa,qBAAqB;AAChG;AAMO,IAAM,6BAA6B;AAAA,EACxC,WAAW;AAAA,EACX,gBACE;AAAA,EACF,aACE;AAAA,EACF,WAAW;AAAA,IACT;AAAA,MACE,MAAM;AAAA,MACN,QACE;AAAA,IACJ;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX;AAAA,MACE,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,EACF;AAAA,EACA,QAAQ,CAAC;AACX;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@syntrologie/adapt-guide",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.8.0-canary.621",
+  "description": "Adaptive Guide: the store's guided page as a tile, drawn in an inline slot on the store's own page.",
+  "license": "Proprietary",
+  "private": false,
+  "author": "Syntrologie <eng@syntrologie.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SyntropyForge/amazing-demos.git",
+    "directory": "packages/adaptives/adaptive-guide"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "syntrologie": {
+    "bundlingMode": "cdn-only"
+  },
+  "type": "module",
+  "exports": {
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./cdn": {
+      "types": "./dist/cdn.d.ts",
+      "import": "./dist/cdn.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly && node ../scripts/build-lib.mjs",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check ."
+  },
+  "peerDependencies": {
+    "lit": "3.3.2"
+  },
+  "devDependencies": {
+    "@syntrologie/canvas-postcard-guide": "*",
+    "@syntrologie/sdk-contracts": "*",
+    "jsdom": "26.1.0",
+    "lit": "3.3.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18",
+    "zod": "3.25.76"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.