@skillcdn/console 0.3.0 → 0.3.2

package/src/console.tsx

@@ -35,6 +35,7 @@ import {
   RULES_PATH,
   RULES_TITLE,
   type TaskState,
+  type WeekStart,
 } from "./api.js";
 import { Board, BoardFilters, type BoardProps, byDue, filterTasks } from "./components/board.js";
 import { Calendar, type CalendarProps, Workload } from "./components/calendar.js";
@@ -44,12 +45,12 @@ import { DecisionForm } from "./components/decision-form.js";
 import { DecisionCard, DecisionList, type DecisionListProps } from "./components/decision-list.js";
 import { EventFeed, type EventFeedProps } from "./components/event-feed.js";
 import { GoalForm, GoalList, type GoalListProps, GoalView, goalMonth } from "./components/goals.js";
+import { PackTokenWays } from "./components/pack-token.js";
 import { PAGE_SIZE } from "./components/paged.js";
 import { ListingForm, PeopleList, type PeopleListProps } from "./components/people.js";
 import {
   MemberList,
   type MemberListProps,
-  PackTokenForm,
   ProjectForm,
   ProjectList,
   type ProjectListProps,
@@ -81,6 +82,12 @@ import {
   Time,
 } from "./components/ui.js";
 import { WorkList, type WorkListProps } from "./components/work.js";
+import {
+  peopleVisibilityOf,
+  WorkspaceSettingsForm,
+  WorkspaceSettingsView,
+  weekStartOf,
+} from "./components/workspace.js";
 import { ConnectPage } from "./connect-page.js";
 import { type ConsoleData, useConsoleData } from "./data.js";
 import { monthOf, today } from "./dates.js";
@@ -593,6 +600,28 @@ function TaskPage(props: {
     (fetched !== undefined && (fetched.id === route.id || fetched.number === route.number)
       ? fetched
       : undefined);
+  // The task this one is part of: among the board's, or asked for by itself when it was put away.
+  const parentId = task?.parentId ?? null;
+  const parentOnBoard =
+    parentId === null ? undefined : data.tasks.find((candidate) => candidate.id === parentId);
+  const [parentFetched, setParentFetched] = useState<RestTask | undefined>(undefined);
+  const parentWanted =
+    parentId !== null && parentOnBoard === undefined && data.projectLoaded ? parentId : undefined;
+  useEffect(() => {
+    if (parentWanted === undefined) {
+      return;
+    }
+    const controller = new AbortController();
+    fetchTask(parentWanted, controller.signal)
+      .then((found) => {
+        if (!controller.signal.aborted) {
+          setParentFetched(found);
+        }
+      })
+      .catch(() => undefined);
+    return () => controller.abort();
+  }, [parentWanted, fetchTask]);
+  const parent = parentOnBoard ?? (parentFetched?.id === parentId ? parentFetched : undefined);
   const [history, setHistory] = useState<readonly RestEvent[] | undefined>(undefined);
   const [comments, setComments] = useState<readonly RestComment[] | undefined>(undefined);
   const { taskHistory, taskComments } = data.actions;
@@ -646,6 +675,9 @@ function TaskPage(props: {
       task={task}
       people={data.people.filter(inWorkspace)}
       tasks={data.tasks}
+      parent={parent}
+      findTasks={data.actions.findTasks}
+      findGoals={data.actions.findGoals}
       decisions={data.decisions}
       runs={data.runs}
       comments={comments}
@@ -798,9 +830,9 @@ function ProjectPage(props: {
         <section className="sc-panel sc-panel-form" aria-label={words.task.newAria}>
           <TaskForm
             people={data.people.filter(inWorkspace)}
-            parents={data.tasks}
+            findTasks={data.actions.findTasks}
             categories={data.categories}
-            goals={data.goals}
+            findGoals={data.actions.findGoals}
             busy={busy}
             onSubmit={(input: RestTaskInput) =>
               void act(async () => {
@@ -861,6 +893,7 @@ function ProjectPage(props: {
           tasks={shown}
           month={month}
           today={now}
+          weekStart={weekStartOf(data.me?.workspace)}
           categories={data.categories}
           goals={data.goals}
           taskHref={href}
@@ -899,6 +932,7 @@ function ProjectPage(props: {
             <Workload
               tasks={shown}
               today={now}
+              weekStart={weekStartOf(data.me?.workspace)}
               personHref={(person) =>
                 boardHref(key, person === undefined ? {} : { person: person.id })
               }
@@ -1075,6 +1109,7 @@ function ProjectPage(props: {
               tasks={towards}
               month={month}
               today={now}
+              weekStart={weekStartOf(data.me?.workspace)}
               categories={data.categories}
               goals={[goal]}
               taskHref={href}
@@ -1220,19 +1255,34 @@ function ProjectPage(props: {
     const me = data.me?.person ?? undefined;
     const configures = owner;
     const members = words.projects.members;
+    // In a project open to the workspace everyone is a member already (ADR-0035): the list is
+    // everyone, nobody is added or removed, and an owner is made from a row. Where the People
+    // page shows a member only whom they share a project with, an owner lists someone the list
+    // does not show by their login.
+    const open = project.visibility === "workspace";
+    const narrowed =
+      peopleVisibilityOf(data.me?.workspace) === "shared_projects" && me?.role !== "admin";
     return (
       <>
         <div className="sc-page-head">
           <h1 className="sc-page-title">{members.title}</h1>
         </div>
-        <p className="sc-lead">{words.vocabulary.visibility[project.visibility]}</p>
+        {open && <p className="sc-lead">{members.open}</p>}
         {error !== undefined && <Callout tone="danger">{error}</Callout>}
         <components.MemberList
           members={data.members}
           people={data.people.filter(inWorkspace)}
           me={me}
+          open={open}
           busy={busy}
-          onAdd={configures ? (input) => void act(() => data.actions.addMember(input)) : undefined}
+          onAdd={
+            configures && !open
+              ? (input) => void act(() => data.actions.addMember(input))
+              : undefined
+          }
+          lookup={
+            configures && !open && narrowed ? (login) => data.actions.findPerson(login) : undefined
+          }
           onChangeRole={
             configures
               ? (member, role) =>
@@ -1240,7 +1290,7 @@ function ProjectPage(props: {
               : undefined
           }
           onRemove={
-            configures
+            configures && !open
               ? (member) => void act(() => data.actions.removeMember(member.person.id))
               : undefined
           }
@@ -1382,28 +1432,33 @@ function ProjectSettingsPage(props: {
       <>
         {head}
         {error !== undefined && <Callout tone="danger">{error}</Callout>}
-        <section className="sc-panel sc-panel-form" aria-label={words.projects.packToken.aria}>
-          <PackTokenForm
-            set={project.packToken !== null}
-            busy={busy}
-            onSubmit={(token) =>
-              void act(async () => {
-                await data.actions.setPackToken(token);
-                navigation.replace(here);
-              })
-            }
-            onRemove={
-              project.packToken === null
-                ? undefined
-                : () =>
-                    void act(async () => {
-                      await data.actions.removePackToken();
-                      navigation.replace(here);
-                    })
-            }
-            onCancel={() => navigation.back(here)}
-          />
-        </section>
+        <PackTokenWays
+          title={settings.packToken}
+          intro={words.projects.packToken.intro}
+          set={project.packToken !== null}
+          setAt={project.packToken?.setAt}
+          busy={busy}
+          onStart={data.actions.connectPackToken}
+          poll={data.actions.packTokenConnection}
+          onCancelConnect={data.actions.cancelPackTokenConnection}
+          onConnected={() => navigation.replace(here)}
+          onSubmit={(token) =>
+            void act(async () => {
+              await data.actions.setPackToken(token);
+              navigation.replace(here);
+            })
+          }
+          onRemove={
+            project.packToken === null
+              ? undefined
+              : () =>
+                  void act(async () => {
+                    await data.actions.removePackToken();
+                    navigation.replace(here);
+                  })
+          }
+          onBack={() => navigation.back(here)}
+        />
       </>
     );
   }
@@ -1455,7 +1510,9 @@ function ProjectSettingsPage(props: {
               {owner && (
                 <>
                   {" "}
-                  <a href={projectSettingsHref(key, "pack-token")}>{settings.packTokenEdit}</a>
+                  <a href={projectSettingsHref(key, "pack-token")}>
+                    {project.packToken === null ? settings.packTokenAdd : settings.packTokenEdit}
+                  </a>
                 </>
               )}
             </dd>
@@ -1516,7 +1573,7 @@ function ProjectSettingsPage(props: {
  * from, which whoever runs the console set. Read by everyone; the rules written by an administrator.
  */
 function WorkspaceSettingsPage(props: {
-  readonly form: "rules" | undefined;
+  readonly form: "rules" | "workspace" | "pack-token" | undefined;
   readonly data: ConsoleData;
   readonly navigation: Navigation;
 }) {
@@ -1524,7 +1581,8 @@ function WorkspaceSettingsPage(props: {
   const { form, data, navigation } = props;
   const { busy, error, act } = useAction();
   const administrator = data.me?.person?.role === "admin";
-  const skills = data.me?.workspace.skills;
+  const workspace = data.me?.workspace;
+  const skills = workspace?.skills;
   const [rules, setRules] = useState<RestRules | undefined>(undefined);
   useEffect(() => {
     const controller = new AbortController();
@@ -1587,10 +1645,90 @@ function WorkspaceSettingsPage(props: {
       </>
     );
   }
+  if (form === "pack-token") {
+    if (!administrator || workspace === undefined) {
+      return <NothingHere />;
+    }
+    const held = workspace.skills.packToken ?? null;
+    return (
+      <>
+        {head}
+        {error !== undefined && <Callout tone="danger">{error}</Callout>}
+        <PackTokenWays
+          title={words.settings.skillsToken}
+          intro={words.settings.skillsTokenIntro}
+          set={held !== null}
+          setAt={held?.setAt}
+          busy={busy}
+          onStart={data.actions.connectWorkspacePackToken}
+          poll={data.actions.workspacePackTokenConnection}
+          onCancelConnect={data.actions.cancelWorkspacePackTokenConnection}
+          onConnected={() => navigation.replace(PATHS.settings)}
+          onSubmit={(token) =>
+            void act(async () => {
+              await data.actions.setWorkspacePackToken(token);
+              navigation.replace(PATHS.settings);
+            })
+          }
+          onRemove={
+            held === null
+              ? undefined
+              : () =>
+                  void act(async () => {
+                    await data.actions.removeWorkspacePackToken();
+                    navigation.replace(PATHS.settings);
+                  })
+          }
+          onBack={() => navigation.back(PATHS.settings)}
+        />
+      </>
+    );
+  }
+  if (form === "workspace") {
+    if (!administrator || workspace === undefined) {
+      return <NothingHere />;
+    }
+    return (
+      <>
+        {head}
+        {error !== undefined && <Callout tone="danger">{error}</Callout>}
+        <section className="sc-panel sc-panel-form" aria-label={words.settings.workspace.aria}>
+          <h2 className="sc-section-title">{words.settings.workspace.title}</h2>
+          <WorkspaceSettingsForm
+            workspace={workspace}
+            busy={busy}
+            onSubmit={(patch) =>
+              void act(async () => {
+                await data.actions.updateWorkspace(patch);
+                navigation.replace(PATHS.settings);
+              })
+            }
+            onCancel={() => navigation.back(PATHS.settings)}
+          />
+        </section>
+      </>
+    );
+  }
   return (
     <>
       {head}
       {error !== undefined && <Callout tone="danger">{error}</Callout>}
+      {workspace !== undefined && (
+        <section className="sc-panel" aria-label={words.settings.workspace.aria}>
+          <div className="sc-section-head">
+            <h2 className="sc-section-title">{words.settings.workspace.title}</h2>
+            {administrator && (
+              <a
+                className="sc-button sc-button-secondary sc-button-sm"
+                href={settingsHref("workspace")}
+              >
+                {words.common.edit}
+              </a>
+            )}
+          </div>
+          <WorkspaceSettingsView workspace={workspace} />
+        </section>
+      )}
       <section className="sc-panel" aria-label={words.rules.title}>
         <h2 className="sc-section-title">{words.rules.title}</h2>
         {rules === undefined ? (
@@ -1651,6 +1789,30 @@ function WorkspaceSettingsPage(props: {
                 )}
               </dd>
             </div>
+            {skills.address !== null && (
+              <div>
+                <dt>{words.settings.skillsToken}</dt>
+                <dd>
+                  {skills.packToken == null ? (
+                    <span className="sc-muted">{words.projects.settings.packTokenNone}</span>
+                  ) : (
+                    <>
+                      {words.projects.settings.packTokenSet} <Time iso={skills.packToken.setAt} />
+                    </>
+                  )}
+                  {administrator && (
+                    <>
+                      {" "}
+                      <a href={settingsHref("pack-token")}>
+                        {skills.packToken == null
+                          ? words.projects.settings.packTokenAdd
+                          : words.projects.settings.packTokenEdit}
+                      </a>
+                    </>
+                  )}
+                </dd>
+              </div>
+            )}
           </dl>
           <p className="sc-muted">{words.settings.skillsFromConfiguration}</p>
         </section>
@@ -1660,7 +1822,7 @@ function WorkspaceSettingsPage(props: {
 }
 
 /** A file a person chose, as the client sends it: its name, its bytes and the type the browser says. */
-/** Whether a person is in: who a picker of assignees and of members offers (ADR-0022). */
+/** Whether a person is in: who a picker of workers and of members offers (ADR-0022). */
 const inWorkspace = (person: { readonly status: "active" | "deactivated" }): boolean =>
   person.status === "active";
 
@@ -1777,6 +1939,8 @@ function PlatePage(props: {
   readonly empty: { readonly title: string; readonly body: string };
   /** What a refusal says where the plate may not be the asker's to see; the server's words otherwise. */
   readonly refused?: { readonly title: string; readonly body: string } | undefined;
+  /** The day the week begins on, as the workspace says (ADR-0035). */
+  readonly weekStart?: WeekStart | undefined;
 }) {
   const words = useWords();
   const { components, load, couldNotLoad, refused } = props;
@@ -1837,6 +2001,7 @@ function PlatePage(props: {
         <components.WorkList
           work={plate}
           week={props.week}
+          weekStart={props.weekStart}
           taskHref={(projectKey, task) => taskHref(projectKey, task.number)}
           decisionHref={(projectKey, decisionId) => decisionHref(projectKey, decisionId)}
           weekHref={props.weekHref}
@@ -1860,6 +2025,7 @@ function WorkPage(props: {
       load={work}
       title={words.work.title}
       week={props.week}
+      weekStart={weekStartOf(props.data.me?.workspace)}
       weekHref={workHref}
       loading={words.work.loading}
       couldNotLoad={words.work.couldNotLoad}
@@ -1888,6 +2054,7 @@ function PersonWorkPage(props: {
       title={words.people.workOf(name)}
       aside={<LinkButton href={PATHS.people}>{words.nav.people}</LinkButton>}
       week={props.week}
+      weekStart={weekStartOf(data.me?.workspace)}
       weekHref={(day) => personWorkHref(id, day)}
       loading={words.people.loadingWork}
       couldNotLoad={words.people.couldNotLoadWork}
@@ -1958,6 +2125,8 @@ function WorkspacePage(props: {
     const making = route.name === "new-listing" && administrator;
     // An owner sees the work of the people in their projects; the console refuses the rest.
     const oversees = administrator || data.projects.some((project) => project.role === "owner");
+    // The list is what the policy shows (ADR-0035): everyone, or the people one shares a project with.
+    const narrowed = peopleVisibilityOf(data.me?.workspace) === "shared_projects" && !administrator;
     return (
       <>
         <div className="sc-page-head">
@@ -1968,6 +2137,7 @@ function WorkspacePage(props: {
             </LinkButton>
           )}
         </div>
+        {narrowed && <p className="sc-lead">{words.people.narrowed}</p>}
         {error !== undefined && <Callout tone="danger">{error}</Callout>}
         {making && (
           <section className="sc-panel sc-panel-form" aria-label={words.people.letInAria}>

package/src/data.ts

@@ -24,6 +24,7 @@ import {
   type RestGoal,
   type RestGoalInput,
   type RestGoalPatch,
+  type RestGoals,
   type RestListing,
   type RestListingInput,
   type RestMe,
@@ -32,6 +33,8 @@ import {
   type RestMemberPatch,
   type RestMePatch,
   type RestOrganization,
+  type RestPackConnect,
+  type RestPackConnectStarted,
   type RestPerson,
   type RestPersonPatch,
   type RestPersonWork,
@@ -54,6 +57,9 @@ import {
   type RestVersion,
   type RestVersions,
   type RestWork,
+  type RestWorkspace,
+  type RestWorkspacePackConnect,
+  type RestWorkspacePatch,
   restEventSchema,
 } from "./api.js";
 
@@ -80,6 +86,11 @@ export interface ConsoleActions {
   /** Sets the pack token of the project the page is on, or takes it away; for an owner (ADR-0028). */
   setPackToken(token: string): Promise<RestProject>;
   removePackToken(): Promise<RestProject>;
+  /** Asks the deployment to connect the project's pack with a code a person approves (ADR-0036); for an owner. */
+  connectPackToken(): Promise<RestPackConnectStarted>;
+  /** How that connection stands; once connected, the project is the one answered. */
+  packTokenConnection(signal?: AbortSignal): Promise<RestPackConnect>;
+  cancelPackTokenConnection(): Promise<void>;
   addMember(input: RestMemberInput): Promise<RestMember>;
   updateMember(personId: string, patch: RestMemberPatch): Promise<RestMember>;
   removeMember(personId: string): Promise<void>;
@@ -97,6 +108,18 @@ export interface ConsoleActions {
     page: { readonly limit: number; readonly offset: number },
     signal?: AbortSignal,
   ): Promise<RestTasks>;
+  /** What words find among the current tasks of the project, a page at a time, for a picker (ADR-0037); the first page of them for no words. */
+  findTasks(
+    query: string,
+    page: { readonly limit: number; readonly offset: number },
+    signal?: AbortSignal,
+  ): Promise<RestTasks>;
+  /** What words find among the open goals of the project, a page at a time, for a picker. */
+  findGoals(
+    query: string,
+    page: { readonly limit: number; readonly offset: number },
+    signal?: AbortSignal,
+  ): Promise<RestGoals>;
   raiseDecision(input: RestDecisionInput): Promise<RestDecision>;
   answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
   /** Grows a decision's record: its context, or what followed. */
@@ -133,6 +156,16 @@ export interface ConsoleActions {
   removeListing(id: string): Promise<void>;
   /** Keeps the person's own choice of language (ADR-0012). */
   updateMe(patch: RestMePatch): Promise<RestMe>;
+  /** Changes the workspace's settings (ADR-0035); for an administrator. `me` says them from then on. */
+  updateWorkspace(patch: RestWorkspacePatch): Promise<RestWorkspace>;
+  /** The workspace's SkillCDN token (ADR-0036), for an administrator: set, taken away, or connected with a code. */
+  setWorkspacePackToken(token: string): Promise<RestWorkspace>;
+  removeWorkspacePackToken(): Promise<RestWorkspace>;
+  connectWorkspacePackToken(): Promise<RestPackConnectStarted>;
+  workspacePackTokenConnection(signal?: AbortSignal): Promise<RestWorkspacePackConnect>;
+  cancelWorkspacePackTokenConnection(): Promise<void>;
+  /** One person of the workspace by their exact login, or nobody: what an owner lists someone the People page does not show by. */
+  findPerson(login: string, signal?: AbortSignal): Promise<RestPerson | undefined>;
   /** Marks a run that will not come back as abandoned. */
   abandonRun(id: string): Promise<RestRun>;
   /** Everything that happened to one task of the project, oldest first. */
@@ -245,6 +278,32 @@ async function readTasks(
   return { items };
 }
 
+/** How many pages of the roadmap are read before it is shown as it stands. */
+const GOALS_MAX_PAGES = 20;
+
+/**
+ * The goals of a project, whole: page after page while the server says there is more, since
+ * the roadmap, the calendar and the filters draw them all.
+ */
+async function readGoals(
+  scope: ProjectClient,
+  signal: AbortSignal | undefined,
+): Promise<{ readonly items: RestGoal[] }> {
+  const items: RestGoal[] = [];
+  for (let page = 0; page < GOALS_MAX_PAGES; page += 1) {
+    const result = await scope.goals({ limit: LIST_LIMIT, offset: page * LIST_LIMIT }, signal);
+    items.push(...result.items);
+    if (!result.more) {
+      break;
+    }
+  }
+  return { items };
+}
+
+/** The words of a search as the API takes them: none for a blank. */
+const searchWordsOf = (query: string): { readonly q?: string } =>
+  query.trim() === "" ? {} : { q: query.trim() };
+
 /** How many pages of the decisions are read before the record is shown as it stands. */
 const DECISIONS_MAX_PAGES = 20;
 
@@ -333,7 +392,7 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
           scope.get(signal),
           readTasks(scope, signal),
           readDecisions(scope, signal),
-          scope.goals({}, signal),
+          readGoals(scope, signal),
           scope.runs(undefined, signal),
           scope.members(signal),
         ]);
@@ -538,6 +597,15 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         setProject(changed);
         return changed;
       },
+      connectPackToken: () => scope().connectPackToken(),
+      async packTokenConnection(signal) {
+        const state = await scope().packTokenConnection(signal);
+        if (state.status === "connected") {
+          setProject(state.project);
+        }
+        return state;
+      },
+      cancelPackTokenConnection: () => scope().cancelPackTokenConnection(),
       async addMember(input) {
         const member = await scope().addMember(input);
         await refreshProject();
@@ -579,6 +647,10 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         return archived;
       },
       archivedTasks: (page, signal) => scope().tasks({ archived: true, ...page }, signal),
+      findTasks: (query, page, signal) =>
+        scope().tasks({ archived: false, ...searchWordsOf(query), ...page }, signal),
+      findGoals: (query, page, signal) =>
+        scope().goals({ open: true, ...searchWordsOf(query), ...page }, signal),
       async raiseDecision(input) {
         const decision = await scope().raiseDecision(input);
         await refreshProject();
@@ -649,6 +721,34 @@ export function useConsoleData(client: ConsoleClient, projectKey: string | undef
         setMe(answer);
         return answer;
       },
+      async updateWorkspace(patch) {
+        const workspace = await client.updateWorkspace(patch);
+        setMe((current) => (current === undefined ? undefined : { ...current, workspace }));
+        // The member visibility may have changed: the people are read again under the new setting.
+        await refreshWorkspace();
+        return workspace;
+      },
+      async setWorkspacePackToken(token) {
+        const workspace = await client.setWorkspacePackToken({ token });
+        setMe((current) => (current === undefined ? undefined : { ...current, workspace }));
+        return workspace;
+      },
+      async removeWorkspacePackToken() {
+        const workspace = await client.removeWorkspacePackToken();
+        setMe((current) => (current === undefined ? undefined : { ...current, workspace }));
+        return workspace;
+      },
+      connectWorkspacePackToken: () => client.connectWorkspacePackToken(),
+      async workspacePackTokenConnection(signal) {
+        const state = await client.workspacePackTokenConnection(signal);
+        if (state.status === "connected") {
+          const { workspace } = state;
+          setMe((current) => (current === undefined ? undefined : { ...current, workspace }));
+        }
+        return state;
+      },
+      cancelWorkspacePackTokenConnection: () => client.cancelWorkspacePackTokenConnection(),
+      findPerson: (login, signal) => client.findPerson(login, signal),
       async abandonRun(id) {
         const run = await scope().endRun(id, { status: "abandoned" });
         await refreshProject();

package/src/dates.ts

@@ -1,3 +1,5 @@
+import type { WeekStart } from "./vocabulary.js";
+
 // Days, as the plan is made in (ADR-0019): `2026-10-20`, read and written as the strings they
 // are, so that a deadline is the same day wherever the people are. The browser's own clock says
 // which day is today; nothing here looks at it unless asked.
@@ -62,8 +64,27 @@ export function addMonths(month: string, count: number): string {
   return `${String(date.getFullYear()).padStart(4, "0")}-${String(date.getMonth() + 1).padStart(2, "0")}`;
 }
 
-/** The weekday a week begins on where the language is spoken: 1 for Monday, 7 for Sunday. */
-export function firstDayOfWeek(language: string): number {
+/**
+ * The language and region of the device the pages are read on, as the browser says: `ko-KR`,
+ * `en-GB`. The fallback where there is no browser to ask. The week begins as this has it
+ * where the workspace leaves the choice to the system default (ADR-0035).
+ */
+export function deviceLanguage(fallback: string): string {
+  const browser = (globalThis as { readonly navigator?: { readonly language?: string } }).navigator;
+  return browser?.language ?? fallback;
+}
+
+/**
+ * The weekday a week begins on: as the workspace says (ADR-0035), Monday or Sunday, else as the
+ * language and region have it, the device's by {@link deviceLanguage}. 1 for Monday, 7 for Sunday.
+ */
+export function firstDayOfWeek(language: string, weekStart?: WeekStart | undefined): number {
+  if (weekStart === "monday") {
+    return 1;
+  }
+  if (weekStart === "sunday") {
+    return 7;
+  }
   try {
     const locale = new Intl.Locale(language) as Intl.Locale & {
       readonly weekInfo?: { readonly firstDay: number };