@webstudio-is/sdk 0.267.0 → 0.269.0

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-meta-generator.d.ts

@@ -11,6 +11,7 @@ export type PageMeta = {
     socialImageUrl?: string;
     status?: number;
     redirect?: string;
+    content?: string;
     custom: Array<{
         property: string;
         content: string;

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

@@ -5062,7 +5062,7 @@ export type PresetStyleDecl = Simplify<Omit<z.infer<typeof PresetStyleDecl>, "pr
     property: CssProperty;
 }>;
 export type PresetStyle<Tag extends HtmlTags = HtmlTags> = Partial<Record<Tag, PresetStyleDecl[]>>;
-export declare const componentCategories: readonly ["general", "typography", "media", "animations", "data", "forms", "localization", "radix", "xml", "other", "hidden", "internal"];
+export declare const componentCategories: readonly ["general", "typography", "media", "animations", "data", "forms", "localization", "radix", "xml", "text", "other", "hidden", "internal"];
 export declare const ComponentState: z.ZodObject<{
     selector: z.ZodString;
     label: z.ZodString;
@@ -5095,7 +5095,7 @@ export declare const ContentModel: z.ZodObject<{
 }>;
 export type ContentModel = z.infer<typeof ContentModel>;
 export declare const WsComponentMeta: z.ZodObject<{
-    category: z.ZodOptional<z.ZodEnum<["general", "typography", "media", "animations", "data", "forms", "localization", "radix", "xml", "other", "hidden", "internal"]>>;
+    category: z.ZodOptional<z.ZodEnum<["general", "typography", "media", "animations", "data", "forms", "localization", "radix", "xml", "text", "other", "hidden", "internal"]>>;
     contentModel: z.ZodOptional<z.ZodObject<{
         category: z.ZodUnion<[z.ZodLiteral<"instance">, z.ZodLiteral<"none">]>;
         /**
@@ -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[]">;
@@ -10748,7 +10775,7 @@ export declare const WsComponentMeta: z.ZodObject<{
     }>]>>>;
 }, "strip", z.ZodTypeAny, {
     description?: string | undefined;
-    category?: "xml" | "hidden" | "data" | "media" | "animations" | "general" | "typography" | "forms" | "localization" | "radix" | "other" | "internal" | undefined;
+    category?: "xml" | "text" | "hidden" | "data" | "media" | "animations" | "general" | "typography" | "forms" | "localization" | "radix" | "other" | "internal" | undefined;
     label?: string | undefined;
     order?: number | undefined;
     props?: Record<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[]";
@@ -11558,7 +11594,7 @@ export declare const WsComponentMeta: z.ZodObject<{
     initialProps?: string[] | undefined;
 }, {
     description?: string | undefined;
-    category?: "xml" | "hidden" | "data" | "media" | "animations" | "general" | "typography" | "forms" | "localization" | "radix" | "other" | "internal" | undefined;
+    category?: "xml" | "text" | "hidden" | "data" | "media" | "animations" | "general" | "typography" | "forms" | "localization" | "radix" | "other" | "internal" | undefined;
     label?: string | undefined;
     order?: number | undefined;
     props?: Record<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[]";