fimo 0.11.1-staging.1 → 0.12.0-staging.2

package/assets/content-templates/hooks-template.eta

@@ -1,14 +1,14 @@
 // AUTO-GENERATED by `fimo` from src/schemas/<%= model.uid %>.json - DO NOT EDIT.
 // Change content fields in the schema, then run `fimo validate`.
-// Runtime implementation lives in the project-local fimo/ui package.
+// Runtime implementation lives in the project-local <%= runtimeImport %> package export.
 <% if (model.isSingleton) { -%>
-import { createSingletonClient } from "fimo/ui";
-import type { SingletonContentClient } from "fimo/ui";
-import type { ContentSchema } from "fimo/ui";
+import { createSingletonClient } from "<%= runtimeImport %>";
+import type { SingletonContentClient } from "<%= runtimeImport %>";
+import type { ContentSchema } from "<%= runtimeImport %>";
 <% } else { -%>
-import { createContentClient } from "fimo/ui";
-import type { CollectionContentClient } from "fimo/ui";
-import type { ContentSchema } from "fimo/ui";
+import { createContentClient } from "<%= runtimeImport %>";
+import type { CollectionContentClient } from "<%= runtimeImport %>";
+import type { ContentSchema } from "<%= runtimeImport %>";
 <% } -%>
 
 import schema from "./<%= model.uid %>.json";
@@ -29,7 +29,7 @@ import type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %
 
 export type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>FimoMeta, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query, <%= model.pascal %>References, <%= model.pascal %>Result, <%= model.pascal %>Sort, <%= model.pascal %>Where } from "./<%= model.pascal %>.types";
 <% if (!model.isSingleton) { -%>
-export type { CollectionPage, CollectionPageInfo, InfiniteListResult } from "fimo/ui";
+export type { CollectionPage, CollectionPageInfo, InfiniteListResult } from "<%= runtimeImport %>";
 export type InfiniteListQuery<
   TFields extends <%= model.pascal %>Fields | undefined = undefined,
   TPopulate extends <%= model.pascal %>Populate | undefined = undefined,

package/assets/content-templates/next-client-template.eta

@@ -0,0 +1,102 @@
+'use client';
+
+// AUTO-GENERATED by `fimo` from src/schemas/<%= model.uid %>.json - DO NOT EDIT.
+// Client Components import this module. Server Components import ./<%= model.pascal %> instead.
+<% if (model.isSingleton) { -%>
+import { createSingletonClient } from "<%= runtimeImport %>";
+import type { SingletonContentClient } from "<%= runtimeImport %>";
+import type { ContentSchema } from "<%= runtimeImport %>";
+<% } else { -%>
+import { createContentClient } from "<%= runtimeImport %>";
+import type { CollectionContentClient } from "<%= runtimeImport %>";
+import type { ContentSchema } from "<%= runtimeImport %>";
+<% } -%>
+
+import schema from "./<%= model.uid %>.json";
+import type { Serialized<%= model.pascal %> } from "./<%= model.pascal %>";
+<%
+if (model.referenceImports && model.referenceImports.length > 0) {
+  model.referenceImports.forEach((referenceImport) => {
+-%>
+import * as <%= referenceImport.pascal %> from "./<%= referenceImport.pascal %>.client";
+<%
+  });
+}
+if (model.isSingleton) {
+-%>
+import type { <%= model.pascal %>, <%= model.pascal %>Input } from "./<%= model.pascal %>.types";
+<% } else { -%>
+import type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query } from "./<%= model.pascal %>.types";
+<% } -%>
+
+export type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>FimoMeta, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query, <%= model.pascal %>References, <%= model.pascal %>Result, <%= model.pascal %>Sort, <%= model.pascal %>Where } from "./<%= model.pascal %>.types";
+export type { Serialized<%= model.pascal %> };
+<% if (!model.isSingleton) { -%>
+export type { CollectionPage, CollectionPageInfo, InfiniteListResult } from "<%= runtimeImport %>";
+export type InfiniteListQuery<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+> = Omit<<%= model.pascal %>Query<TFields, TPopulate>, "offset">;
+<% } -%>
+
+<% if (model.isSingleton) { -%>
+const client: SingletonContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createSingletonClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema: schema as unknown as ContentSchema,
+<% } else { -%>
+const client: CollectionContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createContentClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema: schema as unknown as ContentSchema,
+<% } -%>
+<% if (model.referenceImports && model.referenceImports.length > 0) { -%>
+  references: { <%= model.referenceImports.map((referenceImport) => referenceImport.pascal).join(", ") %> },
+<% } -%>
+});
+
+<% if (model.isSingleton) { -%>
+export const { get, update, useGet, useSuspenseGet, useUpdate, wrapWithSource, meta } = client;
+<% } else { -%>
+export const {
+  wrapWithSource,
+  meta,
+  getById,
+  getBySlug,
+  getByField,
+  list,
+  get,
+  create,
+  update,
+  remove,
+  useGetById,
+  useGetBySlug,
+  useGetByField,
+  useList,
+  useInfiniteList,
+  useGet,
+  useSuspenseGetById,
+  useSuspenseGet,
+  useSuspenseGetByField,
+  useSuspenseGetBySlug,
+  useCreate,
+  useUpdate,
+  useRemove,
+} = client;
+<% } -%>
+
+type <%= model.pascal %>Source = Pick<<%= model.pascal %>, "id" | "__fimo">;
+
+/** Restore source tracking after content crosses a serialized framework boundary. */
+export function hydrate<TValue extends <%= model.pascal %>Source | readonly <%= model.pascal %>Source[]>(
+  value: Serialized<%= model.pascal %><TValue>
+): TValue {
+  if (Array.isArray(value)) {
+    return value.map((entry) => wrapWithSource(entry)) as unknown as TValue;
+  }
+  return wrapWithSource(value as unknown as Record<string, unknown>) as unknown as TValue;
+}
+
+export default client;

