@prismicio/editor-fields 0.4.52-jp-onboarding-guide-triggers.1 → 0.4.52-jp-onboarding-guide-triggers-highlight

package/dist/EditorConfig.d.ts

@@ -47,14 +47,14 @@ type IntegrationFields = {
     integrationFieldsApiBaseUrl: URL;
     repository: string;
 };
-type LayoutConfig = {
-/**
+interface LayoutConfig {
+    /**
      * Teaches fields about their containing scrolling element.
      */
     scrollOffsetTop?: number;
 }
-type OnAnalyticsEvent = {
-(event: "Media Library Search", args: {
+interface OnAnalyticsEvent {
+    (event: "Media Library Search", args: {
         assetType: MediaAssetType;
         mode: "browse" | "select";
         searchQuery: string;
@@ -62,7 +62,7 @@ type OnAnalyticsEvent = {
         numberOfResults: string;
         timeToGetResults: string;
         tags: string;
-}): void;
+    }): void;
     (event: "Media Added To Page", args: {
         assetType: MediaAssetType;
         searchQuery: string;
@@ -73,13 +73,19 @@ type OnAnalyticsEvent = {
         timeToAddMediaToPage: string;
         tags: string;
     }): void;
+    (event: "Generic Link Added", args: {
+        type: "web" | "media" | "document";
+        isInSlice: string;
+        isInGroup: string;
+        customTypeFormat: "page" | "custom";
+    }): void;
     (event: "Unsplash Image Searched" | "Unsplash Image Added"): void;
 }
-type Analytics = {
-onAnalyticsEvent?: OnAnalyticsEvent;
+interface Analytics {
+    onAnalyticsEvent?: OnAnalyticsEvent;
 }
-type ErrorTracking = {
-/** Asks the editor to track this Error in its Error monitoring solution. */
+interface ErrorTracking {
+    /** Asks the editor to track this Error in its Error monitoring solution. */
     onTrackError?: (error: Error) => void;
 }
 export type AuthStrategy = "cookie" | "token";

package/dist/FieldContext.d.ts

@@ -0,0 +1,27 @@
+import type { CustomType } from "@prismicio/types-internal/lib/customtypes";
+import { type PropsWithChildren, type ReactNode } from "react";
+type CustomTypeFormat = CustomType["format"];
+interface FieldContextValue {
+    customTypeFormat: CustomTypeFormat;
+    isInSlice: boolean;
+    isInGroup: boolean;
+}
+interface RootFieldContextProviderProps {
+    customTypeFormat: CustomTypeFormat;
+    children: ReactNode;
+}
+/**
+ * Provides extra context to the fields below.
+ * Use it only once at the root of the fields tree.
+ */
+export declare function RootFieldContextProvider(props: RootFieldContextProviderProps): JSX.Element;
+/**
+ * Overrides the field context to indicate that the field is in a slice.
+ */
+export declare function FieldInSliceContextProvider(props: PropsWithChildren): JSX.Element;
+/**
+ * Overrides the field context to indicate that the field is in a group.
+ */
+export declare function FieldInGroupContextProvider(props: PropsWithChildren): JSX.Element;
+export declare function useFieldContext(): FieldContextValue | undefined;
+export {};

package/dist/constants/framework.d.ts

@@ -4,3 +4,8 @@ export declare const frameworkLabels: {
     readonly sveltekit: "SvelteKit";
     readonly other: "Other";
 };
+export declare const frameworkCreateProjectCodeSnippet: {
+    readonly next: "npx create-next-app@latest";
+    readonly nuxt: "npx nuxi@latest init";
+    readonly sveltekit: "npx sv create";
+};

package/dist/core/MediaLibrary/hooks/mediaLibraryData.d.ts

@@ -41,33 +41,33 @@ export declare const mediaAssetType: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         count: number;
         uploader_id?: string | undefined;
     }, {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         uploader_id?: string | undefined;
         count?: number | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: string;
+    url: string;
+    size: number;
     tags: {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         count: number;
         uploader_id?: string | undefined;
     }[];
-    id: string;
-    url: string;
-    size: number;
-    kind: string;
-    last_modified: number;
     filename: string;
+    last_modified: number;
     extension?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
@@ -82,20 +82,20 @@ export declare const mediaAssetType: z.ZodObject<{
         credits?: string | undefined;
     } | undefined;
 }, {
+    id: string;
+    kind: string;
+    url: string;
+    size: number;
     tags: {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         uploader_id?: string | undefined;
         count?: number | undefined;
     }[];
-    id: string;
-    url: string;
-    size: number;
-    kind: string;
-    last_modified: number;
     filename: string;
+    last_modified: number;
     extension?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
@@ -156,33 +156,33 @@ export declare const mediaSearchResponse: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             count: number;
             uploader_id?: string | undefined;
         }, {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             uploader_id?: string | undefined;
             count?: number | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             count: number;
             uploader_id?: string | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -197,20 +197,20 @@ export declare const mediaSearchResponse: z.ZodObject<{
             credits?: string | undefined;
         } | undefined;
     }, {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             uploader_id?: string | undefined;
             count?: number | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -226,22 +226,21 @@ export declare const mediaSearchResponse: z.ZodObject<{
         } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    total: number;
     items: {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             count: number;
             uploader_id?: string | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -256,24 +255,24 @@ export declare const mediaSearchResponse: z.ZodObject<{
             credits?: string | undefined;
         } | undefined;
     }[];
+    total: number;
     cursor?: string | undefined;
 }, {
-    total: number;
     items: {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             uploader_id?: string | undefined;
             count?: number | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -288,6 +287,7 @@ export declare const mediaSearchResponse: z.ZodObject<{
             credits?: string[] | undefined;
         } | undefined;
     }[];
+    total: number;
     cursor?: string | undefined;
 }>;
 export type MediaAsset = z.TypeOf<typeof mediaAssetType>;
@@ -306,22 +306,21 @@ export declare function searchMedia(baseUrl: URL | undefined, repository: string
     uploaderId: string | undefined;
     tags: string;
     page: number;
-    total: number;
     items: {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             count: number;
             uploader_id?: string | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -336,6 +335,7 @@ export declare function searchMedia(baseUrl: URL | undefined, repository: string
             credits?: string | undefined;
         } | undefined;
     }[];
+    total: number;
     cursor?: string | undefined;
 }>;
 interface UseMediaLibrarySearchArgs {
@@ -357,20 +357,20 @@ export declare function useMediaSearch(args: UseMediaLibrarySearchArgs): {
     setFilters: (filters: Partial<MediaLibraryFilters>) => void;
     resetFilters: () => void;
     media: {
+        id: string;
+        kind: string;
+        url: string;
+        size: number;
         tags: {
             id: string;
             name: string;
-            created_at: number;
             last_modified: number;
+            created_at: number;
             count: number;
             uploader_id?: string | undefined;
         }[];
-        id: string;
-        url: string;
-        size: number;
-        kind: string;
-        last_modified: number;
         filename: string;
+        last_modified: number;
         extension?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -407,20 +407,20 @@ declare function deleteMedia(mediaIds: string[]): void;
 declare function deleteSearchData(args: MediaLibraryFilters): void;
 type MediaPage = Awaited<ReturnType<typeof searchMedia>>;
 export declare function getMedia(allPages: MediaPage[], keyword: string, assetType: MediaAssetType, uploaderId: string | undefined, tags: string): {
+    id: string;
+    kind: string;
+    url: string;
+    size: number;
     tags: {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         count: number;
         uploader_id?: string | undefined;
     }[];
-    id: string;
-    url: string;
-    size: number;
-    kind: string;
-    last_modified: number;
     filename: string;
+    last_modified: number;
     extension?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;

package/dist/core/MediaLibrary/hooks/tagData.d.ts

@@ -3,8 +3,8 @@ export declare function useTagSearch(): {
     tags: {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         count: number;
         uploader_id?: string | undefined;
     }[];
@@ -22,15 +22,15 @@ export declare const tagSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
-    created_at: number;
     last_modified: number;
+    created_at: number;
     count: number;
     uploader_id?: string | undefined;
 }, {
     id: string;
     name: string;
-    created_at: number;
     last_modified: number;
+    created_at: number;
     uploader_id?: string | undefined;
     count?: number | undefined;
 }>;

package/dist/core/MediaLibrary/hooks/useSelectedMedia.d.ts

@@ -1,18 +1,18 @@
 export declare function useSelectedMedia(): {
+    id: string;
+    kind: string;
+    url: string;
+    size: number;
     tags: {
         id: string;
         name: string;
-        created_at: number;
         last_modified: number;
+        created_at: number;
         count: number;
         uploader_id?: string | undefined;
     }[];
-    id: string;
-    url: string;
-    size: number;
-    kind: string;
-    last_modified: number;
     filename: string;
+    last_modified: number;
     extension?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;

package/dist/core/OnboardingGuide/OnboardingGuide.d.ts

@@ -1,13 +1,14 @@
 import { type ReactNode } from "react";
 import type { OnboardingState, OnboardingStepId, OnboardingTracking } from "../service";
-interface OnboardingGuideProps {
+export interface OnboardingGuideProps {
     onboardingState: OnboardingState;
     tracking: OnboardingTracking;
     onToggleStep: (stepId: OnboardingStepId) => Promise<string[]>;
     onToggleGuide: () => Promise<void>;
     fallback?: ReactNode;
     /** This allows consumers of the onboarding to do something else for certain steps other than opening the modal. */
-    stepContentOverride?: Partial<Record<OnboardingStepId, ReactNode>>;
+    stepOverrides?: Partial<Record<OnboardingStepId, () => void>>;
+    repositoryName?: string;
+    projectName?: string;
 }
 export declare function OnboardingGuide(props: OnboardingGuideProps): JSX.Element | null;
-export {};

package/dist/core/OnboardingGuide/components/OnboardingCard.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from "react";
+/// <reference types="react" />
 import type { OnboardingStep, OnboardingStepId, OnboardingTracking } from "../../service";
 interface OnboardingCardProps {
     steps: OnboardingStep[];
@@ -7,7 +7,7 @@ interface OnboardingCardProps {
     tracking: OnboardingTracking;
     onToggleStep: (step: OnboardingStep) => Promise<void>;
     onClose?: () => void;
-    stepContentOverride?: Partial<Record<OnboardingStepId, ReactNode>>;
+    stepOverrides?: Partial<Record<OnboardingStepId, () => void>>;
 }
 export declare function OnboardingCard(props: OnboardingCardProps): JSX.Element;
 export {};

package/dist/core/OnboardingGuide/components/OnboardingProgressStepper.d.ts

@@ -1,11 +1,11 @@
-import { type ReactNode } from "react";
+/// <reference types="react" />
 import type { OnboardingStep, OnboardingStepId, OnboardingTracking } from "../../service";
 interface OnboardingProgressStepperProps {
     steps: OnboardingStep[];
     completedSteps: string[];
     onToggleStep: (step: OnboardingStep) => Promise<void>;
     tracking: OnboardingTracking;
-    stepContentOverride?: Partial<Record<OnboardingStepId, ReactNode>>;
+    stepOverrides?: Partial<Record<OnboardingStepId, () => void>>;
 }
 export declare function OnboardingProgressStepper(props: OnboardingProgressStepperProps): JSX.Element | null;
 export {};

package/dist/core/OnboardingGuide/components/OnboardingStepDialog.d.ts

@@ -1,13 +1,13 @@
-import { type ReactNode } from "react";
-import type { OnboardingStep, OnboardingStepId } from "../../service";
+import { type RefObject } from "react";
+import type { OnboardingStep } from "../../service";
 interface OnboardingStepDialogProps {
     isOpen: boolean;
     step: OnboardingStep;
     stepIndex: number;
     isStepComplete: boolean;
-    onActionClick: () => Promise<void>;
+    onActionClick: (isUndo?: boolean) => Promise<void>;
     onClose: () => void;
-    stepContentOverride?: Partial<Record<OnboardingStepId, ReactNode>>;
+    contentRef: RefObject<HTMLDivElement>;
 }
 export declare function OnboardingStepDialog(props: OnboardingStepDialogProps): JSX.Element;
 export {};

package/dist/core/OnboardingGuide/content.d.ts

@@ -1,6 +1,13 @@
 import type { OnboardingFramework, OnboardingStep } from "../service/onboarding";
-export declare function getOnboardingContent(framework?: OnboardingFramework, starter?: string | null): {
+type Context = {
+    framework?: OnboardingFramework;
+    starter?: string | null;
+    repositoryName?: string;
+    projectName?: string;
+};
+export declare function getOnboardingContent(context: Context): {
     steps: OnboardingStep[];
     defaultCompletedStepIds: ("createPrismicProject" | "chooseLocale" | "createProject" | "setupSliceMachine" | "createPageType" | "codePage" | "createSlice" | "reviewAndPush" | "createContent" | "renderPage")[];
     tutorialLink: string | undefined;
 };
+export {};

package/dist/core/OnboardingGuide/index.d.ts

@@ -1 +1 @@
-export { OnboardingGuide } from "./OnboardingGuide";
+export { OnboardingGuide, type OnboardingGuideProps } from "./OnboardingGuide";

package/dist/core/UnsplashLibrary/unsplashData.d.ts

@@ -17,9 +17,9 @@ declare const unsplashImage: import("zod").ZodObject<{
     description: import("zod").ZodNullable<import("zod").ZodString>;
 }, "strip", import("zod").ZodTypeAny, {
     id: string;
-    description: string | null;
-    width: number;
     height: number;
+    width: number;
+    description: string | null;
     urls: {
         small: string;
         full: string;
@@ -27,9 +27,9 @@ declare const unsplashImage: import("zod").ZodObject<{
     alt_description?: string | undefined;
 }, {
     id: string;
-    description: string | null;
-    width: number;
     height: number;
+    width: number;
+    description: string | null;
     urls: {
         small: string;
         full: string;
@@ -55,9 +55,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
         description: import("zod").ZodNullable<import("zod").ZodString>;
     }, "strip", import("zod").ZodTypeAny, {
         id: string;
-        description: string | null;
-        width: number;
         height: number;
+        width: number;
+        description: string | null;
         urls: {
             small: string;
             full: string;
@@ -65,9 +65,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
         alt_description?: string | undefined;
     }, {
         id: string;
-        description: string | null;
-        width: number;
         height: number;
+        width: number;
+        description: string | null;
         urls: {
             small: string;
             full: string;
@@ -77,9 +77,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
 }, "strip", import("zod").ZodTypeAny, {
     results: {
         id: string;
-        description: string | null;
-        width: number;
         height: number;
+        width: number;
+        description: string | null;
         urls: {
             small: string;
             full: string;
@@ -89,9 +89,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
 }, {
     results: {
         id: string;
-        description: string | null;
-        width: number;
         height: number;
+        width: number;
+        description: string | null;
         urls: {
             small: string;
             full: string;
@@ -100,9 +100,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
     }[];
 }>, {
     id: string;
-    description: string | null;
-    width: number;
     height: number;
+    width: number;
+    description: string | null;
     urls: {
         small: string;
         full: string;
@@ -111,9 +111,9 @@ export declare const unsplashSearchApiType: import("zod").ZodEffects<import("zod
 }[], {
     results: {
         id: string;
-        description: string | null;
-        width: number;
         height: number;
+        width: number;
+        description: string | null;
         urls: {
             small: string;
             full: string;
@@ -125,9 +125,9 @@ export type UnplashSearchApi = TypeOf<typeof unsplashSearchApiType>;
 export type UnsplashImage = TypeOf<typeof unsplashImage>;
 export declare function useUnsplashSearch(baseUrl: URL, term: string): {
     id: string;
-    description: string | null;
-    width: number;
     height: number;
+    width: number;
+    description: string | null;
     urls: {
         small: string;
         full: string;

package/dist/core/service/customType.d.ts

@@ -6,21 +6,21 @@ declare const customTypeResponse: z.ZodObject<{
     repeatable: z.ZodBoolean;
     status: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    label: string;
     id: string;
-    status: boolean;
+    label: string;
     repeatable: boolean;
+    status: boolean;
 }, {
-    label: string;
     id: string;
-    status: boolean;
+    label: string;
     repeatable: boolean;
+    status: boolean;
 }>;
 export type CustomTypeResponse = z.TypeOf<typeof customTypeResponse>;
 export declare function getRepositoryCustomTypes(baseUrl: URL, repository: string, authStrategy: AuthStrategy): Promise<{
-    label: string;
     id: string;
-    status: boolean;
+    label: string;
     repeatable: boolean;
+    status: boolean;
 }[]>;
 export {};

package/dist/core/service/repository.d.ts

@@ -93,6 +93,7 @@ declare const repositorySchema: z.ZodEffects<z.ZodObject<{
     }>;
     uploadedAvatar: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    framework: "next" | "nuxt" | "sveltekit" | "other";
     authors: {
         id: string;
         email: string;
@@ -108,7 +109,6 @@ declare const repositorySchema: z.ZodEffects<z.ZodObject<{
     quotas: {
         slicemachineEnabled: boolean;
     };
-    framework: "next" | "nuxt" | "sveltekit" | "other";
     storageVersion: {
         major: number;
         minor: number;