@instructure/platform-modules 1.5.0 → 1.7.0

package/dist/organize/Organize.stories.d.ts

@@ -0,0 +1,33 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { ThemeName } from '../components/storyThemes';
+type Surface = 'button' | 'list' | 'form' | 'preview';
+type Outcome = 'proposal' | 'unplaced' | 'warnings' | 'failure';
+type ApplyOutcome = 'success' | 'failure';
+type FormState = 'default' | 'invalid' | 'disabled';
+type ProposalShape = 'small' | 'rich';
+interface OrganizeStoryArgs {
+    surface: Surface;
+    outcome: Outcome;
+    proposalShape: ProposalShape;
+    organizeMs: number;
+    applyMs: number;
+    applyOutcome: ApplyOutcome;
+    formState: FormState;
+    theme: ThemeName;
+}
+declare const meta: Meta<OrganizeStoryArgs>;
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Trigger: Story;
+export declare const InModulesList: Story;
+export declare const Form: Story;
+export declare const FormWithErrors: Story;
+export declare const FormDisabledWhileApplying: Story;
+export declare const Preview: Story;
+export declare const PreviewWithUnplacedItems: Story;
+export declare const PreviewWithWarnings: Story;
+/** Submit to watch the wait cross `ORGANIZE_SLOW_AFTER_MS` (10s) and add its second line. */
+export declare const SlowGeneration: Story;
+export declare const GenerationFailure: Story;
+export declare const ApplyFailure: Story;
+//# sourceMappingURL=Organize.stories.d.ts.map

package/dist/organize/Organize.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Organize.stories.d.ts","sourceRoot":"","sources":["../../src/organize/Organize.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAUtD,OAAO,EAEL,KAAK,SAAS,EAEf,MAAM,2BAA2B,CAAA;AAYlC,KAAK,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AACrD,KAAK,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;AAC/D,KAAK,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;AACzC,KAAK,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AACnD,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAA;AAErC,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,aAAa,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,SAAS,CAAA;CACjB;AA4JD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,iBAAiB,CA0BjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAA;AAEhC,eAAO,MAAM,aAAa,EAAE,KAE3B,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAElB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAEvC,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAErB,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,KAEtC,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KAEjC,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAE1B,CAAA"}

package/dist/organize/OrganizeForm.d.ts

@@ -0,0 +1,11 @@
+import { ReactElement } from 'react';
+import { OrganizeInputErrors } from './validation';
+import { OrganizeInput } from './types';
+export interface OrganizeFormProps {
+    input: OrganizeInput;
+    errors: OrganizeInputErrors;
+    onChange: (patch: Partial<OrganizeInput>) => void;
+    disabled?: boolean;
+}
+export declare function OrganizeForm({ input, errors, onChange, disabled, }: OrganizeFormProps): ReactElement;
+//# sourceMappingURL=OrganizeForm.d.ts.map

package/dist/organize/OrganizeForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizeForm.d.ts","sourceRoot":"","sources":["../../src/organize/OrganizeForm.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,OAAO,CAAA;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAA;IACpB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAmBD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,QAAgB,GACjB,EAAE,iBAAiB,GAAG,YAAY,CA2GlC"}

package/dist/organize/OrganizeModulesButton.d.ts

@@ -0,0 +1,10 @@
+import { ReactElement, ReactNode } from 'react';
+import { ModuleOrganizationActions } from './types';
+export interface OrganizeModulesButtonProps {
+    actions: ModuleOrganizationActions;
+    onApplied?: () => void;
+    aiDisclosure?: ReactNode;
+    display?: 'block' | 'inline-block';
+}
+export declare function OrganizeModulesButton({ actions, onApplied, aiDisclosure, display, }: OrganizeModulesButtonProps): ReactElement;
+//# sourceMappingURL=OrganizeModulesButton.d.ts.map