package/assets/content-templates/next-server-template.eta

@@ -0,0 +1,75 @@
+// AUTO-GENERATED by `fimo` from src/schemas/<%= model.uid %>.json - DO NOT EDIT.
+// Server Components import this module. Client Components import ./<%= model.pascal %>.client instead.
+<% if (model.isSingleton) { -%>
+import { createSingletonClient, serializeContent } from "<%= runtimeImport %>";
+import type { ContentSchema, SerializedContent, SingletonContentClient } from "<%= runtimeImport %>";
+<% } else { -%>
+import { createContentClient, serializeContent } from "<%= runtimeImport %>";
+import type { CollectionContentClient, ContentSchema, SerializedContent } from "<%= runtimeImport %>";
+<% } -%>
+
+import schema from "./<%= model.uid %>.json";
+<%
+if (model.referenceImports && model.referenceImports.length > 0) {
+  model.referenceImports.forEach((referenceImport) => {
+-%>
+import * as <%= referenceImport.pascal %> from "./<%= referenceImport.pascal %>";
+<%
+  });
+}
+if (model.isSingleton) {
+-%>
+import type { <%= model.pascal %>, <%= model.pascal %>Input } from "./<%= model.pascal %>.types";
+<% } else { -%>
+import type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query } from "./<%= model.pascal %>.types";
+<% } -%>
+
+export type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>FimoMeta, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query, <%= model.pascal %>References, <%= model.pascal %>Result, <%= model.pascal %>Sort, <%= model.pascal %>Where } from "./<%= model.pascal %>.types";
+<% if (!model.isSingleton) { -%>
+export type { CollectionPage, CollectionPageInfo } from "<%= runtimeImport %>";
+export type InfiniteListQuery<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+> = Omit<<%= model.pascal %>Query<TFields, TPopulate>, "offset">;
+<% } -%>
+
+<% if (model.isSingleton) { -%>
+const client: SingletonContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createSingletonClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema: schema as unknown as ContentSchema,
+<% } else { -%>
+const client: CollectionContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createContentClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema: schema as unknown as ContentSchema,
+<% } -%>
+<% if (model.referenceImports && model.referenceImports.length > 0) { -%>
+  references: { <%= model.referenceImports.map((referenceImport) => referenceImport.pascal).join(", ") %> },
+<% } -%>
+});
+
+type <%= model.pascal %>Source = Pick<<%= model.pascal %>, "id" | "__fimo">;
+declare const SERIALIZED_CONTENT: unique symbol;
+
+/** Plain JSON for passing <%= model.pascal %> content through framework data boundaries. */
+export type Serialized<%= model.pascal %><
+  TValue extends <%= model.pascal %>Source | readonly <%= model.pascal %>Source[] = <%= model.pascal %>,
+> = SerializedContent<TValue> & { readonly [SERIALIZED_CONTENT]: TValue };
+
+/** Convert one <%= model.pascal %> result, or an array of results, into plain JSON. */
+export function serialize<TValue extends <%= model.pascal %>Source | readonly <%= model.pascal %>Source[]>(
+  value: TValue
+): Serialized<%= model.pascal %><TValue> {
+  return serializeContent(value) as Serialized<%= model.pascal %><TValue>;
+}
+
+<% if (model.isSingleton) { -%>
+export const { get, update, wrapWithSource, meta } = client;
+<% } else { -%>
+export const { wrapWithSource, meta, getById, getBySlug, getByField, list, get, create, update, remove } = client;
+<% } -%>
+
+export default client;

