@notis_ai/cli 0.2.7 → 0.2.8

package/dist/scaffolds/notis-journal/package.json

@@ -1,7 +1,7 @@
 {
   "name": "notis-journal",
   "version": "0.1.0",
-  "notisAppVersion": "0.1.6",
+  "notisAppVersion": "0.1.7",
   "private": true,
   "type": "module",
   "scripts": {
@@ -25,7 +25,7 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^4.0.0",
-    "postcss": "^8.0.0",
+    "postcss": "^8.5.25",
     "tailwindcss": "^3.4.0",
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",

package/dist/scaffolds/notis-journal/packages/sdk/src/config.ts

@@ -62,6 +62,20 @@ export const NOTIS_APP_CATEGORIES = [
 
 export type NotisAppCategory = typeof NOTIS_APP_CATEGORIES[number];
 
+export interface NotisAppDatabaseConfig {
+  /** Database slug, as declared by the app. */
+  slug: string;
+  /**
+   * Ship this database's rows to everyone who installs the app.
+   *
+   * Off by default: declaring a database publishes its STRUCTURE, never its
+   * content. Turn it on only for starter content that every installer should
+   * receive - a default folder tree, a set of templates - and never for a
+   * database that accumulates the author's own data.
+   */
+  seedDocuments?: boolean;
+}
+
 export interface NotisAppAuthor {
   name: string;
   handle?: string;
@@ -69,23 +83,34 @@ export interface NotisAppAuthor {
 }
 
 export interface NotisAppSkillConfig {
+  /** Stable source-owned key used by other app declarations. */
   key: string;
+  /** Path to the skill entrypoint, relative to notis.config.ts. */
   path: string;
+  /** User-facing name used for the installed skill. */
   name: string;
   description?: string;
 }
 
 export interface NotisAppOnboardingConfig {
+  /** Key of a skill declared in `skills`. */
   skill: string;
+  /** Editable message placed in Notis when onboarding is opened. */
   prompt: string;
 }
 
 export interface NotisAppScreenshotConfig {
+  /** Conventional metadata/screenshot-N.png source path. */
   path: string;
+  /** Meaningful description used by the Store gallery and assistive technology. */
   alt: string;
+  /** Route slug captured by `notis apps screenshot`. */
   route?: string;
+  /** Optional fixture scenario from metadata/screenshot-fixtures.json. */
   scenario?: string;
+  /** Optional CSS selector captured as the truthful focal region for this Store image. */
   focus?: string;
+  /** Portal color scheme used while rendering this screenshot. Defaults to light. */
   theme?: 'light' | 'dark';
 }
 
@@ -106,6 +131,19 @@ export const NOTIS_APP_ACCENTS = [
 
 export type NotisAppAccent = typeof NOTIS_APP_ACCENTS[number];
 
+export interface NotisAppCapabilities {
+  /**
+   * Read every database in the workspace, not only the ones this app declares
+   * in `databases` or created itself.
+   *
+   * An app runtime is otherwise sandboxed to its own databases, so a catalog or
+   * explorer app sees an empty list without this. `'read'` is the only accepted
+   * value and it never grants writes: `LOCAL_NOTIS_DATABASE_UPSERT_*` stays
+   * bound to the app's own databases.
+   */
+  workspaceDatabases?: 'read';
+}
+
 export interface NotisAppConfig {
   /** URL-safe app slug. Existing apps may still use a display name here. */
   name: string;
@@ -127,11 +165,24 @@ export interface NotisAppConfig {
   tagline?: string;
   /** @deprecated Add release entries to the root CHANGELOG.md instead. */
   versionNotes?: string;
+  /** Editorial screenshot order and capture scenarios for the Store listing. */
   screenshots?: NotisAppScreenshotConfig[];
-  databases?: string[];
+  /**
+   * Databases this app owns. A bare string publishes structure only; use the
+   * object form to opt a database into shipping its rows to installers.
+   */
+  databases?: (string | NotisAppDatabaseConfig)[];
+  /**
+   * Extra permissions the app asks for at install time. Everything here widens
+   * what the app can reach beyond its own data, so each one is surfaced to the
+   * user before they install.
+   */
+  capabilities?: NotisAppCapabilities;
   routes?: NotisRouteConfig[];
   tools?: string[];
+  /** Skills shipped from this app's source tree. */
   skills?: NotisAppSkillConfig[];
+  /** Optional onboarding entrypoint exposed from the app sidebar. */
   onboarding?: NotisAppOnboardingConfig;
 }
 

package/dist/scaffolds/notis-notes/app/page.tsx

@@ -24,10 +24,18 @@ import {
   type UpsertDocumentArgs,
 } from '@notis/sdk';
 import { ArrowUpRightIcon as ArrowUpRight, CubeIcon as Boxes, BookOpenIcon as BookOpen, BookOpenTextIcon as BookOpenText, CalendarIcon as CalendarDays, CaretDownIcon as ChevronDown, CaretLeftIcon as ChevronLeft, CaretRightIcon as ChevronRight, FileTextIcon as FileText, FolderIcon as Folder, FolderMinusIcon as FolderMinus, FolderOpenIcon as FolderOpen, FolderPlusIcon as FolderPlus, FoldersIcon as Folders, SquaresFourIcon as LayoutGrid, CircleNotchIcon as Loader2, MagnifyingGlassIcon as Search, NotePencilIcon as NotebookPen, PencilIcon as Pencil, PlusIcon as Plus, NoteIcon as StickyNote, TableIcon as Table2, TrashIcon as Trash, XIcon as X, type Icon } from '@phosphor-icons/react';
-import * as PhosphorIcons from '@phosphor-icons/react';
 
+import {
+  PHOSPHOR_ICONS,
+  PHOSPHOR_ICON_ALIASES,
+  PHOSPHOR_ICON_NAMES,
+} from './phosphor-icons';
 import { Button } from '@/components/ui/button';
 import { cn } from '@/lib/utils';
+import {
+  VISIBLE_PROPERTIES_PROPERTY,
+  resolveVisibleColumns,
+} from '@/lib/visible-properties';
 
 type TabKey = 'gallery' | 'table' | 'calendar';
 
@@ -76,23 +84,6 @@ type IconName = string;
 
 const PHOSPHOR_ICON_PREFIX = 'phosphor:';
 
-const PHOSPHOR_ICON_OVERRIDES: Record<string, string> = {
-  boxes: 'Cube',
-  'calendar-days': 'Calendar',
-  'layout-grid': 'SquaresFour',
-  'layout-dashboard': 'SquaresFour',
-  'link-2': 'Link',
-  'notebook-pen': 'NotePencil',
-  'rows-3': 'Rows',
-  search: 'MagnifyingGlass',
-  'settings-2': 'SlidersHorizontal',
-  sparkles: 'Sparkle',
-  'sticky-note': 'Note',
-  'table-2': 'Table',
-  home: 'House',
-  'folder-kanban': 'Kanban',
-};
-
 const SUGGESTED_FOLDER_ICON_NAMES: IconName[] = [
   'folder',
   'folder-open',
@@ -114,21 +105,6 @@ const SUGGESTED_FOLDER_ICON_NAMES: IconName[] = [
   'tag',
 ];
 
-function toPascalCase(value: string): string {
-  return value
-    .split(/[-_\s]+/)
-    .filter(Boolean)
-    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
-    .join('');
-}
-
-function toKebabCase(value: string): string {
-  return value
-    .replace(/Icon$/, '')
-    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-    .toLowerCase();
-}
-
 function parsePhosphorIconName(icon: string | null | undefined): IconName | null {
   if (typeof icon !== 'string' || !icon.startsWith(PHOSPHOR_ICON_PREFIX)) {
     return null;
@@ -139,20 +115,14 @@ function parsePhosphorIconName(icon: string | null | undefined): IconName | null
 
 function getPhosphorIconComponent(icon: string | null | undefined): Icon | null {
   const name = parsePhosphorIconName(icon);
-  if (!name) return null;
-  const exportBaseName = PHOSPHOR_ICON_OVERRIDES[name] ?? toPascalCase(name);
-  const component = (PhosphorIcons as Record<string, unknown>)[`${exportBaseName}Icon`];
-  return typeof component === 'function' ? (component as Icon) : null;
+  return name ? getPhosphorIconComponentByName(name) : null;
 }
 
 function getPhosphorIconComponentByName(name: string): Icon | null {
-  return getPhosphorIconComponent(`${PHOSPHOR_ICON_PREFIX}${name}`);
+  return PHOSPHOR_ICONS[name] ?? PHOSPHOR_ICONS[PHOSPHOR_ICON_ALIASES[name] ?? ''] ?? null;
 }
 
-const ALL_PHOSPHOR_ICON_NAMES = Object.keys(PhosphorIcons)
-  .filter((key) => key.endsWith('Icon') && key !== 'Icon')
-  .map(toKebabCase)
-  .sort((a, b) => a.localeCompare(b));
+const ALL_PHOSPHOR_ICON_NAMES = [...PHOSPHOR_ICON_NAMES].sort((a, b) => a.localeCompare(b));
 
 function normalizeCollectionItem(value: unknown): CollectionItemContext | null {
   const record = asRecord(value);
@@ -570,6 +540,7 @@ function ViewPill({
   return (
     <button
       type="button"
+      data-view={config.key}
       onClick={onSelect}
       className={cn(
         'inline-flex items-center gap-1.5 rounded-md px-2.5 py-1 text-[12.5px] font-medium transition-colors',
@@ -767,8 +738,15 @@ export default function NotesPage() {
       }
     : undefined;
 
-  const notesQuery = useDocuments(NOTE_DATABASE_SLUG, { filter: notesFilter, pageSize: 250 });
-  const foldersQuery = useDocuments(FOLDER_DATABASE_SLUG, { pageSize: 500 });
+  const notesQuery = useDocuments(NOTE_DATABASE_SLUG, {
+    filter: notesFilter,
+    pageSize: 250,
+    fetchAll: true,
+  });
+  const foldersQuery = useDocuments(FOLDER_DATABASE_SLUG, {
+    pageSize: 500,
+    fetchAll: true,
+  });
 
   const { setLoading: setSearchLoading } = useTopBarSearch({
     value: searchQuery,
@@ -795,6 +773,18 @@ export default function NotesPage() {
   const folderOptions = buildFolderOptions(folders);
   const folderNameById = new Map(folderOptions.map((f) => [f.id, f.title]));
 
+  // Which columns the table shows is per-folder VIEW config: it never hides a
+  // property from query and never changes what a note is. The active folder's
+  // choice wins; with no folder selected the union across folders is shown.
+  const { columns: visibleColumns } = resolveVisibleColumns({
+    metadataProperties,
+    activeFolderSelection: collectionItem?.properties?.[VISIBLE_PROPERTIES_PROPERTY],
+    activeFolderSelected: Boolean(collectionItem),
+    allFolderSelections: folders.map(
+      (folder) => (folder.properties as Record<string, unknown> | undefined)?.[VISIBLE_PROPERTIES_PROPERTY],
+    ),
+  });
+
   // The calendar always offers a built-in "Created" field (sourced from each
   // note's created_at) plus any user-defined date properties on the database.
   const calendarDateFields: CalendarDateField[] = [
@@ -1061,7 +1051,7 @@ export default function NotesPage() {
   }
 
   return (
-    <main className="flex min-h-screen flex-col bg-background">
+    <main data-store-screenshot="notes" className="flex min-h-screen flex-col bg-background">
       <PageHeader
         title={pageTitle}
         icon={pageIcon}
@@ -1110,6 +1100,7 @@ export default function NotesPage() {
         <TableBody
           notes={notes}
           metadataProperties={metadataProperties}
+          visibleColumns={visibleColumns}
           folderOptions={folderOptions}
           folderNameById={folderNameById}
           folderPropertyName={folderPropertyName}
@@ -1445,6 +1436,7 @@ function BulkFolderPicker({
 function TableBody({
   notes,
   metadataProperties,
+  visibleColumns,
   folderOptions,
   folderNameById,
   folderPropertyName,
@@ -1459,6 +1451,7 @@ function TableBody({
 }: {
   notes: DocumentRecord[];
   metadataProperties: DatabaseProperty[];
+  visibleColumns?: DatabaseProperty[];
   folderOptions: FolderOption[];
   folderNameById: Map<string, string>;
   folderPropertyName: string;
@@ -1471,7 +1464,7 @@ function TableBody({
   multiSelect: MultiSelectController<DocumentRecord>;
   rowRefs: Map<string, HTMLElement>;
 }) {
-  const columns = metadataProperties.slice(0, 6);
+  const columns = visibleColumns ?? metadataProperties.slice(0, 6);
   const allSelected =
     notes.length > 0 && notes.every((note) => multiSelect.isSelected(note.id));
   const handleSelectAllToggle = () => {