package/dist/organize/OrganizeModulesButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizeModulesButton.d.ts","sourceRoot":"","sources":["../../src/organize/OrganizeModulesButton.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAGnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAExD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,yBAAyB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAAA;CACnC;AAED,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,SAAS,EACT,YAAY,EACZ,OAAwB,GACzB,EAAE,0BAA0B,GAAG,YAAY,CA2B3C"}

package/dist/organize/OrganizeModulesModal.d.ts

@@ -0,0 +1,12 @@
+import { ReactElement, ReactNode } from 'react';
+import { ModuleOrganizationActions } from './types';
+export interface OrganizeModulesModalProps {
+    actions: ModuleOrganizationActions;
+    open: boolean;
+    onDismiss: () => void;
+    onApplied?: () => void;
+    /** The host's AI disclosure, drawn in the header. Its content is host policy, not ours. */
+    aiDisclosure?: ReactNode;
+}
+export declare function OrganizeModulesModal({ actions, open, onDismiss, onApplied, aiDisclosure, }: OrganizeModulesModalProps): ReactElement;
+//# sourceMappingURL=OrganizeModulesModal.d.ts.map

package/dist/organize/OrganizeModulesModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizeModulesModal.d.ts","sourceRoot":"","sources":["../../src/organize/OrganizeModulesModal.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAA;AAI5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAGxD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,yBAAyB,CAAA;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,SAAS,CAAA;CACzB;AAqBD,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,YAAY,GACb,EAAE,yBAAyB,GAAG,YAAY,CA0K1C"}

package/dist/organize/ProposalPreview.d.ts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+import { OrganizeProposal } from './types';
+export interface ProposalPreviewProps {
+    proposal: OrganizeProposal;
+}
+export declare function ProposalPreview({ proposal }: ProposalPreviewProps): ReactElement;
+//# sourceMappingURL=ProposalPreview.d.ts.map

package/dist/organize/ProposalPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProposalPreview.d.ts","sourceRoot":"","sources":["../../src/organize/ProposalPreview.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,OAAO,CAAA;AAO5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAa/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAA;CAC3B;AAkBD,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,YAAY,CAsDhF"}

package/dist/organize/fixture.d.ts

@@ -0,0 +1,5 @@
+import { InMemoryFixture } from '../adapters';
+import { OrganizeProposal } from './types';
+export declare const PROPOSAL_PREVIEW_COURSE_ID = "organize-preview";
+export declare function proposalToFixture(proposal: OrganizeProposal): InMemoryFixture;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/organize/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/organize/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,OAAO,KAAK,EAAE,gBAAgB,EAAgC,MAAM,SAAS,CAAA;AAE7E,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AA+D5D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CAgC7E"}

package/dist/organize/index.d.ts

@@ -0,0 +1,9 @@
+export { hasOrganizeInputErrors, type OrganizeInputErrors, validateOrganizeInput, } from './validation';
+export { PROPOSAL_PREVIEW_COURSE_ID, proposalToFixture } from './fixture';
+export { OrganizeForm, type OrganizeFormProps } from './OrganizeForm';
+export { OrganizeModulesButton, type OrganizeModulesButtonProps } from './OrganizeModulesButton';
+export { OrganizeModulesModal, type OrganizeModulesModalProps } from './OrganizeModulesModal';
+export { ProposalPreview, type ProposalPreviewProps } from './ProposalPreview';
+export { defaultOrganizeInput, MAX_DIRECTION_CHARS, type ModuleOrganizationActions, ORGANIZE_CONTENT_TYPES, ORGANIZE_MODES, type OrganizeContentType, type OrganizeInput, type OrganizeMode, type OrganizeProposal, type ProposedCompletionRequirement, type ProposedItem, type ProposedModule, type UnplacedItem, } from './types';
+export { ORGANIZE_SLOW_AFTER_MS, type OrganizeStatus, useOrganizeModules, type UseOrganizeModulesOptions, type UseOrganizeModulesResult, } from './useOrganizeModules';
+//# sourceMappingURL=index.d.ts.map

package/dist/organize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/organize/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AAChG,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAC7F,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,sBAAsB,EACtB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,EACnB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAA"}

package/dist/organize/types.d.ts