package/assets/content-templates/types-template.eta

@@ -9,7 +9,7 @@
  */
 %>
 // AUTO-GENERATED ⚠️ – do not edit by hand
-import { type Fields, type FimoBoolean, type FimoMedia, type FimoPolymorphicReference, type FimoReference, type FimoRichText, type FimoRichTextContent, type FimoString, type Populate, type PopulatedResult, type ProjectedWithPopulate, type Query, type Sort, type Where, type WithReferences } from "fimo/ui";
+import { type Fields, type FimoBoolean, type FimoMedia, type FimoPolymorphicReference, type FimoReference, type FimoRichText, type FimoRichTextContent, type FimoString, type Populate, type PopulatedResult, type ProjectedWithPopulate, type Query, type Sort, type Where, type WithReferences } from "<%= runtimeImport %>";
 <%
 if (model.referenceImports && model.referenceImports.length > 0) {
   model.referenceImports.forEach((referenceImport) => {
@@ -28,7 +28,7 @@ import type { <%= referenceImport.pascal %> } from "./<%= referenceImport.pascal
  * <%= model.pascal %> entity interface
  */
 export interface <%= model.pascal %>FimoMeta {
-  contentType: string;
+  contentType: "<%= model.uid %>";
 }
 
 export interface <%= model.pascal %> extends WithReferences<<%= model.pascal %>References> {

package/assets/skills/fimo-cli/SKILL.md

@@ -44,6 +44,8 @@ Branch on `error.code`, never on `error.message`. The envelope shape is versione
 
 For shell composition use plain pretty mode (`cd $(fimo …)`); for structured parsing use `--json`. JSON mode disables interactive prompts — commands that need a confirmation will fail fast with `NON_INTERACTIVE_REFUSAL` unless every required arg is on the command line (`--yes`, `--org`, etc.).
 
+Pretty output may hide URLs behind clickable labels. Agents should use `--json` and read `data`.
+
 ## Critical: `.fimo/project.json` is the project link
 
 A Fimo project is identified by `.fimo/project.json`, written by `fimo init`. This file connects the local directory to the remote Fimo project. **Never edit it manually.** Most CLI commands find it by walking up from the cwd.

package/assets/skills/fimo-cli/references/deploy.md

@@ -19,11 +19,30 @@ fimo deploy --no-restart                     # skip dev-server restart (HMR-safe
 fimo deploy -m "<commit message>" --publish  # also publish a new live version
 ```
 
-- **`fimo deploy`** — commits pending changes, pushes to the current env's branch, syncs that env's preview sandbox, prints the preview URL.
+- **`fimo deploy`** — commits pending changes, pushes to the current env's branch, syncs that env's preview sandbox, and links to the Preview and Fimo dashboard.
 - **`fimo deploy --publish`** — same as above, then triggers a live publish and prints the live URL. Runs from `main` only. **Only use `--publish` when the user signals "ship it"** — first-time site completion, or an explicit "publish" / "go live" request. Otherwise stick to plain `fimo deploy`. (For a _versioned_ prod release, use `fimo publish` instead — see below.)
 - **`-m`** is the commit message used when there are uncommitted local changes; required in non-interactive shells. Omit if the working tree is already clean.
 - **`--no-restart`** — tells the sandbox to skip the dev-server restart and let Vite HMR pick up the change. Shaves ~3s per deploy. See "Skipping the dev-server restart" below for when it's safe.
 
+## Reading deploy destinations
+
+Interactive output uses named links. Agents and scripts should request JSON:
+
+```bash
+fimo deploy -m "<commit message>" --json
+fimo deploy -m "<commit message>" --publish --json
+```
+
+Read these fields from `data`:
+
+| Field           | Destination                                                 |
+| --------------- | ----------------------------------------------------------- |
+| `preview_url`   | Shareable preview. Its token expires, so do not persist it. |
+| `dashboard_url` | Stable, authenticated Fimo project and environment page.    |
+| `app_url`       | Public live site, returned after a successful `--publish`.  |
+
+When reporting the result, present the raw values as named Markdown links. If no code changed and you only need fresh destinations, use `fimo preview url --json` instead of deploying again.
+
 Public project variables managed with `fimo vars add` and `fimo vars update` are injected into preview/build/deploy environments. Project secrets are not injected into app builds; agents request secrets separately through their own config. See `references/project-vars-and-secrets.md`.
 
 ## Warm the sandbox early in a session (optional)
@@ -61,6 +80,8 @@ There's nothing special about this — it's the same `fimo deploy` you'd run lat
 
 **When in doubt, omit the flag.** The default (restart) is the safe choice — a wasted restart costs 3 seconds; a missing one costs the user serving stale code until they notice and re-deploy.
 
+**One case is handled for you:** if the deploy changes the project's route set (a page added, removed, or moved), the API tells the preview to reload regardless of this flag. A router builds its route table once per document, so the new page would otherwise exist but be unreachable — missing from the Studio route selector and 404-ing from the site's own links. This costs a page load, not a restart.
+
 ## Publishing: `fimo deploy --publish` vs `fimo publish`
 
 Two different "go live" mechanisms — pick deliberately:

package/assets/skills/fimo-cli/references/preview.md

@@ -14,24 +14,25 @@ fimo --env feat/redesign preview url                # URL for a specific env
 fimo preview url --env main --json                  # structured output for agents / scripts
 ```
 
-- **Pretty mode** prints the URL alone on stdout so you can pipe it: `fimo preview url | xargs open` or `curl "$(fimo preview url)"`.
+- **Interactive mode** shows named Preview and Fimo links. When piped, it prints only the raw preview URL, so `fimo preview url | xargs open` and `curl "$(fimo preview url)"` keep working.
 - **JSON mode** (or `FIMO_OUTPUT=json`) emits the standard envelope:
 
 ```json
 {
   "schema_version": 1,
   "command": "preview url",
-  "kind": "result",
+  "status": "ok",
   "data": {
     "project_id": "prj_abc",
     "env": "main",
     "preview_url": "https://...",
+    "dashboard_url": "https://fimo.ai/app/projects/prj_abc/env/main/preview",
     "expires_at": "2026-06-02T18:42:00.000Z"
   }
 }
 ```
 
-`expires_at` is the token's hard deadline. If you're caching the URL for more than ~10 minutes, re-run the command.
+Agents should read `data.preview_url` or `data.dashboard_url`, never parse the human output. The dashboard URL is stable; `expires_at` is the preview token's hard deadline. If you're caching the preview URL for more than ~10 minutes, re-run the command.
 
 ## When to use it
 

package/assets/skills/fimo-code/references/setup-plain-vite.md

@@ -129,12 +129,14 @@ can omit it.
 ## File: `src/App.tsx`
 
 ```tsx
-import { Text } from 'fimo/ui';
+import { Text, useLabels } from 'fimo/ui';
 
 export function App() {
+  const { t } = useLabels();
+
   return (
     <main>
-      <Text path="home.hero.title">Welcome</Text>
+      <Text value={t('home.hero.title')} as="h1" />
     </main>
   );
 }

package/assets/skills/fimo-code/references/setup-react-router.md

@@ -171,12 +171,14 @@ Page filenames are your choice; the scaffold uses PascalCase (e.g. `Index.tsx`,
 ## File: `src/pages/Index.tsx`
 
 ```tsx
-import { Text } from 'fimo/ui';
+import { Text, useLabels } from 'fimo/ui';
 
 export default function HomePage() {
+  const { t } = useLabels();
+
   return (
     <main>
-      <Text path="home.hero.title">Welcome</Text>
+      <Text value={t('home.hero.title')} as="h1" />
     </main>
   );
 }

package/assets/skills/fimo-studio/SKILL.md

@@ -7,7 +7,8 @@ description: >-
   "how do I X in the UI", or screenshots of the dashboard. Topics
   covered: dashboard content and CMS, publishing from the dashboard,
   dashboard SEO/domain settings, schedules and run history, outbound webhooks,
-  visual editing, version history UI, dashboard sharing/billing, and dashboard chat. Never describe
+  visual editing, version history UI, dashboard sharing/billing, dashboard chat,
+  and the command palette. Never describe
   UI locations, buttons, or panels from memory — always read the relevant
   reference file first.
 ---
@@ -30,6 +31,7 @@ Read the relevant reference file when the user's question matches a topic.
 
 | Topic                    | Reference                               | When to read                                          |
 | ------------------------ | --------------------------------------- | ----------------------------------------------------- |
+| Command Palette          | references/command-palette.md           | "What can I open with Cmd+K?", "Quick actions"        |
 | Publish & Deploy         | references/publish-and-deploy.md        | "How do I publish?", "How do I make my site live?"    |
 | Custom Domains           | references/custom-domains.md            | "How do I use my own domain?", "DNS setup"            |
 | Content Management (CMS) | references/cms.md                       | "How does the CMS work?", "How do I add blog posts?"  |

package/assets/skills/fimo-studio/references/ai-chat.md

@@ -1,6 +1,6 @@
 ## Where to Find It
 
-The AI chat opens as a floating panel by default. You can dock it to the left or right edge from the project menu's **Chat position** submenu (Floating / Left / Right). Toggle the chat open or closed by clicking the **chat (speech-bubble) icon** in the header, or press **Cmd+Shift+H** (Mac) / **Ctrl+Shift+H** (Windows/Linux).
+On desktop, the AI chat opens docked on the left by default. You can make it floating or dock it on either side from the project menu's **Chat position** submenu (Floating / Left / Right). Toggle the chat open or closed by clicking the **chat (speech-bubble) icon** in the header, or press **Cmd+Shift+H** (Mac) / **Ctrl+Shift+H** (Windows/Linux).
 
 ## Sending a Message
 

package/assets/skills/fimo-studio/references/command-palette.md

@@ -0,0 +1,31 @@
+# Command Palette
+
+Press **Cmd+K** on macOS or **Ctrl+K** on Windows and Linux to open the command palette from any authenticated Studio screen. Start typing to filter the available commands.
+
+## What You Can Open
+
+The palette includes the destinations you are allowed to use:
+
+- Organizations, projects, and the main Studio workspaces
+- Preview pages
+- CMS Collections, Singles, Forms, Labels, and content types
+- Agent runs, definitions, and individual agents
+- Project settings sections
+- Asset folders and code files
+
+You can also open documentation, feedback, account actions, project history, invitations, and the Publish review flow. Use **Escape** to return from a searchable subpage to the main command list, then press it again to close the palette.
+
+## Actions for the Current Page
+
+Studio adds commands that are relevant to the page you are viewing. Depending on the page and your permissions, these can include:
+
+- Refreshing Preview or opening it in a new tab
+- Creating a CMS entry or changing the content locale
+- Uploading an asset, creating a folder, or generating an image
+- Opening a code file or toggling the code sidebar
+- Running an agent, opening its Preview result, or resolving proposed changes
+- Adding a language, secret, schedule, or webhook
+
+## Permissions and Confirmations
+
+The palette follows the same permissions, plan availability, and feature flags as Studio's visible navigation and buttons. Publishing and other reviewed flows open their normal dialog instead of acting immediately. If a command is unavailable on the page or for your role, it is not shown.

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-08-07T16:37:52.216Z",
+  "bundledAt": "2026-08-10T12:44:03.858Z",
   "cliVersion": "0.11.0",
   "external": [
     "oxc-parser",