@skillcdn/console 0.3.0 → 0.3.1

package/src/i18n/ko.ts

@@ -20,7 +20,12 @@ export const ko: Messages = {
     role: { admin: "관리자", member: "멤버" },
     status: { active: "활성", deactivated: "비활성화" },
     projectRole: { owner: "소유자", member: "멤버" },
-    visibility: { workspace: "워크스페이스의 모두", private: "목록에 있는 사람만" },
+    visibility: { workspace: "공개: 워크스페이스의 모두", private: "비공개: 목록에 있는 사람만" },
+    peopleVisibility: {
+      everyone: "워크스페이스의 모두",
+      shared_projects: "같은 프로젝트에 속한 사람만",
+    },
+    weekStart: { auto: "시스템 기본", monday: "월요일", sunday: "일요일" },
     runStatus: {
       running: "열림",
       waiting: "결정 대기 중",
@@ -163,6 +168,12 @@ export const ko: Messages = {
       chooseSomeone: "선택하세요",
       as: "역할",
       add: "추가",
+      open: "공개 프로젝트입니다. 워크스페이스의 모든 구성원이 멤버이고, 소유자는 이 목록에서 지정합니다.",
+      addByLoginAria: "로그인으로 멤버 추가",
+      login: "로그인",
+      addByLogin: "로그인으로 추가",
+      lookupHint: "목록에 보이지 않는 사람: 깃 호스트의 로그인이나 주소를 정확히 적습니다.",
+      nobodyCalled: (login) => `워크스페이스에 ${login}이라는 사람이 없습니다.`,
       empty: {
         title: "목록에 아무도 없습니다",
         workspace: "워크스페이스의 모두가 속해 있고, 관리자가 소유합니다.",
@@ -170,11 +181,33 @@ export const ko: Messages = {
       },
     },
     packToken: {
-      aria: "팩 토큰",
+      aria: "SkillCDN 토큰",
+      intro:
+        "비공개 팩은 저장소에 대한 SkillCDN 토큰으로 읽습니다. 공개 팩에는 필요 없습니다. SkillCDN에서 승인한 코드로 연결하거나, 거기서 직접 만든 토큰을 붙여 넣으세요. 콘솔은 토큰을 봉인해 보관하고 누구에게도 보여 주지 않습니다. 조직의 팩을 읽는 프로젝트는 워크스페이스 설정의 토큰을 그대로 쓸 수 있습니다.",
+      connectTitle: "SkillCDN에서 승인한 코드로",
+      pasteTitle: "직접 만든 토큰으로",
+      pasteAria: "토큰 붙여넣기",
       label: "토큰",
-      hint: "사람이 SkillCDN 계정 페이지에서 팩의 저장소에 대해 만든 토큰입니다. 콘솔이 봉인해 보관하고, 프로젝트를 볼 수 있는 사람을 위해 팩을 읽는 데 쓰며, 누구에게도 보여 주지 않습니다.",
+      hint: "SkillCDN 계정 페이지에서 팩의 저장소에 대해 만든 토큰입니다.",
+      setSince: "토큰이 설정되어 있습니다:",
       placeholder: "scdn_repo_…",
+      connect: "SkillCDN에서 연결",
+      connectHint:
+        "콘솔이 SkillCDN에 코드를 요청합니다. 안내된 페이지를 저장소를 볼 수 있는 계정으로 열어, 코드를 확인하고 승인하세요.",
+      connectCode: "코드",
+      connectOpen: "SkillCDN 페이지 열기",
+      connectWaiting: "SkillCDN에서 승인을 기다리는 중입니다.",
+      connectExpires: "코드 만료:",
+      connectCancel: "기다리기 중단",
+      connectDone: "연결되었습니다. 콘솔이 이제 이 토큰으로 팩을 읽습니다.",
+      connectEnded: {
+        expired: "승인되기 전에 코드가 만료되었습니다. 다시 연결해 새 코드를 받으세요.",
+        declined: "SkillCDN에서 요청이 거절되었거나 코드가 이미 쓰였습니다.",
+        refused:
+          "SkillCDN이 요청을 거부했습니다. 그 사람이 볼 수 없는 저장소이거나, 공개 팩이라 토큰이 필요 없거나, 토큰을 더 만들 수 없습니다.",
+      },
       set: "토큰 넣기",
+      replace: "토큰 바꾸기",
       remove: "토큰 빼기",
     },
     settings: {
@@ -183,10 +216,11 @@ export const ko: Messages = {
       edit: "프로젝트 편집",
       organizationsSkills: (address) => `조직의 스킬: ${address}`,
       noSkills: "없음: 콘솔에 조직의 주소가 없습니다.",
-      packToken: "팩 토큰",
-      packTokenNone: "없음: 공개 팩은 필요 없고, 비공개 팩은 읽히지 않습니다.",
+      packToken: "SkillCDN 토큰",
+      packTokenNone: "없음",
       packTokenSet: "설정됨",
       packTokenEdit: "바꾸기",
+      packTokenAdd: "등록",
     },
   },
 
@@ -464,6 +498,26 @@ export const ko: Messages = {
     noSkillsAddress: "주소 없음: 프로젝트마다 자기 주소를 두거나, 두지 않습니다.",
     skillsFromConfiguration:
       "콘솔을 운영하는 쪽이 설정으로 정합니다. 스킬을 읽어 오는 배포와 조직의 주소.",
+    skillsToken: "SkillCDN 토큰",
+    skillsTokenIntro:
+      "자기 주소도 자기 토큰도 없는 모든 프로젝트가 이 토큰으로 조직의 팩을 읽습니다. 공개 팩에는 필요 없습니다. SkillCDN에서 승인한 코드로 연결하거나, 거기서 직접 만든 토큰을 붙여 넣으세요. 콘솔은 토큰을 봉인해 보관하고 누구에게도 보여 주지 않습니다.",
+    workspace: {
+      title: "워크스페이스",
+      aria: "워크스페이스 설정",
+      peopleVisibility: "멤버 공개 범위",
+      peopleVisibilityHint:
+        "멤버가 사람들 페이지와 선택 목록에서 보는 범위: 워크스페이스의 모두, 또는 같은 프로젝트에 속한 사람만. 관리자는 언제나 모두를 보고, 워크스페이스에 공개된 프로젝트에는 모두가 속합니다.",
+      weekStart: "주의 시작 요일",
+      weekStartHint:
+        "캘린더와 내 작업에서. 시스템 기본은 각 사람의 기기에 설정된 언어와 지역을 따르고, 월요일이나 일요일은 모두에게 같게 적용됩니다.",
+      timeZone: "타임존",
+      timeZoneHint:
+        "콘솔 명령과 에이전트가 시각을 이 타임존으로 찍습니다. 페이지는 각 기기의 타임존으로 보여 줍니다. 없음이면 명령은 UTC로 찍습니다.",
+      timeZoneNone: "없음",
+      timeZoneDevice: (zone) => `이 기기: ${zone}`,
+      timeZoneUseDevice: (zone) => `이 기기의 타임존 쓰기: ${zone}`,
+      save: "설정 저장",
+    },
   },
 
   rules: {
@@ -527,9 +581,14 @@ export const ko: Messages = {
       dueOn: "기한",
       state: "상태",
       color: "색",
+      peopleVisibility: "멤버 공개 범위",
+      weekStart: "주의 시작 요일",
+      timeZone: "타임존",
+      packToken: "SkillCDN 토큰",
     },
     event: {
       personJoined: () => "보드에 들어왔습니다",
+      workspaceUpdated: (fields) => `워크스페이스의 ${fields}을(를) 바꿨습니다`,
       roleChanged: (login, role) => `${login}을(를) ${role}(으)로 지정했습니다`,
       personListed: (login) => `${login}을(를) 추가했습니다`,
       personUnlisted: (login) => `${login}을(를) 목록에서 뺐습니다`,
@@ -647,9 +706,9 @@ export const ko: Messages = {
       indexing: "SkillCDN이 아직 저장소를 색인하고 있습니다. 잠시 후 다시 보세요.",
       failed: "SkillCDN이 저장소를 색인하지 못했습니다. 찾은 내용은 주소의 페이지에 있습니다.",
       not_found:
-        "SkillCDN이 이 주소를 콘솔에 제공하지 않습니다. 그곳에 아무것도 없거나, 비공개 팩인데 프로젝트에 팩 토큰이 없습니다(설정).",
+        "SkillCDN이 이 주소를 콘솔에 제공하지 않습니다. 그곳에 아무것도 없거나, 비공개 팩인데 읽을 SkillCDN 토큰이 프로젝트에도 워크스페이스에도 없습니다. 소유자가 설정 페이지에서 SkillCDN의 승인 코드로 연결합니다.",
       token_invalid:
-        "프로젝트가 가진 팩 토큰이 SkillCDN에서 더 이상 통하지 않습니다. 만료되었거나 지워졌거나, 만든 사람이 저장소 권한을 잃었습니다. 소유자가 설정 페이지에서 새로 넣습니다.",
+        "이 팩을 읽는 SkillCDN 토큰이 SkillCDN에서 더 이상 통하지 않습니다. 만료되었거나 지워졌거나, 만든 사람이 저장소 권한을 잃었습니다. 소유자가 설정 페이지에서 새로 넣습니다.",
       unavailable:
         "SkillCDN에 연결할 수 없습니다. 스킬은 이전 상태 그대로입니다. 나중에 다시 보세요.",
     },
@@ -727,6 +786,7 @@ export const ko: Messages = {
   people: {
     title: "사람들",
     list: "사람들",
+    narrowed: "같은 프로젝트에 속한 사람들과 관리자입니다.",
     roleOf: (name) => `${name}의 역할`,
     letIn: "사람 추가",
     letInAria: "사람 추가",

package/src/index.ts

@@ -82,6 +82,12 @@ export {
   goalMonth,
 } from "./components/goals.js";
 export { Markdown, type MarkdownProps } from "./components/markdown.js";
+export {
+  PackConnect,
+  type PackConnectProps,
+  type PackConnectState,
+} from "./components/pack-connect.js";
+export { PackTokenWays, type PackTokenWaysProps } from "./components/pack-token.js";
 export {
   PAGE_SIZE,
   Pager,
@@ -200,6 +206,16 @@ export {
   Time,
 } from "./components/ui.js";
 export { WorkList, type WorkListProps } from "./components/work.js";
+export {
+  DEFAULT_PEOPLE_VISIBILITY,
+  peopleVisibilityOf,
+  timeZoneOf,
+  WorkspaceSettingsForm,
+  type WorkspaceSettingsFormProps,
+  WorkspaceSettingsView,
+  type WorkspaceSettingsViewProps,
+  weekStartOf,
+} from "./components/workspace.js";
 export { ConnectPage, type ConnectPageProps } from "./connect-page.js";
 export {
   type ConsoleApp,

package/src/router.ts

@@ -83,8 +83,11 @@ export type Route =
       readonly project: string;
       readonly form: "edit" | "rules" | "pack-token" | undefined;
     }
-  /** The workspace's settings: its rules, its categories, its skills; or the form the rules are written on. */
-  | { readonly name: "workspace-settings"; readonly form: "rules" | undefined }
+  /** The workspace's settings: its own, its rules, its categories, its skills; or the form the rules, or the settings (ADR-0035), are written on. */
+  | {
+      readonly name: "workspace-settings";
+      readonly form: "rules" | "workspace" | "pack-token" | undefined;
+    }
   | { readonly name: "people" }
   /** The form where an administrator lets someone in by login (ADR-0022). */
   | { readonly name: "new-listing" }
@@ -252,7 +255,16 @@ export function matchRoute(pathname: string, search = ""): Route {
     return { name: "categories" };
   }
   if (path === PATHS.settings) {
-    return { name: "workspace-settings", form: params.has("rules") ? "rules" : undefined };
+    return {
+      name: "workspace-settings",
+      form: params.has("workspace")
+        ? "workspace"
+        : params.has("rules")
+          ? "rules"
+          : params.has("pack-token")
+            ? "pack-token"
+            : undefined,
+    };
   }
   if (path === PATHS.connect) {
     return { name: "connect", code: undefined };
@@ -423,8 +435,8 @@ export function projectSettingsHref(key: string, form?: "edit" | "rules" | "pack
   return form === undefined ? base : `${base}?${form}`;
 }
 
-/** Where the workspace's settings are, or the form its rules are written on. */
-export function settingsHref(form?: "rules"): string {
+/** Where the workspace's settings are, or the form its rules, or its own settings, are written on. */
+export function settingsHref(form?: "rules" | "workspace" | "pack-token"): string {
   return form === undefined ? PATHS.settings : `${PATHS.settings}?${form}`;
 }
 

package/src/routes.ts

@@ -9,6 +9,10 @@ export const REST_ROUTES = {
   me: "/api/v1/me",
   /** The token a request is made with, for it to give itself up. */
   meToken: "/api/v1/me/token",
+  /** The workspace's settings (ADR-0035), changed by an administrator; read through `me`. */
+  workspace: "/api/v1/workspace",
+  /** The SkillCDN token the organization's pack is read with (ADR-0036), an administrator's; `/connect` under it connects one with a code. */
+  workspacePackToken: "/api/v1/workspace/pack-token",
   /** The people of the workspace: everyone who has signed in, and the logins let in that have not. */
   people: "/api/v1/people",
   /** The logins an administrator let in (ADR-0022), made and removed by one. */

package/src/schemas.ts

@@ -50,6 +50,8 @@ import {
   GOAL_STATES,
   LINK_SOURCES,
   MEMBERSHIP_SOURCES,
+  PACK_CONNECT_ENDINGS,
+  PEOPLE_VISIBILITIES,
   PERSON_ROLES,
   PERSON_STATUSES,
   PROJECT_ICON_TYPES,
@@ -63,6 +65,7 @@ import {
   SKILLS_STATUSES,
   TASK_PRIORITIES,
   TASK_STATES,
+  WEEK_STARTS,
 } from "./vocabulary.js";
 
 /** A line of text a person wrote: trimmed, bounded, and free of characters that hide. */
@@ -166,6 +169,18 @@ export const restProviderSchema = z.object({
 });
 export type RestProvider = z.infer<typeof restProviderSchema>;
 
+/**
+ * A time zone's name as the IANA database spells one (`Asia/Seoul`, `UTC`): its shape here; the
+ * server knows which names are zones.
+ */
+export const timeZoneName = z
+  .string()
+  .check(
+    z.minLength(1),
+    z.maxLength(64),
+    z.regex(/^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$/, "must be a time zone name"),
+  );
+
 /** A language tag as a browser sends one (`en`, `ko-KR`): what the pages speak, by the person's choice. */
 const languageTag = z
   .string()
@@ -178,22 +193,67 @@ const languageTag = z
 export const restMePatchSchema = z.object({ language: z.nullable(languageTag) });
 export type RestMePatch = z.infer<typeof restMePatchSchema>;
 
+/**
+ * The workspace as `GET /api/v1/me` describes it, and as `PATCH /api/v1/workspace` answers: what
+ * the board is called, what the deployment's configuration says of it, and the settings an
+ * administrator keeps on the Settings page (ADR-0035).
+ */
+export const restWorkspaceSchema = z.object({
+  name: z.string(),
+  /** The most days a token may be good for here, or `null` when a person chooses. */
+  tokenDaysAtMost: z.nullable(z.int().check(z.positive())),
+  /**
+   * The organization's skills: the origin of the SkillCDN deployment they are read through,
+   * and the address a project without one of its own reads, canonical, or `null` for none.
+   */
+  skills: z.object({
+    source: z.string(),
+    address: z.nullable(z.string()),
+    /**
+     * The SkillCDN token the organization's pack is read with, by a project that names no
+     * address and holds no token of its own (ADR-0036): when it was set, never the token; `null`
+     * for none. Optional, so that a console older than it still answers.
+     */
+    packToken: z.optional(z.nullable(z.object({ setAt: instant }))),
+  }),
+  /**
+   * Who sees whom on the People page (ADR-0035): everyone, or the people one shares a project
+   * with. Read as optional, so that a console older than this setting still answers; `everyone`
+   * then, which is what it does.
+   */
+  peopleVisibility: z.optional(z.enum(PEOPLE_VISIBILITIES)),
+  /** The day the calendars begin a week on: the language's, Monday or Sunday. Optional as above; `auto` then. */
+  weekStart: z.optional(z.enum(WEEK_STARTS)),
+  /**
+   * The workspace's time zone, an IANA name, in which the command prints moments; `null` for
+   * none, when they stay as the API gives them, in UTC. Optional as above; none then.
+   */
+  timeZone: z.optional(z.nullable(timeZoneName)),
+});
+export type RestWorkspace = z.infer<typeof restWorkspaceSchema>;
+
+/** What `PATCH /api/v1/workspace` is sent, by an administrator: the settings to change, at least one. */
+export const restWorkspacePatchSchema = z
+  .object({
+    peopleVisibility: z.optional(z.enum(PEOPLE_VISIBILITIES)),
+    weekStart: z.optional(z.enum(WEEK_STARTS)),
+    /** A zone's name, or `null` for none. */
+    timeZone: z.optional(z.nullable(timeZoneName)),
+  })
+  .check(
+    z.refine((patch) => Object.values(patch).some((value) => value !== undefined), {
+      message: "names nothing to change",
+    }),
+  );
+export type RestWorkspacePatch = z.infer<typeof restWorkspacePatchSchema>;
+
 /**
  * `GET /api/v1/me`: the workspace, who the session cookie says is signed in (or `null`), the
  * language they chose (or `null`), and the identity providers people sign in through, none
  * where nobody can.
  */
 export const restMeSchema = z.object({
-  workspace: z.object({
-    name: z.string(),
-    /** The most days a token may be good for here, or `null` when a person chooses. */
-    tokenDaysAtMost: z.nullable(z.int().check(z.positive())),
-    /**
-     * The organization's skills: the origin of the SkillCDN deployment they are read through,
-     * and the address a project without one of its own reads, canonical, or `null` for none.
-     */
-    skills: z.object({ source: z.string(), address: z.nullable(z.string()) }),
-  }),
+  workspace: restWorkspaceSchema,
   person: z.nullable(restPersonSchema),
   /**
    * What the token asking is called by its person, when a token asks: how a console of a
@@ -329,15 +389,25 @@ export const restProjectPatchSchema = z.object({
 });
 export type RestProjectPatch = z.infer<typeof restProjectPatchSchema>;
 
-/** A person listed in a project, with what they are in it. */
+/**
+ * A member of a project, with what they are in it: a person listed in it, or, in a project open
+ * to the workspace, anyone of the workspace, who is a member of it without a listing (ADR-0035).
+ */
 export const restMemberSchema = z.object({
   person: restPersonSchema,
+  /** What they are in it: an owner as listed or as an administrator, else a member. */
   role: z.enum(PROJECT_ROLES),
+  /** Since when: the listing's day, or, for a member without one, the later of the project's making and their joining. */
   addedAt: instant,
+  /**
+   * Whether a listing holds them in the project. Read as optional, so that a console older than
+   * this field still answers; everyone it lists is listed.
+   */
+  listed: z.optional(z.boolean()),
 });
 export type RestMember = z.infer<typeof restMemberSchema>;
 
-/** `GET /api/v1/projects/<key>/members`: those listed, by login. */
+/** `GET /api/v1/projects/<key>/members`: the members, by login; everyone of the workspace in a project open to it. */
 export const restMembersSchema = z.object({ items: z.array(restMemberSchema) });
 export type RestMembers = z.infer<typeof restMembersSchema>;
 
@@ -991,6 +1061,53 @@ export const restPackTokenInputSchema = z.object({
 });
 export type RestPackTokenInput = z.infer<typeof restPackTokenInputSchema>;
 
+/**
+ * `POST .../pack-token/connect` (ADR-0036): what the person is shown, as the deployment said it,
+ * the code and the page to approve it on, until when, and how often the console asks again. The
+ * secret the console claims the token with stays with the console.
+ */
+export const restPackConnectStartedSchema = z.object({
+  code: z.string(),
+  url: z.string(),
+  expiresAt: instant,
+  intervalSeconds: z.int().check(z.positive()),
+});
+export type RestPackConnectStarted = z.infer<typeof restPackConnectStartedSchema>;
+
+/**
+ * `GET .../pack-token/connect`: how the connection stands. Nothing asked; waiting for the
+ * person, with what they were shown; connected, the token kept and the project as it stands; or
+ * ended short of a token, and why.
+ */
+const packConnectNone = z.object({ status: z.literal("none") });
+const packConnectPending = z.object({
+  status: z.literal("pending"),
+  code: z.string(),
+  url: z.string(),
+  expiresAt: instant,
+  intervalSeconds: z.int().check(z.positive()),
+});
+const packConnectEnded = z.object({
+  status: z.literal("ended"),
+  reason: z.enum(PACK_CONNECT_ENDINGS),
+});
+export const restPackConnectSchema = z.union([
+  packConnectNone,
+  packConnectPending,
+  z.object({ status: z.literal("connected"), project: restProjectSchema }),
+  packConnectEnded,
+]);
+export type RestPackConnect = z.infer<typeof restPackConnectSchema>;
+
+/** `GET /api/v1/workspace/pack-token/connect`: the same, for the workspace's token, with the workspace as it stands once connected. */
+export const restWorkspacePackConnectSchema = z.union([
+  packConnectNone,
+  packConnectPending,
+  z.object({ status: z.literal("connected"), workspace: restWorkspaceSchema }),
+  packConnectEnded,
+]);
+export type RestWorkspacePackConnect = z.infer<typeof restWorkspacePackConnectSchema>;
+
 /** `GET .../skills/one?path=&cursor=`: a page of a skill's context, as the pack answers `load_skill` (`RestSkill` of `@skillcdn/core`); `read` is `null` unless `ready`. */
 export const restSkillLoadSchema = z.object({
   ...packEnvelope,

package/src/styles/console.css

@@ -1177,6 +1177,7 @@ table {
   display: grid;
   grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr));
   gap: var(--sc-space-4);
+  align-items: start;
 }
 
 .sc-input {
@@ -4130,3 +4131,158 @@ table {
 .sc-goal-view-list {
   display: block;
 }
+
+/* The workspace's settings (ADR-0035): each setting a row, its name beside its value; on the form,
+   its name and its hint beside a control of a bounded width, so that a short choice is not a
+   field as wide as the page. */
+.sc-settings-list {
+  display: grid;
+  margin: 0;
+  font-size: var(--sc-text-sm);
+}
+
+.sc-settings-item {
+  display: grid;
+  grid-template-columns: minmax(8rem, 14rem) minmax(0, 1fr);
+  gap: var(--sc-space-1) var(--sc-space-5);
+  padding: var(--sc-space-3) 0;
+  border-top: var(--sc-border);
+}
+
+.sc-settings-item:first-child {
+  padding-top: 0;
+  border-top: 0;
+}
+
+.sc-settings-item:last-child {
+  padding-bottom: 0;
+}
+
+.sc-settings-item dt {
+  color: var(--sc-color-text-muted);
+}
+
+.sc-settings-item dd {
+  margin: 0;
+}
+
+.sc-settings-note {
+  margin-left: var(--sc-space-3);
+  color: var(--sc-color-text-muted);
+}
+
+.sc-settings-form {
+  gap: 0;
+}
+
+.sc-settings-row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(14rem, 20rem);
+  gap: var(--sc-space-3) var(--sc-space-6);
+  align-items: start;
+  padding: var(--sc-space-4) 0;
+  border-top: var(--sc-border);
+}
+
+.sc-settings-row:first-child {
+  padding-top: 0;
+  border-top: 0;
+}
+
+.sc-settings-label {
+  display: block;
+  font-weight: var(--sc-weight-medium);
+}
+
+.sc-settings-hint {
+  max-width: var(--sc-width-prose);
+  margin: var(--sc-space-1) 0 0;
+  color: var(--sc-color-text-muted);
+  font-size: var(--sc-text-sm);
+}
+
+.sc-settings-control {
+  display: grid;
+  justify-items: start;
+  gap: var(--sc-space-2);
+}
+
+.sc-settings-control .sc-input {
+  width: 100%;
+}
+
+.sc-settings-form .sc-form-actions {
+  padding-top: var(--sc-space-4);
+  border-top: var(--sc-border);
+}
+
+@media (max-width: 40rem) {
+  .sc-settings-item,
+  .sc-settings-row {
+    grid-template-columns: minmax(0, 1fr);
+  }
+}
+
+/* The pack token (ADR-0028, ADR-0036): what it is for first, then the two ways to one side by
+   side, each a card with its words before its controls, and the code shown large while the
+   page waits for the approval. */
+.sc-pack-intro {
+  max-width: var(--sc-width-prose);
+  margin: 0 0 var(--sc-space-5);
+  color: var(--sc-color-text-muted);
+  font-size: var(--sc-text-sm);
+}
+
+.sc-pack-ways {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(18rem, 1fr));
+  gap: var(--sc-space-4);
+}
+
+.sc-pack-way {
+  display: grid;
+  align-content: start;
+  gap: var(--sc-space-3);
+  padding: var(--sc-space-4);
+  border: var(--sc-border);
+  border-radius: var(--sc-radius-lg);
+  background: var(--sc-color-sheet);
+}
+
+.sc-pack-way-title {
+  font-size: var(--sc-text-md);
+  font-weight: var(--sc-weight-medium);
+}
+
+.sc-pack-way .sc-field-hint {
+  margin-top: 0;
+}
+
+.sc-pack-connect {
+  display: grid;
+  gap: var(--sc-space-3);
+}
+
+.sc-pack-connect-code {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: var(--sc-space-3);
+}
+
+.sc-pack-code {
+  font-size: var(--sc-text-xl);
+  letter-spacing: 0.12em;
+}
+
+.sc-pack-connect-waiting {
+  display: flex;
+  align-items: center;
+  gap: var(--sc-space-2);
+  color: var(--sc-color-text-muted);
+  font-size: var(--sc-text-sm);
+}
+
+.sc-pack-actions {
+  margin-top: var(--sc-space-5);
+}

package/src/vocabulary.ts

@@ -97,6 +97,30 @@ export const PROJECT_VISIBILITIES = ["workspace", "private"] as const;
 
 export type ProjectVisibility = (typeof PROJECT_VISIBILITIES)[number];
 
+/**
+ * Who sees whom on the People page and in the pickers (ADR-0035): everyone of the workspace,
+ * or only the people one shares a project with; an administrator always sees everyone.
+ */
+export const PEOPLE_VISIBILITIES = ["everyone", "shared_projects"] as const;
+
+export type PeopleVisibility = (typeof PEOPLE_VISIBILITIES)[number];
+
+/**
+ * The day the calendars begin a week on (ADR-0035): as the language of the pages has it, or
+ * Monday, or Sunday, for the whole workspace.
+ */
+export const WEEK_STARTS = ["auto", "monday", "sunday"] as const;
+
+export type WeekStart = (typeof WEEK_STARTS)[number];
+
+/**
+ * How a private pack's connection ended short of a token (ADR-0036): the code expired before
+ * anyone approved, the person declined at the deployment, or the deployment refused the request.
+ */
+export const PACK_CONNECT_ENDINGS = ["expired", "declined", "refused"] as const;
+
+export type PackConnectEnding = (typeof PACK_CONNECT_ENDINGS)[number];
+
 /** What a run is doing: at work, waiting for a person's decision, or over in one of three ways. */
 export const RUN_STATUSES = ["running", "waiting", "finished", "failed", "abandoned"] as const;
 
@@ -153,6 +177,7 @@ export const EVENT_KINDS = [
   "person.unlisted",
   "person.deactivated",
   "person.reactivated",
+  "workspace.updated",
   "category.created",
   "category.updated",
   "category.removed",