diff --git a/src/lib/components/QuickNote.svelte b/src/lib/components/QuickNote.svelte
new file mode 100644
index 0000000..3dd7c12
--- /dev/null
+++ b/src/lib/components/QuickNote.svelte
@@ -0,0 +1,218 @@
+
+
+
+
+{#if quickNote.open}
+
+
+ Quick note
+ {sceneId ? 'on this scene' : 'on this story'}
+
+
+ {#if message}
+ {message}
+ {/if}
+
+
+{:else if savedHref}
+
+{/if}
+
+
diff --git a/src/lib/components/ReviewWorkspace.svelte b/src/lib/components/ReviewWorkspace.svelte
index c0b23e8..03bd03b 100644
--- a/src/lib/components/ReviewWorkspace.svelte
+++ b/src/lib/components/ReviewWorkspace.svelte
@@ -79,7 +79,7 @@
book?: { title: string; subtitle: string | null } | null;
canSuggest?: boolean;
// The mode switcher links, shown on the author side only.
- seg?: { writeHref: string; planHref: string; notesHref: string } | null;
+ seg?: { writeHref: string; planHref: string } | null;
// Entity mention data for the centre's highlights and quick cards.
entities?: MentionEntity[];
mentionMembers?: string[];
@@ -431,8 +431,8 @@
diff --git a/src/lib/docs/account.md b/src/lib/docs/account.md
index a242a55..d9f6416 100644
--- a/src/lib/docs/account.md
+++ b/src/lib/docs/account.md
@@ -1,8 +1,9 @@
# Your account
Open your account page from the avatar menu at the top right of any page. It has four
-sections: Profile, Security, Assistant, and Display. Changes save when you
-select the save button in each block.
+sections: Profile, Security, Assistant, and Display. Changes save on their own:
+a choice saves as soon as you make it, and a text field saves when you leave it.
+A "Saved." note confirms each save.
## Profile
@@ -11,11 +12,21 @@ public pages. The public-page block is where you claim a handle: a short name
that becomes your public address at `/@yourhandle`. You can claim a handle once,
so pick it with care. Add a short bio and, if you take requests, a note that
your commissions are open with the details. Turn on the public profile toggle to
-show this page to visitors; leave it off to keep it hidden.
+show this page to visitors; leave it off to keep it hidden. Either way, "Open
+your page" next to the page address shows you the page as visitors would see
+it; while it is hidden, a note on top says only you can see it.
You can upload an avatar when image storage is set up on the instance. Without
it, your initials stand in.
+## Invites
+
+When an admin has given your account invites, an Invites section appears in
+the sidebar. Select "Generate an invite" to make a code, then "Copy link" to
+get a sign-up link to send your friend. Each code admits one person, who can
+sign in as soon as their email is confirmed. Revoke a code that has not been
+used to take it back; that frees the invite so you can generate another.
+
The public page and avatar only appear to visitors once an admin has enabled
publishing for your account and your profile is set to public.
@@ -53,7 +64,7 @@ contacts a model on its own.
`http://localhost:11434/v1`). Local endpoints usually need no key, and your
text never leaves your machine.
- **Models per role**: pick which model handles each kind of help. Select Discover
- models to fill the lists from your endpoint, choose one per role, then save. Roles
+ models to fill the lists from your endpoint, then choose one per role. Roles
with no model chosen fall back to the endpoint's default. A single story can
override these too. When the list is long, type part of a name in the filter box
to narrow it; models you already picked always stay listed. If your endpoint
diff --git a/src/lib/docs/getting-started.md b/src/lib/docs/getting-started.md
index 49e6c9f..23b88a8 100644
--- a/src/lib/docs/getting-started.md
+++ b/src/lib/docs/getting-started.md
@@ -26,9 +26,9 @@ Right-click a scene in a story's sidebar to delete it; it sits in the story's "D
Everything you write can leave as markdown: each story's settings offer a zip of its scenes, a universe's settings bundle the whole world, and your account page has a download of everything you own.
-A story export zip can also come back in. Open the universe's settings, go to "Import and export", and upload the zip under "Import a story". You get a preview first: how many chapters, scenes, and words are coming, and how each story note will be handled. A note whose character, place, or lore entry already exists in the universe (matched by name) attaches to it; a name with no match creates a new entry; a name shared by more than one entry is skipped, and the preview says so. Nothing is written until you press "Import story", and the import always creates a new story, even if one with the same title exists.
+A story export zip can also come back in. Choose "Import a story" from a New menu on the library, or from the universe's settings under "Import and export". A dialog opens: pick the zip or drag it in, and a preview appears at once - how many chapters, scenes, and words are coming, and how each story note will be handled. A note whose character, place, or lore entry already exists in the universe (matched by name) attaches to it; a name with no match creates a new entry; a name shared by more than one entry is skipped, and the preview says so. Nothing is written until you press "Import story", and the import always creates a new story, even if one with the same title exists.
-You can bring in a manuscript written elsewhere the same way. Upload a Word document (.docx) or an EPUB (.epub) in that same "Import a story" box, or choose "Import a story from a file..." from a New menu on the library, which opens that same box. Codex reads the chapters and scenes from the way the document marks them: chapter headings, "Chapter 1" lines, and scene breaks such as a centered row of asterisks. When a document has no such markers, the whole text comes in as a single scene that you can split up afterward. Pictures embedded in the document come along when image storage is set up; the preview tells you if any will be left out. As with a zip, you check the preview before anything is written.
+You can bring in a manuscript written elsewhere the same way. Pick a Word document (.docx) or an EPUB (.epub) in that same "Import a story" dialog. Codex reads the chapters and scenes from the way the document marks them: chapter headings, "Chapter 1" lines, and scene breaks such as a centered row of asterisks. When a document has no such markers, the whole text comes in as a single scene that you can split up afterward. Pictures embedded in the document come along when image storage is set up; the preview tells you if any will be left out. As with a zip, you check the preview before anything is written.
## Jumping around
diff --git a/src/lib/docs/planning.md b/src/lib/docs/planning.md
index 8a45427..efc18f1 100644
--- a/src/lib/docs/planning.md
+++ b/src/lib/docs/planning.md
@@ -72,7 +72,7 @@ The relationship web draws every recorded relationship as a map: entities are do
## Notes
-The Notes view holds freeform writing notes: ideas, threads to pull, anything that does not belong to one character or place. Open it from the Notes button at the top of the sidebar, in a story or a universe.
+The Notes view holds freeform writing notes: ideas, threads to pull, anything that does not belong to one character or place. Open it from the Notes panel on the right of the Write and Plan views: select a note there, or "All notes", to land on the full Notes page. The command palette also jumps there with "Story notes" and "Universe notes".
A note in a story belongs to that story. A note in a universe belongs to the whole universe and shows in every story under it, under "From the universe" in the story's note list; open one there to jump to it and edit it in the universe view. Select "New note" to make one, give it a title, and write in the body. Notes save on their own as you type.
@@ -80,7 +80,9 @@ Pin the notes you reach for often with the Pin button above a note; pinned notes
If you run a campaign, a note per sitting works well: keep the running log in a story note, and world facts the players have learned in a universe note. The right pane of the Notes view keeps past versions of the open note, the same way it does for scenes and entries; a note mentions nothing and has no comments, so History is the only panel there.
-A note can also be attached to one scene. In the editor, open the Notes panel on the right and select "New note on this scene": the note is made, attached, and opened in the Notes view for you to write. From then on it shows in that scene's Notes panel whenever the scene is open, and in the story's note list like any other note.
+A note can also be attached to one scene. In the editor, open the Notes panel on the right and select "New note on this scene": the note is made, attached, and opened in the Notes view for you to write. From then on it shows at the top of the Notes panel whenever the scene is open, and in the story's note list like any other note.
+
+To jot something down without leaving the editor, press Ctrl+Alt+N (Cmd+Alt+N on a Mac) or run "Quick note" from the command palette. A small card opens over the editor: write the thought, then Ctrl+Enter or "Save note" files it with the story's notes - attached to the open scene when there is one - and puts you back where you were. The first line becomes the note's title.
## History
diff --git a/src/lib/docs/publishing.md b/src/lib/docs/publishing.md
index 5d20b2a..1445224 100644
--- a/src/lib/docs/publishing.md
+++ b/src/lib/docs/publishing.md
@@ -46,7 +46,7 @@ A story you set to public gets its own reading page under your handle. It opens
The reading pages are the outward face of your work, so they are plain and quiet: one column of prose, chapter headings, and nothing between the reader and the words. A cover is the story's own title set in the reading typeface.
-Both pages name you the way you asked to be named: your pen name if you set one on your account page, otherwise your display name. Your handle stays the address in the link.
+Both pages name you the way you asked to be named: your pen name if you set one on your account page, otherwise your display name. The first time you claim a handle or publish with no pen name set, a dialog asks which name should go on the page, offering your display name to keep; what you choose becomes your pen name, and you can change it on your account page. Your handle stays the address in the link.
A reader gets two controls in the bar: the theme, which starts in whichever of light or dark their device asks for and remembers a change they make, and the question mark, which opens these pages. At the end of both pages a footer says the work was written in Codex, who published it, and offers a link for a reader who wants to write something of their own.
diff --git a/src/lib/docs/shortcuts.md b/src/lib/docs/shortcuts.md
index 03a4091..5d85aa3 100644
--- a/src/lib/docs/shortcuts.md
+++ b/src/lib/docs/shortcuts.md
@@ -6,6 +6,8 @@ Codex keeps to a small set of shortcuts. On a Mac, use Cmd where Ctrl is shown.
- **Ctrl+K**: open the command palette to jump to any universe, story, scene, or
entity, or run a command (new scene, switch view, focus mode, and more).
+- **Ctrl+Alt+N**: on a story's Write page, open the quick-note card to jot a
+ note without leaving the editor. Ctrl+Enter saves it, Esc closes it.
## In the editor
diff --git a/src/lib/quick-note.svelte.ts b/src/lib/quick-note.svelte.ts
new file mode 100644
index 0000000..8ee072b
--- /dev/null
+++ b/src/lib/quick-note.svelte.ts
@@ -0,0 +1,13 @@
+// Cross-surface state for the quick-note jot: the keyboard shortcut and the
+// command palette both ask for it, and the page that holds the story context
+// renders QuickNote. Lives here, like review-modal.svelte.ts, so surfaces
+// outside the page tree can open it too.
+export const quickNote = $state<{ open: boolean }>({ open: false });
+
+export function openQuickNote(): void {
+ quickNote.open = true;
+}
+
+export function closeQuickNote(): void {
+ quickNote.open = false;
+}
diff --git a/src/lib/server/account.ts b/src/lib/server/account.ts
index 2f4d806..b251ca7 100644
--- a/src/lib/server/account.ts
+++ b/src/lib/server/account.ts
@@ -48,6 +48,23 @@ export async function saveIdentity(
return { ok: true };
}
+// The publish-time pen-name choice: records the name the author picked when
+// first going public (which may simply be their display name, making the
+// fallback a decision rather than an accident), but never overwrites a pen
+// name already set.
+export async function setPenNameIfUnset(
+ db: Database,
+ userId: string,
+ rawPenName: string
+): Promise
{
+ const pen = rawPenName.trim().slice(0, MAX_PEN_NAME);
+ if (!pen) return;
+ await db
+ .update(users)
+ .set({ penName: pen })
+ .where(and(eq(users.id, userId), isNull(users.penName)));
+}
+
export type ProfileLink = { label: string; url: string };
const MAX_LINKS = 8;
diff --git a/src/lib/server/admin.ts b/src/lib/server/admin.ts
index e41840f..350cd5e 100644
--- a/src/lib/server/admin.ts
+++ b/src/lib/server/admin.ts
@@ -112,6 +112,7 @@ export type AdminUser = {
suspendedAt: Date | null;
deletionScheduledAt: Date | null;
publicArchiveEnabled: boolean;
+ inviteAllowance: number;
handle: string | null;
twoFactorEnabled: boolean;
createdAt: Date;
@@ -130,6 +131,7 @@ export async function listAllUsers(db: Database): Promise {
suspendedAt: users.suspendedAt,
deletionScheduledAt: users.deletionScheduledAt,
publicArchiveEnabled: users.publicArchiveEnabled,
+ inviteAllowance: users.inviteAllowance,
handle: users.handle,
twoFactorEnabled: sql`${userTotp.confirmedAt} is not null`,
createdAt: users.createdAt
diff --git a/src/lib/server/db/schema.ts b/src/lib/server/db/schema.ts
index 947af8d..2c01d58 100644
--- a/src/lib/server/db/schema.ts
+++ b/src/lib/server/db/schema.ts
@@ -56,6 +56,9 @@ export const users = pgTable('users', {
profilePublic: boolean('profile_public').notNull().default(false),
// Admin grants this before a user may publish public pages.
publicArchiveEnabled: boolean('public_archive_enabled').notNull().default(false),
+ // How many invite codes the user may generate for friends; each code
+ // admits one person. Counted against the codes they have created.
+ inviteAllowance: integer('invite_allowance').notNull().default(0),
passwordHash: text('password_hash').notNull(),
role: text('role', { enum: ['admin', 'user'] }).notNull(),
// The Assistant's BYO endpoint, key (encrypted at rest), and per-role
diff --git a/src/lib/server/invites.ts b/src/lib/server/invites.ts
index cdc6926..3e4b846 100644
--- a/src/lib/server/invites.ts
+++ b/src/lib/server/invites.ts
@@ -1,7 +1,7 @@
import { randomInt } from 'node:crypto';
-import { and, desc, eq, gt, isNull, lt, or, sql } from 'drizzle-orm';
+import { and, count, desc, eq, gt, isNull, lt, or, sql } from 'drizzle-orm';
import type { Database } from './auth.ts';
-import { inviteCodes } from './db/schema.ts';
+import { inviteCodes, users } from './db/schema.ts';
import { isUniqueViolation } from './db-errors.ts';
// Invite codes skip the admin approval queue at sign-up. The admin mints a
@@ -30,7 +30,7 @@ export function normalizeInviteCode(input: string): string {
export type InviteCode = typeof inviteCodes.$inferSelect;
export async function createInviteCode(
- db: Database,
+ db: DbLike,
input: { createdBy: string; label?: string; maxUses?: number; expiresAt?: Date | null }
): Promise {
const label = input.label?.trim() || null;
@@ -68,6 +68,73 @@ export async function deleteInviteCode(db: Database, id: string): Promise {
+ return await db
+ .select()
+ .from(inviteCodes)
+ .where(eq(inviteCodes.createdBy, userId))
+ .orderBy(desc(inviteCodes.createdAt));
+}
+
+/**
+ * Generates one single-use code against the user's allowance, or returns null
+ * when none is left. The user row is locked so two racing requests cannot
+ * both take the last slot.
+ */
+export async function createUserInvite(db: Database, userId: string): Promise {
+ return db.transaction(async (tx) => {
+ const [user] = await tx
+ .select({ allowance: users.inviteAllowance })
+ .from(users)
+ .where(eq(users.id, userId))
+ .for('update');
+ if (!user) return null;
+ const [existing] = await tx
+ .select({ n: count() })
+ .from(inviteCodes)
+ .where(eq(inviteCodes.createdBy, userId));
+ if (existing.n >= user.allowance) return null;
+ return createInviteCode(tx, { createdBy: userId });
+ });
+}
+
+/** Revokes one of the user's own codes, but never one already used. */
+export async function deleteUserInviteCode(
+ db: Database,
+ userId: string,
+ inviteId: string
+): Promise {
+ const [row] = await db
+ .delete(inviteCodes)
+ .where(
+ and(
+ eq(inviteCodes.id, inviteId),
+ eq(inviteCodes.createdBy, userId),
+ eq(inviteCodes.usedCount, 0)
+ )
+ )
+ .returning({ id: inviteCodes.id });
+ return Boolean(row);
+}
+
+export async function setInviteAllowance(
+ db: Database,
+ userId: string,
+ allowance: number
+): Promise {
+ const value = Math.max(0, Math.floor(allowance));
+ const [row] = await db
+ .update(users)
+ .set({ inviteAllowance: value })
+ .where(eq(users.id, userId))
+ .returning({ id: users.id });
+ return Boolean(row);
+}
+
// Spends one use of a code, returning whether it was valid. The guard and the
// increment are one statement, so two sign-ups racing for the last use cannot
// both win.
diff --git a/src/lib/server/publish.ts b/src/lib/server/publish.ts
index 48ee552..f1ea835 100644
--- a/src/lib/server/publish.ts
+++ b/src/lib/server/publish.ts
@@ -165,6 +165,26 @@ export async function publicProfile(db: Database, handle: string) {
return row ?? null;
}
+// The owner's own view of their shelf header, listed or not, so they can
+// preview the page before turning visibility on. Carries profilePublic so the
+// caller can say when only the owner sees it.
+export async function ownProfilePreview(db: Database, userId: string, handle: string) {
+ const [row] = await db
+ .select({
+ displayName: users.displayName,
+ penName: users.penName,
+ bioMd: users.bioMd,
+ links: users.links,
+ commissionsOpen: users.commissionsOpen,
+ commissionsMd: users.commissionsMd,
+ avatarAssetId: users.avatarAssetId,
+ profilePublic: users.profilePublic
+ })
+ .from(users)
+ .where(and(eq(users.id, userId), eq(users.handle, handle)));
+ return row ?? null;
+}
+
// The author's name for the reader chrome. The crumb and the footer name the
// author on both reading pages whether or not they list their profile; the bio,
// links, avatar and commissions stay behind profilePublic in publicProfile.
diff --git a/src/lib/styles/pages.css b/src/lib/styles/pages.css
index 28b9ad2..041dc55 100644
--- a/src/lib/styles/pages.css
+++ b/src/lib/styles/pages.css
@@ -434,6 +434,13 @@
.story-card-meta-sep {
opacity: 0.6;
}
+/* The card leads with a cover: the uploaded artwork, or the title set on the
+ cover blank (the reader shelf's pattern, reused). Sized down a step from
+ the reader shelf, since the real title sits right below. */
+.story-card-cover {
+ flex: none;
+ font-size: 15px;
+}
.universe-section {
margin-top: var(--space-10);
diff --git a/src/lib/styles/surfaces.css b/src/lib/styles/surfaces.css
index ef09ad5..22e16f4 100644
--- a/src/lib/styles/surfaces.css
+++ b/src/lib/styles/surfaces.css
@@ -342,6 +342,19 @@
}
/* the shelf: /@handle */
+/* The owner's private-preview note, above the header they alone can see. */
+.preview-note {
+ margin: 0 0 var(--space-5);
+ padding: 10px 14px;
+ border: 1px solid color-mix(in oklab, var(--accent) 38%, transparent);
+ border-radius: var(--radius-md);
+ background: color-mix(in oklab, var(--accent) 9%, var(--bg-card));
+ font-size: var(--text-sm);
+ color: var(--text-muted);
+}
+.preview-note a {
+ color: var(--accent);
+}
.shelf-head {
display: flex;
align-items: flex-start;
diff --git a/src/routes/+page.server.ts b/src/routes/+page.server.ts
index 0ef14ef..5d529d7 100644
--- a/src/routes/+page.server.ts
+++ b/src/routes/+page.server.ts
@@ -44,7 +44,7 @@ export const load: PageServerLoad = async ({ locals }) => {
// was last touched.
const result = await db.execute(sql`
select st.id, st.slug, st.title, st.brief, st.universe_id,
- st.position_in_series, st.created_at,
+ st.cover_asset_id, st.position_in_series, st.created_at,
(select count(*)::int from chapters c where c.story_id = st.id) as chapters,
count(s.id)::int as scene_count,
coalesce(sum(s.word_count), 0)::int as words,
@@ -67,6 +67,7 @@ export const load: PageServerLoad = async ({ locals }) => {
title: string;
brief: string | null;
universe_id: string;
+ cover_asset_id: string | null;
chapters: number;
scene_count: number;
words: number;
@@ -83,6 +84,7 @@ export const load: PageServerLoad = async ({ locals }) => {
title: r.title,
brief: r.brief,
universeId: r.universe_id,
+ coverAssetId: r.cover_asset_id,
chapters: r.chapters,
words: r.words,
editedAt: editedAt.toISOString(),
diff --git a/src/routes/+page.svelte b/src/routes/+page.svelte
index 8d46c6b..2605b2e 100644
--- a/src/routes/+page.svelte
+++ b/src/routes/+page.svelte
@@ -1,6 +1,7 @@
+
+
+
Account
+
Invites
+
Invite codes you can share with friends so they can join this Codex.
+
+
+
Invite a friend
+
+ Generate a code and send your friend its sign-up link. Each code admits one person, who can
+ sign in as soon as their email is confirmed. You have {remaining}
+ {remaining === 1 ? 'invite' : 'invites'} left.
+
+
+
+
+
+ {#if data.myInvites.length > 0}
+
+
+ {#each data.myInvites as code (code.id)}
+
+
+
{code.code}
+
{codeStatus(code)}
+
+
copyLink(code)}>
+ {copiedId === code.id ? 'Copied' : 'Copy link'}
+
+ {#if code.usedCount === 0}
+
+ {/if}
+
+ {/each}
+
+
+ {/if}
+