@@ -0,0 +1,64 @@
+import { CompletionRequirementType } from '../types';
+export declare const ORGANIZE_MODES: readonly ["place_new", "reorganize_all"];
+export type OrganizeMode = (typeof ORGANIZE_MODES)[number];
+export declare const ORGANIZE_CONTENT_TYPES: readonly ["assignment", "discussion", "quiz", "page", "file"];
+export type OrganizeContentType = (typeof ORGANIZE_CONTENT_TYPES)[number];
+export declare const MAX_DIRECTION_CHARS = 1000;
+export interface OrganizeInput {
+    mode: OrganizeMode;
+    contentTypes: readonly OrganizeContentType[];
+    /**
+     * Whether to *propose* prerequisites and per-item requirements. Canvas honours both at
+     * generation time only: apply writes whatever the proposal carries. Unchecked therefore means
+     * "propose none", not "propose them and leave them out of the course".
+     */
+    setPrerequisites: boolean;
+    setRequirements: boolean;
+    direction: string;
+}
+export interface ProposedCompletionRequirement {
+    type: CompletionRequirementType;
+    minScore?: number | null;
+}
+export interface ProposedItem {
+    contentType: OrganizeContentType;
+    contentId: string;
+    title: string;
+    /** False when the item already sits in the module the proposal put it in. */
+    isNew: boolean;
+    completionRequirement?: ProposedCompletionRequirement | null;
+}
+export interface ProposedModule {
+    /** 1-based, and the only handle a prerequisite has. Not an array index. */
+    position: number;
+    name: string;
+    isNew: boolean;
+    existingModuleId?: string | null;
+    rationale?: string;
+    prerequisitePositions: readonly number[];
+    requirementType?: 'all' | 'one';
+    items: readonly ProposedItem[];
+}
+export interface UnplacedItem {
+    contentType: OrganizeContentType;
+    contentId: string;
+    title: string;
+}
+export interface OrganizeProposal {
+    modules: readonly ProposedModule[];
+    unplacedItems: readonly UnplacedItem[];
+    /** Already in the reader's language. The package renders them, it does not interpret them. */
+    warnings: readonly string[];
+    /** Opaque to this package: a host's handle on the generation call, for its own telemetry. */
+    responseId?: string | null;
+}
+/**
+ * The host's transport, injected the way `executeQuery` is. `organize` owns whatever polling,
+ * retry or job plumbing its backend needs and resolves only once the proposal is final.
+ */
+export interface ModuleOrganizationActions {
+    organize(input: OrganizeInput, signal?: AbortSignal): Promise<OrganizeProposal>;
+    apply(proposal: OrganizeProposal, input: OrganizeInput, signal?: AbortSignal): Promise<void>;
+}
+export declare const defaultOrganizeInput: () => OrganizeInput;
+//# sourceMappingURL=types.d.ts.map

package/dist/organize/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/organize/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEzD,eAAO,MAAM,cAAc,0CAA2C,CAAA;AAEtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,eAAO,MAAM,sBAAsB,+DAAgE,CAAA;AAEnG,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC5C;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAA;IACzB,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,yBAAyB,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,mBAAmB,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAA;IACd,qBAAqB,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,eAAe,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;IAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,mBAAmB,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;IAClC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;IACtC,8FAA8F;IAC9F,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC/E,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7F;AAED,eAAO,MAAM,oBAAoB,QAAO,aAMtC,CAAA"}

package/dist/organize/useOrganizeModules.d.ts

