@webstudio-is/sdk 0.268.0 → 0.269.0

package/lib/index.js

@@ -163,6 +163,14 @@ var Page = z2.object({
   ...commonPageFields,
   path: z2.union([HomePagePath, PagePath])
 });
+var PageTemplate = z2.object({
+  id: PageId,
+  name: PageName,
+  title: PageTitle,
+  rootInstanceId: z2.string(),
+  systemDataSourceId: z2.string().optional(),
+  meta: commonPageFields.meta
+});
 var ProjectMeta = z2.object({
   // All fields are optional to ensure consistency and allow for the addition of new fields without requiring migration
   siteName: z2.string().optional(),
@@ -195,6 +203,7 @@ var Pages = z2.object({
   homePageId: PageId,
   rootFolderId: FolderId,
   pages: z2.map(PageId, Page),
+  pageTemplates: z2.map(PageId, PageTemplate).optional(),
   folders: z2.map(FolderId, Folder).refine((folders) => folders.size > 0, "Folders can't be empty")
 }).superRefine((pages, context) => {
   const homePage = pages.pages.get(pages.homePageId);
@@ -236,6 +245,22 @@ var Pages = z2.object({
       });
     }
   }
+  for (const [templateId, template] of pages.pageTemplates ?? []) {
+    if (template.id !== templateId) {
+      context.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["pageTemplates", templateId, "id"],
+        message: "Page template id must match its record key"
+      });
+    }
+    if (pages.pages.has(templateId)) {
+      context.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["pageTemplates", templateId, "id"],
+        message: "Page template id must not match an existing page id"
+      });
+    }
+  }
   for (const [folderId, folder] of pages.folders) {
     if (folder.id !== folderId) {
       context.addIssue({
@@ -928,6 +953,13 @@ var Select = z14.object({
   defaultValue: z14.string().optional(),
   options: z14.array(z14.string())
 });
+var TimeZone = z14.object({
+  ...common,
+  control: z14.literal("timeZone"),
+  type: z14.literal("string"),
+  defaultValue: z14.string().optional(),
+  options: z14.array(z14.string())
+});
 var Check = z14.object({
   ...common,
   control: z14.literal("check"),
@@ -1008,6 +1040,7 @@ var PropMeta = z14.union([
   Radio,
   InlineRadio,
   Select,
+  TimeZone,
   MultiSelect,
   Check,
   InlineCheck,
@@ -2086,6 +2119,29 @@ var parseComponentName = (componentName) => {
   }
   return [namespace, name];
 };
+var getHtmlTagsFromProps = (props) => {
+  const tags2 = /* @__PURE__ */ new Map();
+  for (const prop of props.values()) {
+    if (prop.type === "string" && prop.name === "tag") {
+      tags2.set(prop.instanceId, prop.value);
+    }
+  }
+  return tags2;
+};
+var getHtmlTagFromInstance = ({
+  instance,
+  metas,
+  props,
+  htmlTagsByInstanceId
+}) => {
+  if (instance.component === "XmlNode") {
+    return;
+  }
+  const meta = metas.get(instance.component);
+  const metaTag = Object.keys(meta?.presetStyle ?? {}).at(0);
+  const propTag = htmlTagsByInstanceId?.get(instance.id) ?? getHtmlTagsFromProps(props).get(instance.id);
+  return instance.tag ?? propTag ?? metaTag;
+};
 var getIndexesWithinAncestors = (metas, instances, rootIds) => {
   const ancestors = /* @__PURE__ */ new Set();
   for (const meta of metas.values()) {
@@ -2145,6 +2201,23 @@ var systemParameter = {
   type: "parameter",
   name: "system"
 };
+var walkAssignmentTarget = (node, visitor) => {
+  if (node.type === "Identifier") {
+    visitor.Identifier?.(node, "binding");
+    return;
+  }
+  if (node.type === "MemberExpression") {
+    visitor.MemberExpression?.(node);
+    const { object } = node;
+    if (object.type === "Identifier") {
+      visitor.Identifier?.(object, "memberObject");
+    } else if (object.type === "MemberExpression") {
+      walkAssignmentTarget(object, visitor);
+    }
+    return;
+  }
+  visitor.UnsupportedPattern?.(node);
+};
 var stringMethodReturnKindByName = /* @__PURE__ */ new Map([
   ["toLowerCase", "string"],
   ["replace", "string"],
@@ -2361,15 +2434,21 @@ var lintExpression = ({
           addMessage("Assignment is supported only inside actions")(node);
           return;
         }
-        simple(node.left, {
-          Identifier(node2) {
+        walkAssignmentTarget(node.left, {
+          Identifier(node2, kind) {
+            if (kind !== "binding") {
+              return;
+            }
             if (availableVariables.has(node2.name) === false) {
               addMessage(
                 `"${node2.name}" is not defined in the scope`,
                 "warning"
               )(node2);
             }
-          }
+          },
+          UnsupportedPattern: addMessage(
+            "Destructuring assignment is not supported"
+          )
         });
       },
       // parser forbids to yield inside module
@@ -2467,7 +2546,7 @@ var getExpressionIdentifiers = (expression) => {
     simple(root, {
       Identifier: (node) => identifiers2.add(node.name),
       AssignmentExpression(node) {
-        simple(node.left, {
+        walkAssignmentTarget(node.left, {
           Identifier: (node2) => identifiers2.add(node2.name)
         });
       }
@@ -2488,17 +2567,44 @@ var transpileExpression = ({
     const message = error.message;
     throw Error(`${message} in ${JSON.stringify(expression)}`);
   }
+  const assignmentTargetMemberRanges = [];
+  if (executable) {
+    simple(root, {
+      AssignmentExpression(node) {
+        walkAssignmentTarget(node.left, {
+          MemberExpression(node2) {
+            assignmentTargetMemberRanges.push([node2.start, node2.end]);
+          }
+        });
+      }
+    });
+  }
   const replacements = [];
+  const replacementIndexByRange = /* @__PURE__ */ new Map();
+  const addReplacement = (start, end, fragment, { replaceExisting = false } = {}) => {
+    const range = `${start}:${end}`;
+    const existingIndex = replacementIndexByRange.get(range);
+    if (existingIndex !== void 0) {
+      if (replaceExisting) {
+        replacements[existingIndex] = [start, end, fragment];
+      }
+      return;
+    }
+    replacementIndexByRange.set(range, replacements.length);
+    replacements.push([start, end, fragment]);
+  };
   const replaceIdentifier = (node, assignee) => {
     const newName = replaceVariable?.(node.name, assignee);
     if (newName) {
-      replacements.push([node.start, node.end, newName]);
+      addReplacement(node.start, node.end, newName, {
+        replaceExisting: assignee
+      });
     }
   };
   simple(root, {
     Identifier: (node) => replaceIdentifier(node, false),
     AssignmentExpression(node) {
-      simple(node.left, {
+      walkAssignmentTarget(node.left, {
         Identifier: (node2) => replaceIdentifier(node2, true)
       });
     },
@@ -2506,13 +2612,18 @@ var transpileExpression = ({
       if (executable === false || node.optional) {
         return;
       }
+      if (assignmentTargetMemberRanges.some(
+        ([start, end]) => start === node.start && end === node.end
+      )) {
+        return;
+      }
       if (node.computed === false) {
         const dotIndex = expression.indexOf(".", node.object.end);
-        replacements.push([dotIndex, dotIndex, "?"]);
+        addReplacement(dotIndex, dotIndex, "?");
       }
       if (node.computed === true) {
         const dotIndex = expression.indexOf("[", node.object.end);
-        replacements.push([dotIndex, dotIndex, "?."]);
+        addReplacement(dotIndex, dotIndex, "?.");
       }
     },
     CallExpression(node) {
@@ -2522,7 +2633,7 @@ var transpileExpression = ({
       if (node.callee.type === "MemberExpression") {
         const openParenIndex = expression.indexOf("(", node.callee.end);
         if (openParenIndex !== -1) {
-          replacements.push([openParenIndex, openParenIndex, "?."]);
+          addReplacement(openParenIndex, openParenIndex, "?.");
         }
       }
     }
@@ -2646,6 +2757,8 @@ var isAbsoluteUrl = (href) => {
 
 // src/page-utils.ts
 var ROOT_FOLDER_ID = "root";
+var isPage = (page) => page !== void 0 && "path" in page;
+var isPageTemplate = (page) => page !== void 0 && !("path" in page);
 var isRootFolder = ({ id }) => id === ROOT_FOLDER_ID;
 var getPageById = (pages, pageId) => {
   return pages.pages.get(pageId);
@@ -2666,14 +2779,20 @@ var getHomePage = (pages) => {
   }
   return homePage;
 };
-var findPageByIdOrPath = (idOrPath, pages) => {
+function findPageByIdOrPath(idOrPath, pages, options = {}) {
   if (idOrPath === "" || idOrPath === "/" || idOrPath === pages.homePageId) {
     return getHomePage(pages);
   }
-  return getAllPages(pages).find(
+  const found = getAllPages(pages).find(
     (page) => page.id === idOrPath || getPagePath(page.id, pages) === idOrPath
   );
-};
+  if (found) {
+    return found;
+  }
+  if (options.includeTemplates) {
+    return pages.pageTemplates?.get(idOrPath);
+  }
+}
 var findParentFolderByChildId = (id, folders) => {
   const folderList = folders instanceof Map ? folders.values() : folders;
   for (const folder of folderList) {
@@ -3099,6 +3218,29 @@ var generatePageMeta = ({
   return generated;
 };
 
+// src/link-utils.ts
+var isInternalHref = (href, assetBaseUrl) => /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(href) === false && (assetBaseUrl !== "" && href.startsWith("/") && href.startsWith(assetBaseUrl)) === false;
+var resolveLocalLinkUrl = (href, location, resolvedPath) => {
+  if (href === "") {
+    return {
+      pathname: location.pathname,
+      search: location.search,
+      hash: ""
+    };
+  }
+  if (href.startsWith("#")) {
+    return {
+      pathname: location.pathname,
+      search: location.search,
+      hash: href === "#" ? "" : href
+    };
+  }
+  return resolvedPath;
+};
+var isLocalLinkActive = (current, target) => {
+  return current.pathname === target.pathname && current.search === target.search && current.hash === target.hash;
+};
+
 // src/css.ts
 import { kebabCase } from "change-case";
 import {
@@ -3160,22 +3302,19 @@ var generateCss = ({
   const scope = createScope([], normalizeClassName, "-");
   const tagsByComponent = /* @__PURE__ */ new Map();
   tagsByComponent.set(rootComponent, /* @__PURE__ */ new Set(["html"]));
-  const tagByInstanceId = /* @__PURE__ */ new Map();
-  for (const prop of props.values()) {
-    if (prop.type === "string" && prop.name === "tag") {
-      tagByInstanceId.set(prop.instanceId, prop.value);
-    }
-  }
+  const htmlTagsByInstanceId = getHtmlTagsFromProps(props);
   for (const instance of instances.values()) {
-    const propTag = tagByInstanceId.get(instance.id);
-    const meta = componentMetas.get(instance.component);
-    const metaTag = Object.keys(meta?.presetStyle ?? {}).at(0);
     let componentTags = tagsByComponent.get(instance.component);
     if (componentTags === void 0) {
       componentTags = /* @__PURE__ */ new Set();
       tagsByComponent.set(instance.component, componentTags);
     }
-    const tag = instance.tag ?? propTag ?? metaTag;
+    const tag = getHtmlTagFromInstance({
+      instance,
+      metas: componentMetas,
+      props,
+      htmlTagsByInstanceId
+    });
     if (tag) {
       componentTags.add(tag);
     }
@@ -3338,6 +3477,7 @@ export {
   PageName,
   PagePath,
   PageRedirect,
+  PageTemplate,
   PageTitle,
   Pages,
   PresetStyleDecl,
@@ -3409,6 +3549,8 @@ export {
   getExpressionValueKind,
   getFolderById,
   getHomePage,
+  getHtmlTagFromInstance,
+  getHtmlTagsFromProps,
   getIndexesWithinAncestors,
   getMimeTypeByExtension,
   getMimeTypeByFilename,
@@ -3423,7 +3565,11 @@ export {
   isAllowedMimeCategory,
   isComponentDetachable,
   isCoreComponent,
+  isInternalHref,
   isLiteralExpression,
+  isLocalLinkActive,
+  isPage,
+  isPageTemplate,
   isPathnamePattern,
   isRootFolder,
   lintExpression,
@@ -3433,6 +3579,7 @@ export {
   portalComponent,
   rangeUnitValueSchema,
   replaceFormActionsWithResources,
+  resolveLocalLinkUrl,
   rootComponent,
   scrollAnimationSchema,
   systemParameter,

package/lib/link-utils.js

@@ -0,0 +1,27 @@
+// src/link-utils.ts
+var isInternalHref = (href, assetBaseUrl) => /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(href) === false && (assetBaseUrl !== "" && href.startsWith("/") && href.startsWith(assetBaseUrl)) === false;
+var resolveLocalLinkUrl = (href, location, resolvedPath) => {
+  if (href === "") {
+    return {
+      pathname: location.pathname,
+      search: location.search,
+      hash: ""
+    };
+  }
+  if (href.startsWith("#")) {
+    return {
+      pathname: location.pathname,
+      search: location.search,
+      hash: href === "#" ? "" : href
+    };
+  }
+  return resolvedPath;
+};
+var isLocalLinkActive = (current, target) => {
+  return current.pathname === target.pathname && current.search === target.search && current.hash === target.hash;
+};
+export {
+  isInternalHref,
+  isLocalLinkActive,
+  resolveLocalLinkUrl
+};

package/lib/types/index.d.ts

@@ -21,6 +21,7 @@ export * from "./expression";
 export * from "./resources-generator";
 export * from "./page-meta-generator";
 export * from "./url-pattern";
+export * from "./link-utils";
 export * from "./css";
 export * from "./__generated__/tags";
 export type { AnimationAction, AnimationActionScroll, AnimationActionView, AnimationKeyframe, KeyframeStyles, RangeUnit, RangeUnitValue, ScrollNamedRange, ScrollRangeValue, ViewNamedRange, ViewRangeValue, ScrollAnimation, ViewAnimation, InsetUnitValue, DurationUnitValue, IterationsUnitValue, TimeUnit, } from "./schema/animation-schema";

package/lib/types/instances-utils.d.ts

@@ -1,8 +1,16 @@
 import type { WsComponentMeta } from "./schema/component-meta";
 import type { Instance, Instances } from "./schema/instances";
+import type { Props } from "./schema/props";
 export declare const ROOT_INSTANCE_ID = ":root";
 export declare const findTreeInstanceIds: (instances: Instances, rootInstanceId: Instance["id"]) => Set<string>;
 export declare const findTreeInstanceIdsExcludingSlotDescendants: (instances: Instances, rootInstanceId: Instance["id"]) => Set<string>;
 export declare const parseComponentName: (componentName: string) => readonly [string | undefined, string];
+export declare const getHtmlTagsFromProps: (props: Props) => Map<string, string>;
+export declare const getHtmlTagFromInstance: ({ instance, metas, props, htmlTagsByInstanceId, }: {
+    instance: Instance;
+    metas: Map<Instance["component"], WsComponentMeta>;
+    props: Props;
+    htmlTagsByInstanceId?: Map<Instance["id"], string>;
+}) => string | undefined;
 export type IndexesWithinAncestors = Map<Instance["id"], number>;
 export declare const getIndexesWithinAncestors: (metas: Map<Instance["component"], WsComponentMeta>, instances: Instances, rootIds: Instance["id"][]) => IndexesWithinAncestors;

package/lib/types/link-utils.d.ts

@@ -0,0 +1,19 @@
+export type UrlParts = {
+    pathname: string;
+    search: string;
+    hash: string;
+};
+export declare const isInternalHref: (href: string, assetBaseUrl: string) => boolean;
+/**
+ * React Router resolves href="" and hash-only hrefs without preserving the
+ * concrete browser URL shape Webstudio uses for :local-link-like matching.
+ * Normalize those cases before comparing so current-link state follows anchor
+ * URL semantics instead of route-only semantics.
+ */
+export declare const resolveLocalLinkUrl: (href: string, location: UrlParts, resolvedPath: UrlParts) => UrlParts;
+/**
+ * Webstudio's local link styles target the concrete URL, not just the matched
+ * route. This intentionally preserves the old NavLink end/exact behavior while
+ * also requiring query string and fragment equality.
+ */
+export declare const isLocalLinkActive: (current: UrlParts, target: UrlParts) => boolean;

package/lib/types/page-utils.d.ts

@@ -1,5 +1,16 @@
-import type { Folder, Page, Pages } from "./schema/pages";
+import type { Folder, Page, PageTemplate, Pages } from "./schema/pages";
 export declare const ROOT_FOLDER_ID = "root";
+/**
+ * Narrows Page | PageTemplate to Page.
+ * Templates have no `path` field; pages always do.
+ */
+export declare const isPage: (page: Page | PageTemplate | undefined) => page is Page;
+/**
+ * Narrows Page | PageTemplate to PageTemplate.
+ */
+export declare const isPageTemplate: (page: Page | PageTemplate | undefined) => page is PageTemplate & {
+    path?: never;
+};
 /**
  * Returns true if folder is the root folder.
  */
@@ -12,9 +23,17 @@ export declare const getAllPages: (pages: Pages) => Page[];
 export declare const getAllFolders: (pages: Pages) => Folder[];
 export declare const getHomePage: (pages: Pages) => Page;
 /**
- * Find a page by id or path.
+ * Find a page by id or path. Pass { includeTemplates: true } to also search
+ * pageTemplates (builder-only call sites: canvas awareness, selected-page
+ * computation). Without the flag the return type is `Page | undefined` so
+ * existing call sites are unaffected.
  */
-export declare const findPageByIdOrPath: (idOrPath: string, pages: Pages) => Page | undefined;
+export declare function findPageByIdOrPath(idOrPath: string, pages: Pages, options: {
+    includeTemplates: true;
+}): Page | PageTemplate | undefined;
+export declare function findPageByIdOrPath(idOrPath: string, pages: Pages, options?: {
+    includeTemplates?: false;
+}): Page | undefined;
 /**
  * Find a folder that has has that id in the children.
  */

package/lib/types/schema/component-meta.d.ts

@@ -10493,6 +10493,33 @@ export declare const WsComponentMeta: z.ZodObject<{
         label?: string | undefined;
         defaultValue?: string | undefined;
         contentMode?: boolean | undefined;
+    }>, z.ZodObject<{
+        control: z.ZodLiteral<"timeZone">;
+        type: z.ZodLiteral<"string">;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodString, "many">;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodBoolean;
+        contentMode: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        options: string[];
+        type: "string";
+        required: boolean;
+        control: "timeZone";
+        description?: string | undefined;
+        label?: string | undefined;
+        defaultValue?: string | undefined;
+        contentMode?: boolean | undefined;
+    }, {
+        options: string[];
+        type: "string";
+        required: boolean;
+        control: "timeZone";
+        description?: string | undefined;
+        label?: string | undefined;
+        defaultValue?: string | undefined;
+        contentMode?: boolean | undefined;
     }>, z.ZodObject<{
         control: z.ZodLiteral<"multi-select">;
         type: z.ZodLiteral<"string[]">;
@@ -10853,6 +10880,15 @@ export declare const WsComponentMeta: z.ZodObject<{
         label?: string | undefined;
         defaultValue?: string | undefined;
         contentMode?: boolean | undefined;
+    } | {
+        options: string[];
+        type: "string";
+        required: boolean;
+        control: "timeZone";
+        description?: string | undefined;
+        label?: string | undefined;
+        defaultValue?: string | undefined;
+        contentMode?: boolean | undefined;
     } | {
         options: string[];
         type: "string[]";
@@ -11663,6 +11699,15 @@ export declare const WsComponentMeta: z.ZodObject<{
         label?: string | undefined;
         defaultValue?: string | undefined;
         contentMode?: boolean | undefined;
+    } | {
+        options: string[];
+        type: "string";
+        required: boolean;
+        control: "timeZone";
+        description?: string | undefined;
+        label?: string | undefined;
+        defaultValue?: string | undefined;
+        contentMode?: boolean | undefined;
     } | {
         options: string[];
         type: "string[]";

package/lib/types/schema/pages.d.ts

@@ -298,6 +298,195 @@ declare const Page: z.ZodObject<{
         thumbnailAssetId?: string | undefined;
     } | undefined;
 }>;
+export declare const PageTemplate: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodEffects<z.ZodString, string, string>;
+    rootInstanceId: z.ZodString;
+    systemDataSourceId: z.ZodOptional<z.ZodString>;
+    meta: z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        excludePageFromSearch: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        socialImageAssetId: z.ZodOptional<z.ZodString>;
+        socialImageUrl: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        redirect: z.ZodOptional<z.ZodString>;
+        documentType: z.ZodOptional<z.ZodEnum<["html", "xml", "text"]>>;
+        content: z.ZodOptional<z.ZodString>;
+        auth: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodObject<{
+            login: z.ZodString;
+            password: z.ZodString;
+            method: z.ZodLiteral<"basic">;
+        }, "strip", z.ZodTypeAny, {
+            login: string;
+            password: string;
+            method: "basic";
+        }, {
+            login: string;
+            password: string;
+            method: "basic";
+        }>, {
+            login: string;
+            password: string;
+            method: "basic";
+        }, {
+            login: string;
+            password: string;
+            method: "basic";
+        }>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            login: z.ZodString;
+            password: z.ZodString;
+            type: z.ZodLiteral<"basic">;
+        }, "strip", z.ZodTypeAny, {
+            type: "basic";
+            login: string;
+            password: string;
+        }, {
+            type: "basic";
+            login: string;
+            password: string;
+        }>, {
+            type: "basic";
+            login: string;
+            password: string;
+        }, {
+            type: "basic";
+            login: string;
+            password: string;
+        }>, {
+            method: "basic";
+            login: string;
+            password: string;
+        }, {
+            type: "basic";
+            login: string;
+            password: string;
+        }>]>>;
+        custom: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            property: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            property: string;
+        }, {
+            content: string;
+            property: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status?: string | undefined;
+        custom?: {
+            content: string;
+            property: string;
+        }[] | undefined;
+        description?: string | undefined;
+        auth?: {
+            login: string;
+            password: string;
+            method: "basic";
+        } | {
+            method: "basic";
+            login: string;
+            password: string;
+        } | undefined;
+        content?: string | undefined;
+        title?: string | undefined;
+        excludePageFromSearch?: string | undefined;
+        language?: string | undefined;
+        socialImageAssetId?: string | undefined;
+        socialImageUrl?: string | undefined;
+        redirect?: string | undefined;
+        documentType?: "html" | "xml" | "text" | undefined;
+    }, {
+        status?: string | undefined;
+        custom?: {
+            content: string;
+            property: string;
+        }[] | undefined;
+        description?: string | undefined;
+        auth?: {
+            login: string;
+            password: string;
+            method: "basic";
+        } | {
+            type: "basic";
+            login: string;
+            password: string;
+        } | undefined;
+        content?: string | undefined;
+        title?: string | undefined;
+        excludePageFromSearch?: string | undefined;
+        language?: string | undefined;
+        socialImageAssetId?: string | undefined;
+        socialImageUrl?: string | undefined;
+        redirect?: string | undefined;
+        documentType?: "html" | "xml" | "text" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    meta: {
+        status?: string | undefined;
+        custom?: {
+            content: string;
+            property: string;
+        }[] | undefined;
+        description?: string | undefined;
+        auth?: {
+            login: string;
+            password: string;
+            method: "basic";
+        } | {
+            method: "basic";
+            login: string;
+            password: string;
+        } | undefined;
+        content?: string | undefined;
+        title?: string | undefined;
+        excludePageFromSearch?: string | undefined;
+        language?: string | undefined;
+        socialImageAssetId?: string | undefined;
+        socialImageUrl?: string | undefined;
+        redirect?: string | undefined;
+        documentType?: "html" | "xml" | "text" | undefined;
+    };
+    id: string;
+    title: string;
+    rootInstanceId: string;
+    systemDataSourceId?: string | undefined;
+}, {
+    name: string;
+    meta: {
+        status?: string | undefined;
+        custom?: {
+            content: string;
+            property: string;
+        }[] | undefined;
+        description?: string | undefined;
+        auth?: {
+            login: string;
+            password: string;
+            method: "basic";
+        } | {
+            type: "basic";
+            login: string;
+            password: string;
+        } | undefined;
+        content?: string | undefined;
+        title?: string | undefined;
+        excludePageFromSearch?: string | undefined;
+        language?: string | undefined;
+        socialImageAssetId?: string | undefined;
+        socialImageUrl?: string | undefined;
+        redirect?: string | undefined;
+        documentType?: "html" | "xml" | "text" | undefined;
+    };
+    id: string;
+    title: string;
+    rootInstanceId: string;
+    systemDataSourceId?: string | undefined;
+}>;
+export type PageTemplate = z.infer<typeof PageTemplate>;
 declare const ProjectMeta: z.ZodObject<{
     siteName: z.ZodOptional<z.ZodString>;
     contactEmail: z.ZodOptional<z.ZodString>;
@@ -601,6 +790,194 @@ export declare const Pages: z.ZodEffects<z.ZodObject<{
             thumbnailAssetId?: string | undefined;
         } | undefined;
     }>>;
+    pageTemplates: z.ZodOptional<z.ZodMap<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodEffects<z.ZodString, string, string>;
+        title: z.ZodEffects<z.ZodString, string, string>;
+        rootInstanceId: z.ZodString;
+        systemDataSourceId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            excludePageFromSearch: z.ZodOptional<z.ZodString>;
+            language: z.ZodOptional<z.ZodString>;
+            socialImageAssetId: z.ZodOptional<z.ZodString>;
+            socialImageUrl: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            redirect: z.ZodOptional<z.ZodString>;
+            documentType: z.ZodOptional<z.ZodEnum<["html", "xml", "text"]>>;
+            content: z.ZodOptional<z.ZodString>;
+            auth: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodObject<{
+                login: z.ZodString;
+                password: z.ZodString;
+                method: z.ZodLiteral<"basic">;
+            }, "strip", z.ZodTypeAny, {
+                login: string;
+                password: string;
+                method: "basic";
+            }, {
+                login: string;
+                password: string;
+                method: "basic";
+            }>, {
+                login: string;
+                password: string;
+                method: "basic";
+            }, {
+                login: string;
+                password: string;
+                method: "basic";
+            }>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+                login: z.ZodString;
+                password: z.ZodString;
+                type: z.ZodLiteral<"basic">;
+            }, "strip", z.ZodTypeAny, {
+                type: "basic";
+                login: string;
+                password: string;
+            }, {
+                type: "basic";
+                login: string;
+                password: string;
+            }>, {
+                type: "basic";
+                login: string;
+                password: string;
+            }, {
+                type: "basic";
+                login: string;
+                password: string;
+            }>, {
+                method: "basic";
+                login: string;
+                password: string;
+            }, {
+                type: "basic";
+                login: string;
+                password: string;
+            }>]>>;
+            custom: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                property: z.ZodString;
+                content: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                content: string;
+                property: string;
+            }, {
+                content: string;
+                property: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                method: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        }, {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                type: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                method: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                type: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }>>>;
     folders: z.ZodEffects<z.ZodMap<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         name: z.ZodEffects<z.ZodString, string, string>;
@@ -690,6 +1067,38 @@ export declare const Pages: z.ZodEffects<z.ZodObject<{
         new: string;
         status?: "301" | "302" | undefined;
     }[] | undefined;
+    pageTemplates?: Map<string, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                method: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }> | undefined;
 }, {
     pages: Map<string, {
         path: string;
@@ -753,6 +1162,38 @@ export declare const Pages: z.ZodEffects<z.ZodObject<{
         new: string;
         status?: "301" | "302" | undefined;
     }[] | undefined;
+    pageTemplates?: Map<string, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                type: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }> | undefined;
 }>, {
     pages: Map<string, {
         path: string;
@@ -816,6 +1257,38 @@ export declare const Pages: z.ZodEffects<z.ZodObject<{
         new: string;
         status?: "301" | "302" | undefined;
     }[] | undefined;
+    pageTemplates?: Map<string, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                method: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }> | undefined;
 }, {
     pages: Map<string, {
         path: string;
@@ -879,6 +1352,38 @@ export declare const Pages: z.ZodEffects<z.ZodObject<{
         new: string;
         status?: "301" | "302" | undefined;
     }[] | undefined;
+    pageTemplates?: Map<string, {
+        name: string;
+        meta: {
+            status?: string | undefined;
+            custom?: {
+                content: string;
+                property: string;
+            }[] | undefined;
+            description?: string | undefined;
+            auth?: {
+                login: string;
+                password: string;
+                method: "basic";
+            } | {
+                type: "basic";
+                login: string;
+                password: string;
+            } | undefined;
+            content?: string | undefined;
+            title?: string | undefined;
+            excludePageFromSearch?: string | undefined;
+            language?: string | undefined;
+            socialImageAssetId?: string | undefined;
+            socialImageUrl?: string | undefined;
+            redirect?: string | undefined;
+            documentType?: "html" | "xml" | "text" | undefined;
+        };
+        id: string;
+        title: string;
+        rootInstanceId: string;
+        systemDataSourceId?: string | undefined;
+    }> | undefined;
 }>;
 export type Pages = z.infer<typeof Pages>;
 export {};

package/lib/types/schema/prop-meta.d.ts

@@ -309,6 +309,33 @@ export declare const PropMeta: z.ZodUnion<[z.ZodObject<{
     label?: string | undefined;
     defaultValue?: string | undefined;
     contentMode?: boolean | undefined;
+}>, z.ZodObject<{
+    control: z.ZodLiteral<"timeZone">;
+    type: z.ZodLiteral<"string">;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodString, "many">;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    contentMode: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    options: string[];
+    type: "string";
+    required: boolean;
+    control: "timeZone";
+    description?: string | undefined;
+    label?: string | undefined;
+    defaultValue?: string | undefined;
+    contentMode?: boolean | undefined;
+}, {
+    options: string[];
+    type: "string";
+    required: boolean;
+    control: "timeZone";
+    description?: string | undefined;
+    label?: string | undefined;
+    defaultValue?: string | undefined;
+    contentMode?: boolean | undefined;
 }>, z.ZodObject<{
     control: z.ZodLiteral<"multi-select">;
     type: z.ZodLiteral<"string[]">;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webstudio-is/sdk",
-  "version": "0.268.0",
+  "version": "0.269.0",
   "description": "Webstudio project data schema",
   "author": "Webstudio <github@webstudio.is>",
   "homepage": "https://webstudio.is",
@@ -18,6 +18,11 @@
       "types": "./lib/types/runtime.d.ts",
       "import": "./lib/runtime.js"
     },
+    "./link-utils": {
+      "webstudio": "./src/link-utils.ts",
+      "types": "./lib/types/link-utils.d.ts",
+      "import": "./lib/link-utils.js"
+    },
     "./normalize.css": {
       "webstudio": "./src/__generated__/normalize.css.ts",
       "types": "./lib/types/__generated__/normalize.css.d.ts",
@@ -46,23 +51,23 @@
     "type-fest": "^4.37.0",
     "warn-once": "^0.1.1",
     "zod": "^3.24.2",
-    "@webstudio-is/css-engine": "0.268.0",
-    "@webstudio-is/icons": "0.268.0",
-    "@webstudio-is/wsauth": "0.268.0",
-    "@webstudio-is/fonts": "0.268.0"
+    "@webstudio-is/css-engine": "0.269.0",
+    "@webstudio-is/fonts": "0.269.0",
+    "@webstudio-is/icons": "0.269.0",
+    "@webstudio-is/wsauth": "0.269.0"
   },
   "devDependencies": {
     "html-tags": "^4.0.0",
     "vitest": "^3.1.2",
-    "@webstudio-is/css-data": "0.268.0",
-    "@webstudio-is/template": "0.268.0",
+    "@webstudio-is/template": "0.269.0",
+    "@webstudio-is/css-data": "0.269.0",
     "@webstudio-is/tsconfig": "1.0.7"
   },
   "scripts": {
     "typecheck": "tsgo --noEmit -p tsconfig.typecheck.json",
     "test": "vitest run",
     "build:normalize.css": "tsx --conditions=webstudio ./scripts/normalize.css.ts && prettier --write src/__generated__/normalize.css.ts",
-    "build": "rm -rf lib && esbuild src/index.ts src/runtime.ts src/__generated__/normalize.css.ts src/core-templates.tsx --outdir=lib --bundle --format=esm --packages=external",
+    "build": "rm -rf lib && esbuild src/index.ts src/runtime.ts src/link-utils.ts src/__generated__/normalize.css.ts src/core-templates.tsx --outdir=lib --bundle --format=esm --packages=external",
     "dts": "tsc --project tsconfig.dts.json"
   }
 }