fimo 0.11.0 → 0.12.0-staging.1

package/README.md

@@ -1,6 +1,12 @@
+<!-- npm renders this README from the published tarball, so this URL is frozen into every
+     version already on the registry: the object must stay at this exact key forever, and
+     nothing in CI catches its removal. It is served from the R2 assets bucket rather than
+     fimo.ai on purpose — the marketing site rewrites unmatched paths to index.html, so a
+     missing asset there returns 200 with an HTML body instead of a 404, which is how the
+     previous logo URL stayed broken without anyone noticing. -->
 <p align="center">
   <a href="https://fimo.ai">
-    <img src="https://fimo.ai/favicon-orange-apple-touch-icon.png" height="80" alt="Fimo" />
+    <img src="https://assets.fimo.ai/brand/fimo-mark-512.png" height="80" alt="Fimo" />
   </a>
 </p>
 

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/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-08-07T11:16:51.399Z",
+  "bundledAt": "2026-08-09T19:42:51.429Z",
   "cliVersion": "0.11.0",
   "external": [
     "oxc-parser",