@@ -0,0 +1,30 @@
+import { OrganizeInputErrors } from './validation';
+import { ModuleOrganizationActions, OrganizeInput, OrganizeProposal } from './types';
+/**
+ * How long the teacher waits before the wait itself is worth saying out loud. Long enough that a
+ * fast generation never flashes the line, short enough to land before a spinner reads as hung.
+ */
+export declare const ORGANIZE_SLOW_AFTER_MS = 10000;
+export type OrganizeStatus = 'form' | 'loading' | 'preview' | 'applying' | 'error';
+export interface UseOrganizeModulesOptions {
+    actions: ModuleOrganizationActions;
+    onApplied?: () => void;
+}
+export interface UseOrganizeModulesResult {
+    status: OrganizeStatus;
+    input: OrganizeInput;
+    setInput: (patch: Partial<OrganizeInput>) => void;
+    errors: OrganizeInputErrors;
+    canSubmit: boolean;
+    proposal: OrganizeProposal | null;
+    error: Error | null;
+    /** The request has outlived `ORGANIZE_SLOW_AFTER_MS` and is still running. */
+    takingLong: boolean;
+    submit: () => void;
+    regenerate: () => void;
+    apply: () => void;
+    /** Abandons whatever is in flight and returns to the form, keeping what was typed. */
+    cancel: () => void;
+}
+export declare function useOrganizeModules({ actions, onApplied, }: UseOrganizeModulesOptions): UseOrganizeModulesResult;
+//# sourceMappingURL=useOrganizeModules.d.ts.map

package/dist/organize/useOrganizeModules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOrganizeModules.d.ts","sourceRoot":"","sources":["../../src/organize/useOrganizeModules.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAA;AACrB,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAA;AAEhB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAE5C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAElF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,yBAAyB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IACjD,MAAM,EAAE,mBAAmB,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACjC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,sFAAsF;IACtF,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AA8BD,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,SAAS,GACV,EAAE,yBAAyB,GAAG,wBAAwB,CA0GtD"}

package/dist/organize/validation.d.ts

@@ -0,0 +1,8 @@
+import { OrganizeInput } from './types';
+export interface OrganizeInputErrors {
+    contentTypes?: 'none_selected';
+    direction?: 'too_long';
+}
+export declare function validateOrganizeInput(input: OrganizeInput): OrganizeInputErrors;
+export declare const hasOrganizeInputErrors: (errors: OrganizeInputErrors) => boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/organize/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/organize/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AAEjE,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAO/E;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,mBAAmB,KAAG,OACrC,CAAA"}

package/dist/types/extensions.d.ts

@@ -1,5 +1,11 @@
-import { ModuleItem } from './domain';
+import { Module, ModuleItem } from './domain';
 export declare const EXT_CAREER_ESTIMATED_DURATION_MINUTES = "career.estimatedDurationMinutes";
 export declare function getEstimatedDurationMinutes(item: Pick<ModuleItem, 'extensions'>): number | null;
 export declare function withEstimatedDurationMinutes(extensions: Record<string, unknown> | undefined, minutes: number | null | undefined): Record<string, unknown> | undefined;
+export declare const EXT_ORGANIZE_NEW_PLACEMENT = "organize.newPlacement";
+export declare const EXT_ORGANIZE_NEW_MODULE = "organize.newModule";
+export declare const EXT_ORGANIZE_ADDED_ITEM_COUNT = "organize.addedItemCount";
+export declare function isNewPlacement(item: Pick<ModuleItem, 'extensions'>): boolean;
+export declare function isProposedNewModule(module: Pick<Module, 'extensions'>): boolean;
+export declare function getAddedItemCount(module: Pick<Module, 'extensions'>): number;
 //# sourceMappingURL=extensions.d.ts.map

package/dist/types/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/types/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,eAAO,MAAM,qCAAqC,oCAAoC,CAAA;AAEtF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,MAAM,GAAG,IAAI,CAI/F;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/types/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAElD,eAAO,MAAM,qCAAqC,oCAAoC,CAAA;AAEtF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,MAAM,GAAG,IAAI,CAI/F;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC;AAED,eAAO,MAAM,0BAA0B,0BAA0B,CAAA;AAEjE,eAAO,MAAM,uBAAuB,uBAAuB,CAAA;AAE3D,eAAO,MAAM,6BAA6B,4BAA4B,CAAA;AAEtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,OAAO,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,OAAO,CAE/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,CAI5E"}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export type { ModuleItemStatus, ModuleProgress, ModuleStatus, CompletionRequirement, CompletionRequirementType, Module, ModuleItem, ModuleItemsPage, ModuleItemType, ModulesPage, PageInfo, PrerequisiteModule, } from './domain';
 export { type FilterCapabilities, type FilterClause, FilterClauseSchema, type FilterTarget, servesClause, type TargetCapabilities, } from './filterClause';
 export { CompletionRequirementSchema, CompletionRequirementTypeSchema, ModuleItemStatusSchema, ModuleProgressSchema, ModuleStatusSchema, ModuleItemSchema, ModuleItemsPageSchema, ModuleItemTypeSchema, ModuleSchema, ModulesPageSchema, PageInfoSchema, PrerequisiteModuleSchema, } from './schemas';
-export { EXT_CAREER_ESTIMATED_DURATION_MINUTES, getEstimatedDurationMinutes, withEstimatedDurationMinutes, } from './extensions';
+export { EXT_CAREER_ESTIMATED_DURATION_MINUTES, EXT_ORGANIZE_ADDED_ITEM_COUNT, EXT_ORGANIZE_NEW_MODULE, EXT_ORGANIZE_NEW_PLACEMENT, getAddedItemCount, getEstimatedDurationMinutes, isNewPlacement, isProposedNewModule, withEstimatedDurationMinutes, } from './extensions';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,EACN,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,GACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,wBAAwB,GACzB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,qCAAqC,EACrC,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,EACN,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,GACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,wBAAwB,GACzB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,qCAAqC,EACrC,6BAA6B,EAC7B,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,cAAc,CAAA"}

package/locales/en.json

@@ -24,7 +24,7 @@
   "modulesLoadingSpinnerLabel": "Loading modules",
   "noModulesEmptyState": "This course has no modules.",
   "filteredEmptyState": {
-    "one": "The only loaded module does not match this filter.",
+    "one": "%{count} loaded module does not match this filter.",
     "other": "None of the %{count} loaded modules match this filter."
   },
   "noFilterMatches": "No modules match this filter.",
@@ -32,7 +32,7 @@
   "loadMoreModulesLoading": "Loading more modules…",
   "loadMoreModules": "Load more modules (%{count} loaded)",
   "allModulesLoaded": {
-    "one": "The only module in this course is loaded.",
+    "one": "%{count} module in this course is loaded.",
     "other": "All %{count} modules in this course are loaded."
   },
   "filterGroupLabel": "Filter",
@@ -134,5 +134,50 @@
   "durationMinutes": "%{count} min",
   "itemUnpublishedLabel": "Unpublished",
   "itemUntitled": "Untitled item",
-  "opensInNewWindow": "opens in a new window"
+  "opensInNewWindow": "opens in a new window",
+  "organizeModulesTrigger": "Organize with AI",
+  "organizeModalLabel": "Organize content into modules",
+  "organizeProgressionLegend": "Module progression",
+  "organizeSetPrerequisites": "Set module prerequisites",
+  "organizeSetRequirements": "Set item requirements per module",
+  "organizeCloseModal": "Close",
+  "organizeModeLegend": "What should this do?",
+  "organizeModePlaceNew": "Place new content only",
+  "organizeModeReorganizeAll": "Reorganize the whole course",
+  "organizeReorganizeWarning": "This rebuilds every module in the course. Existing modules can be renamed, refilled, or removed.",
+  "organizeContentTypesLegend": "Content to organize",
+  "organizeDirectionLabel": "Anything else it should know? (optional)",
+  "organizeDirectionPlaceholder": "For example: keep the lab work together and put it last.",
+  "organizeDirectionCount": "%{used}/%{max}",
+  "organizeErrorPickAContentType": "Choose at least one kind of content.",
+  "organizeSubmit": "Organize",
+  "organizeCancel": "Cancel",
+  "organizeStartOver": "Start over",
+  "organizeRegenerate": "Regenerate",
+  "organizeApply": "Apply",
+  "organizeTryAgain": "Try again",
+  "organizeLoadingLabel": "Organizing your content\u2026",
+  "organizeApplyingLabel": "Creating your modules\u2026",
+  "organizeStillWorking": "Still working. Large courses take longer.",
+  "organizeProposalReadyAnnouncement": "Your proposal is ready to review.",
+  "organizeAppliedAnnouncement": "Your modules were created.",
+  "organizeFailed": "Your content could not be organized: %{message}",
+  "organizeApplyFailed": "Your modules could not be created: %{message}",
+  "organizePreviewHeading": "Proposed modules",
+  "organizeNewModuleLabel": "New module",
+  "organizeItemsAddedLabel": {
+    "one": "%{count} item added",
+    "other": "%{count} items added"
+  },
+  "organizeNewItemPill": "New",
+  "metaFieldNewPlacementLabel": "New placement",
+  "organizeUnplacedHeading": {
+    "one": "%{count} item was not placed",
+    "other": "%{count} items were not placed"
+  },
+  "organizeUnplacedExplanation": "You can still apply this. Anything left out stays where it is.",
+  "organizeWarningsHeading": {
+    "one": "%{count} thing to know",
+    "other": "%{count} things to know"
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instructure/platform-modules",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -21,17 +21,22 @@
     "@instructure/ui-a11y-content": "^11.0.0",
     "@instructure/ui-alerts": "^11.7.0",
     "@instructure/ui-buttons": "^11.7.0",
+    "@instructure/ui-checkbox": "^11.7.0",
     "@instructure/ui-color-utils": "^11.7.0",
     "@instructure/ui-flex": "^11.7.0",
     "@instructure/ui-heading": "^11.7.0",
     "@instructure/ui-icons": "^11.7.0",
     "@instructure/ui-link": "^11.7.0",
+    "@instructure/ui-list": "^11.7.0",
     "@instructure/ui-menu": "^11.7.0",
+    "@instructure/ui-modal": "^11.7.0",
     "@instructure/ui-pill": "^11.7.0",
     "@instructure/ui-progress": "^11.7.0",
+    "@instructure/ui-radio-input": "^11.7.0",
     "@instructure/ui-responsive": "^11.0.0",
     "@instructure/ui-spinner": "^11.7.0",
     "@instructure/ui-text": "^11.7.0",
+    "@instructure/ui-text-area": "^11.7.0",
     "@instructure/ui-text-input": "^11.7.0",
     "@instructure/ui-tooltip": "^11.7.0",
     "@instructure/ui-view": "^11.7.0",
@@ -44,7 +49,7 @@
   "dependencies": {
     "graphql-tag": "^2.12.6",
     "p-limit": "^6.1.0",
-    "@instructure/platform-instui-bindings": "0.6.4",
+    "@instructure/platform-instui-bindings": "0.6.5",
     "@instructure/platform-with-breakpoints": "0.3.0"
   },
   "devDependencies": {
@@ -52,17 +57,22 @@
     "@instructure/ui-a11y-content": "11.7.4",
     "@instructure/ui-alerts": "11.7.4",
     "@instructure/ui-buttons": "11.7.4",
+    "@instructure/ui-checkbox": "11.7.4",
     "@instructure/ui-color-utils": "11.7.4",
     "@instructure/ui-flex": "11.7.4",
     "@instructure/ui-heading": "11.7.4",
     "@instructure/ui-icons": "11.7.4",
     "@instructure/ui-link": "11.7.4",
+    "@instructure/ui-list": "11.7.4",
     "@instructure/ui-menu": "11.7.4",
+    "@instructure/ui-modal": "11.7.4",
     "@instructure/ui-pill": "11.7.4",
     "@instructure/ui-progress": "11.7.4",
+    "@instructure/ui-radio-input": "11.7.4",
     "@instructure/ui-responsive": "11.7.4",
     "@instructure/ui-spinner": "11.7.4",
     "@instructure/ui-text": "11.7.4",
+    "@instructure/ui-text-area": "11.7.4",
     "@instructure/ui-text-input": "11.7.4",
     "@instructure/ui-themes": "11.7.4",
     "@instructure/ui-tooltip": "11.7.4",