alinea 2.0.0-preview.9 → 2.0.0-rc2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/.init/.mcp.json +11 -0
- package/dist/.init/AGENTS.md +17 -0
- package/dist/.init/CLAUDE.md +1 -0
- package/dist/.init/content/pages/welcome.json +1 -1
- package/dist/.init/package.json +1 -1
- package/dist/.init/src/cms.ts +4 -2
- package/dist/.init-pm/bun.lock +0 -0
- package/dist/.mcp/later/dev.json +1 -0
- package/dist/.mcp/lock/dev.json +1 -0
- package/dist/.mcp/online/dev.json +1 -0
- package/dist/LICENSES.md +2239 -294
- package/dist/adapter/next/cms.d.ts +2 -2
- package/dist/adapter/next/cms.js +66 -32
- package/dist/adapter/next/context.js +5 -6
- package/dist/adapter/next/dashboardUrl.d.ts +6 -0
- package/dist/adapter/next/dashboardUrl.js +13 -0
- package/dist/adapter/next/devCache.d.ts +16 -0
- package/dist/adapter/next/devCache.js +32 -0
- package/dist/adapter/next/handler.js +18 -4
- package/dist/adapter/next/syncCheck.d.ts +15 -2
- package/dist/adapter/next/syncCheck.js +26 -9
- package/dist/adapter/next/with-alinea.js +27 -20
- package/dist/backend/CommitEntries.d.ts +17 -0
- package/dist/backend/CommitEntries.js +39 -0
- package/dist/backend/Handler.d.ts +15 -1
- package/dist/backend/Handler.js +106 -32
- package/dist/backend/api/BasicAuth.js +5 -1
- package/dist/backend/api/BlobStore.d.ts +21 -0
- package/dist/backend/api/BlobStore.js +63 -0
- package/dist/backend/api/CreateBackend.js +10 -8
- package/dist/backend/api/DatabaseApi.d.ts +4 -1
- package/dist/backend/api/DatabaseApi.js +104 -7
- package/dist/backend/api/GithubApi.d.ts +13 -0
- package/dist/backend/api/GithubApi.js +217 -54
- package/dist/backend/api/OAuth2.js +21 -26
- package/dist/backend/api/ProxyMedia.js +3 -0
- package/dist/backend/api/database.js +6 -6
- package/dist/backend/store/GeneratedDatabase.js +4 -2
- package/dist/backend/store/GeneratedDatabaseNode.d.ts +5 -1
- package/dist/backend/store/GeneratedDatabaseNode.js +9 -19
- package/dist/backend/store/GeneratedRelease.d.ts +1 -1
- package/dist/backend/store/GeneratedRelease.js +3 -4
- package/dist/backend/util/JWKS.d.ts +4 -0
- package/dist/backend/util/JWKS.js +40 -0
- package/dist/backend/util/Syncable.d.ts +6 -0
- package/dist/backend/util/Syncable.js +3 -1
- package/dist/bundled.d.ts +7124 -1459
- package/dist/chunks/{node-sqlite-XVNTNMCY.js → bun-sqlite-RI6BYU5S.js} +3 -3
- package/dist/chunks/ccitt-Y7TDCCPM.js +90 -0
- package/dist/chunks/{chunk-ASYKC6IE.js → chunk-2PP7WJUJ.js} +2 -12
- package/dist/chunks/{chunk-DWR5A5KL.js → chunk-4VKHBA57.js} +25 -6
- package/dist/chunks/{chunk-QJGGYF6E.js → chunk-4ZA6KZHS.js} +5 -5
- package/dist/chunks/{chunk-OFEKTDRF.js → chunk-7DDPSWRY.js} +8383 -5156
- package/dist/chunks/{chunk-ETWOY4AL.js → chunk-A2I6MCCS.js} +1 -1
- package/dist/chunks/chunk-CYVOGRSD.js +218 -0
- package/dist/chunks/{chunk-TIJTT5ZI.js → chunk-G43W7AME.js} +1 -0
- package/dist/chunks/{chunk-KMLLLZ6X.js → chunk-NP4M2257.js} +1 -0
- package/dist/chunks/{chunk-D6RGFNUW.js → chunk-PMGIIYDD.js} +14215 -8950
- package/dist/chunks/{chunk-IYAQC63Y.js → chunk-PSSMQKAH.js} +1607 -744
- package/dist/chunks/{chunk-AIU6CMVT.js → chunk-PTYZMV5G.js} +1 -1
- package/dist/chunks/{chunk-66YZ47TY.js → chunk-RAR44T5O.js} +1 -1
- package/dist/chunks/chunk-RE6CDK2M.js +254 -0
- package/dist/chunks/{chunk-UPY2RUZF.js → chunk-TWBREZWC.js} +30 -0
- package/dist/chunks/{chunk-QSN6RH6X.js → chunk-VA6NC3MI.js} +1 -1
- package/dist/chunks/dist-IDG44KDI.js +7499 -0
- package/dist/chunks/jpeg-OJTBZV3C.js +292 -0
- package/dist/chunks/jpx-4VRYG2JB.js +667 -0
- package/dist/chunks/{bun-sqlite-5SHXN3AT.js → node-sqlite-C7VJ2NSN.js} +3 -3
- package/dist/cli/Generate.d.ts +2 -1
- package/dist/cli/Generate.js +55 -24
- package/dist/cli/Init.d.ts +43 -2
- package/dist/cli/Init.js +144 -28
- package/dist/cli/Mcp.d.ts +25 -0
- package/dist/cli/Mcp.js +106 -0
- package/dist/cli/Serve.d.ts +1 -1
- package/dist/cli/Serve.js +14 -6
- package/dist/cli/bin.js +33 -11
- package/dist/cli/build/BuildEmitter.d.ts +5 -1
- package/dist/cli/build/BuildEmitter.js +8 -3
- package/dist/cli/generate/CompileConfig.js +10 -6
- package/dist/cli/generate/CopyStaticFiles.d.ts +1 -1
- package/dist/cli/generate/CopyStaticFiles.js +27 -14
- package/dist/cli/generate/DevDB.d.ts +4 -1
- package/dist/cli/generate/DevDB.js +15 -7
- package/dist/cli/generate/GenerateContext.d.ts +3 -0
- package/dist/cli/generate/GenerateDashboard.d.ts +1 -1
- package/dist/cli/generate/GenerateDashboard.js +20 -6
- package/dist/cli/generate/GeneratedPaths.d.ts +21 -0
- package/dist/cli/generate/GeneratedPaths.js +33 -0
- package/dist/cli/generate/LinkMediaFiles.d.ts +7 -0
- package/dist/cli/generate/LinkMediaFiles.js +52 -0
- package/dist/cli/generate/MediaLocations.d.ts +18 -0
- package/dist/cli/generate/MediaLocations.js +69 -0
- package/dist/cli/serve/CreateLocalServer.d.ts +2 -1
- package/dist/cli/serve/CreateLocalServer.js +41 -11
- package/dist/cli/serve/DevLock.d.ts +11 -0
- package/dist/cli/serve/DevLock.js +42 -0
- package/dist/cli/serve/DevServer.d.ts +3 -2
- package/dist/cli/serve/DevServer.js +18 -6
- package/dist/cli/serve/LiveReload.d.ts +1 -1
- package/dist/cli/serve/LiveReload.js +3 -2
- package/dist/cli/serve/ServeContext.d.ts +0 -1
- package/dist/cli/serve/StartServer.d.ts +2 -1
- package/dist/cli/serve/StartServer.js +4 -2
- package/dist/cli/serve/mcp/DevMcp.d.ts +16 -0
- package/dist/cli/serve/mcp/DevMcp.js +50 -0
- package/dist/cli/serve/mcp/McpGraph.d.ts +35 -0
- package/dist/cli/serve/mcp/McpGraph.js +64 -0
- package/dist/cli/serve/mcp/McpInput.d.ts +11 -0
- package/dist/cli/serve/mcp/McpInput.js +254 -0
- package/dist/cli/serve/mcp/McpInstructions.d.ts +1 -0
- package/dist/cli/serve/mcp/McpInstructions.js +16 -0
- package/dist/cli/serve/mcp/McpSchema.d.ts +31 -0
- package/dist/cli/serve/mcp/McpSchema.js +184 -0
- package/dist/cli/serve/mcp/McpServer.d.ts +47 -0
- package/dist/cli/serve/mcp/McpServer.js +112 -0
- package/dist/cli/serve/mcp/McpTools.d.ts +25 -0
- package/dist/cli/serve/mcp/McpTools.js +618 -0
- package/dist/cli/static/dashboard/entry.js +2 -1
- package/dist/cli/static/init/agents.md +13 -0
- package/dist/cli/static/init/cms.js +4 -2
- package/dist/cli/util/ForwardCommand.js +4 -12
- package/dist/cli/util/PublicDefines.d.ts +1 -0
- package/dist/cli/util/PublicDefines.js +2 -1
- package/dist/cli/util/RunForwarded.d.ts +13 -0
- package/dist/cli/util/RunForwarded.js +166 -0
- package/dist/cli/util/WarnPublicEnv.js +2 -0
- package/dist/cloud/CloudHandshake.js +9 -46
- package/dist/cloud/CloudRemote.js +21 -7
- package/dist/cms.d.ts +21 -0
- package/dist/cms.js +49 -0
- package/dist/components/Alert.d.ts +29 -0
- package/dist/components/Alert.js +86 -0
- package/dist/components/AppShell.d.ts +15 -0
- package/dist/components/AppShell.js +38 -0
- package/dist/components/AsyncList.d.ts +52 -0
- package/dist/components/AsyncList.js +69 -0
- package/dist/components/Badge.d.ts +13 -0
- package/dist/components/Badge.js +53 -0
- package/dist/components/Blockquote.d.ts +7 -0
- package/dist/components/Blockquote.js +26 -0
- package/dist/components/Breadcrumbs.d.ts +39 -3
- package/dist/components/Breadcrumbs.js +103 -22
- package/dist/components/Button.d.ts +33 -8
- package/dist/components/Button.js +73 -23
- package/dist/components/Calendar.d.ts +28 -3
- package/dist/components/Calendar.js +163 -54
- package/dist/components/Checkbox.d.ts +18 -7
- package/dist/components/Checkbox.js +84 -38
- package/dist/components/CheckboxGroup.d.ts +11 -5
- package/dist/components/CheckboxGroup.js +55 -19
- package/dist/components/Code.d.ts +10 -0
- package/dist/components/Code.js +49 -0
- package/dist/components/Collapsible.d.ts +25 -0
- package/dist/components/Collapsible.js +146 -0
- package/dist/components/ColorSwatch.d.ts +9 -2
- package/dist/components/ColorSwatch.js +20 -20
- package/dist/components/ColorSwatchPicker.d.ts +18 -3
- package/dist/components/ColorSwatchPicker.js +31 -27
- package/dist/components/ComboBox.d.ts +46 -10
- package/dist/components/ComboBox.js +223 -94
- package/dist/components/Command.d.ts +66 -0
- package/dist/components/Command.js +237 -0
- package/dist/components/ContentCard.d.ts +32 -0
- package/dist/components/ContentCard.js +221 -0
- package/dist/components/ContentGrid.d.ts +58 -0
- package/dist/components/ContentGrid.js +220 -0
- package/dist/components/DataList.d.ts +27 -0
- package/dist/components/DataList.js +68 -0
- package/dist/components/DateField.d.ts +19 -4
- package/dist/components/DateField.js +51 -44
- package/dist/components/DatePicker.d.ts +17 -4
- package/dist/components/DatePicker.js +61 -68
- package/dist/components/DateRangePicker.d.ts +19 -4
- package/dist/components/DateRangePicker.js +69 -80
- package/dist/components/Dialog.d.ts +64 -3
- package/dist/components/Dialog.js +215 -20
- package/dist/components/DropZone.d.ts +25 -3
- package/dist/components/DropZone.js +99 -18
- package/dist/components/DropdownMenu.d.ts +78 -0
- package/dist/components/DropdownMenu.js +318 -0
- package/dist/components/Empty.d.ts +46 -0
- package/dist/components/Empty.js +93 -0
- package/dist/components/Field.d.ts +34 -0
- package/dist/components/Field.js +166 -0
- package/dist/components/FileTrigger.d.ts +21 -0
- package/dist/components/FileTrigger.js +53 -0
- package/dist/components/FoldIcon.js +2 -1
- package/dist/components/Form.d.ts +23 -0
- package/dist/components/Form.js +64 -0
- package/dist/components/Heading.d.ts +13 -0
- package/dist/components/Heading.js +48 -0
- package/dist/components/Icon.d.ts +1 -1
- package/dist/components/Icon.js +3 -3
- package/dist/components/Kbd.d.ts +8 -0
- package/dist/components/Kbd.js +27 -0
- package/dist/components/Link.d.ts +21 -4
- package/dist/components/Link.js +22 -20
- package/dist/components/List.d.ts +23 -63
- package/dist/components/List.js +131 -251
- package/dist/components/MediaPreview.d.ts +35 -0
- package/dist/components/MediaPreview.js +227 -0
- package/dist/components/MultipleSelect.d.ts +27 -20
- package/dist/components/MultipleSelect.js +234 -216
- package/dist/components/NavRail.d.ts +41 -0
- package/dist/components/NavRail.js +121 -0
- package/dist/components/NumberField.d.ts +23 -5
- package/dist/components/NumberField.js +103 -60
- package/dist/components/Page.d.ts +57 -0
- package/dist/components/Page.js +130 -0
- package/dist/components/Popover.d.ts +39 -5
- package/dist/components/Popover.js +146 -22
- package/dist/components/PreviewFrame.d.ts +46 -0
- package/dist/components/PreviewFrame.js +182 -0
- package/dist/components/RadioGroup.d.ts +20 -7
- package/dist/components/RadioGroup.js +121 -31
- package/dist/components/Resizable.d.ts +51 -0
- package/dist/components/Resizable.js +1349 -0
- package/dist/components/SearchField.d.ts +42 -6
- package/dist/components/SearchField.js +117 -56
- package/dist/components/Select.d.ts +38 -10
- package/dist/components/Select.js +179 -101
- package/dist/components/Sheet.d.ts +52 -0
- package/dist/components/Sheet.js +216 -0
- package/dist/components/Sidebar.d.ts +56 -0
- package/dist/components/Sidebar.js +136 -0
- package/dist/components/SortableList.d.ts +84 -0
- package/dist/components/SortableList.js +368 -0
- package/dist/components/Spinner.d.ts +8 -0
- package/dist/components/Spinner.js +86 -0
- package/dist/components/Stack.d.ts +20 -0
- package/dist/components/Stack.js +45 -0
- package/dist/components/Surface.js +13 -3
- package/dist/components/Switch.d.ts +15 -4
- package/dist/components/Switch.js +30 -18
- package/dist/components/Table.d.ts +121 -14
- package/dist/components/Table.js +537 -96
- package/dist/components/Tabs.d.ts +33 -12
- package/dist/components/Tabs.js +68 -51
- package/dist/components/TagGroup.d.ts +26 -9
- package/dist/components/TagGroup.js +97 -31
- package/dist/components/Text.d.ts +16 -0
- package/dist/components/Text.js +44 -0
- package/dist/components/TextField.d.ts +33 -9
- package/dist/components/TextField.js +152 -47
- package/dist/components/TimeField.d.ts +25 -4
- package/dist/components/TimeField.js +82 -42
- package/dist/components/Timestamp.d.ts +17 -0
- package/dist/components/Timestamp.js +131 -0
- package/dist/components/Toggle.d.ts +15 -7
- package/dist/components/Toggle.js +4 -54
- package/dist/components/ToggleGroup.d.ts +33 -0
- package/dist/components/ToggleGroup.js +90 -0
- package/dist/components/Toolbar.d.ts +27 -8
- package/dist/components/Toolbar.js +51 -40
- package/dist/components/Tooltip.d.ts +22 -4
- package/dist/components/Tooltip.js +78 -34
- package/dist/components/Tree.d.ts +47 -20
- package/dist/components/Tree.js +230 -98
- package/dist/components/internal/Accept.d.ts +5 -0
- package/dist/components/internal/Accept.js +17 -0
- package/dist/components/internal/DateControl.d.ts +18 -0
- package/dist/components/internal/DateControl.js +92 -0
- package/dist/components/internal/DateValue.d.ts +16 -0
- package/dist/components/internal/DateValue.js +40 -0
- package/dist/components/internal/FormScope.d.ts +2 -0
- package/dist/components/internal/FormScope.js +8 -0
- package/dist/components/internal/ListBoxGroup.d.ts +12 -0
- package/dist/components/internal/ListBoxGroup.js +46 -0
- package/dist/components/internal/ListBoxOption.d.ts +20 -0
- package/dist/components/internal/ListBoxOption.js +111 -0
- package/dist/components/internal/Locale.d.ts +7 -0
- package/dist/components/internal/Locale.js +18 -0
- package/dist/components/internal/Placement.d.ts +3 -0
- package/dist/components/internal/Placement.js +13 -0
- package/dist/components/internal/PopoverSurface.d.ts +21 -0
- package/dist/components/internal/PopoverSurface.js +67 -0
- package/dist/components/internal/SelectionCheckbox.d.ts +8 -0
- package/dist/components/internal/SelectionCheckbox.js +57 -0
- package/dist/components/internal/Slot.d.ts +7 -0
- package/dist/components/internal/Slot.js +26 -0
- package/dist/components/internal/ToggleButton.d.ts +26 -0
- package/dist/components/internal/ToggleButton.js +68 -0
- package/dist/components/internal/Trigger.d.ts +16 -0
- package/dist/components/internal/Trigger.js +34 -0
- package/dist/components/internal/sortableDrag.d.ts +19 -0
- package/dist/components/internal/sortableDrag.js +175 -0
- package/dist/components/internal/useDragDrop.d.ts +22 -0
- package/dist/components/internal/useDragDrop.js +110 -0
- package/dist/components/types.d.ts +110 -0
- package/dist/components/types.js +0 -0
- package/dist/components.d.ts +33 -5
- package/dist/components.js +32 -5
- package/dist/config.d.ts +2 -0
- package/dist/config.js +12 -0
- package/dist/core/Client.js +12 -1
- package/dist/core/Config.d.ts +60 -2
- package/dist/core/Config.js +162 -9
- package/dist/core/Connection.d.ts +13 -1
- package/dist/core/Connection.js +9 -1
- package/dist/core/DashboardEntry.d.ts +19 -0
- package/dist/core/DashboardEntry.js +0 -0
- package/dist/core/Document.d.ts +12 -2
- package/dist/core/Document.js +39 -7
- package/dist/core/EntryFields.d.ts +11 -0
- package/dist/core/EntrySeed.d.ts +5 -1
- package/dist/core/EntrySeed.js +5 -6
- package/dist/core/Expr.d.ts +11 -0
- package/dist/core/Field.d.ts +39 -3
- package/dist/core/Field.js +25 -2
- package/dist/core/Filter.d.ts +31 -1
- package/dist/core/Filter.js +5 -0
- package/dist/core/Graph.d.ts +36 -8
- package/dist/core/Infer.d.ts +17 -0
- package/dist/core/Internal.d.ts +3 -0
- package/dist/core/Internal.js +4 -0
- package/dist/core/Overview.d.ts +315 -0
- package/dist/core/Overview.js +48 -0
- package/dist/core/Role.d.ts +6 -1
- package/dist/core/Role.js +55 -53
- package/dist/core/Root.d.ts +32 -3
- package/dist/core/Root.js +17 -7
- package/dist/core/Schema.js +7 -2
- package/dist/core/Scope.d.ts +14 -0
- package/dist/core/Scope.js +88 -10
- package/dist/core/TextDoc.d.ts +14 -1
- package/dist/core/Type.d.ts +71 -11
- package/dist/core/Type.js +67 -17
- package/dist/core/Validation.d.ts +60 -0
- package/dist/core/Validation.js +116 -0
- package/dist/core/Workspace.d.ts +1 -0
- package/dist/core/Workspace.js +5 -1
- package/dist/core/db/EntryReference.d.ts +8 -1
- package/dist/core/db/LinkResolver.d.ts +3 -0
- package/dist/core/db/LocalStore.d.ts +19 -0
- package/dist/core/db/Operation.d.ts +28 -1
- package/dist/core/db/Operation.js +161 -25
- package/dist/core/db/SyncStats.d.ts +16 -0
- package/dist/core/db/SyncStats.js +56 -0
- package/dist/core/db/WriteableGraph.d.ts +6 -14
- package/dist/core/db/WriteableGraph.js +5 -3
- package/dist/core/field/CreateField.d.ts +2 -3
- package/dist/core/field/ListField.js +29 -10
- package/dist/core/field/RecordField.js +12 -4
- package/dist/core/field/RichTextField.js +81 -24
- package/dist/core/field/ScalarField.d.ts +2 -2
- package/dist/core/field/UnionField.js +27 -4
- package/dist/core/media/CompressPdf.browser.d.ts +5 -0
- package/dist/core/media/CompressPdf.browser.js +13 -0
- package/dist/core/media/CompressPdf.d.ts +6 -0
- package/dist/core/media/CompressPdf.js +45 -0
- package/dist/core/media/CreatePreview.browser.d.ts +5 -1
- package/dist/core/media/CreatePreview.browser.js +16 -0
- package/dist/core/media/CreatePreview.d.ts +2 -1
- package/dist/core/media/CreatePreview.js +2 -0
- package/dist/core/media/FileAccept.d.ts +7 -0
- package/dist/core/media/FileAccept.js +29 -0
- package/dist/core/media/FileKinds.d.ts +10 -0
- package/dist/core/media/FileKinds.js +25 -0
- package/dist/core/media/ImageTransform.d.ts +78 -0
- package/dist/core/media/ImageTransform.js +108 -0
- package/dist/core/media/MediaRoot.js +4 -4
- package/dist/core/media/MediaTypes.d.ts +137 -9
- package/dist/core/media/MediaTypes.js +277 -51
- package/dist/core/media/Pdf.d.ts +15 -0
- package/dist/core/media/Pdf.js +31 -0
- package/dist/core/media/Summary.d.ts +9 -9
- package/dist/core/media/Summary.js +10 -10
- package/dist/core/media/TransformImage.browser.d.ts +7 -0
- package/dist/core/media/TransformImage.browser.js +38 -0
- package/dist/core/media/TransformImage.d.ts +7 -0
- package/dist/core/media/TransformImage.js +38 -0
- package/dist/core/source/GithubSource.d.ts +4 -0
- package/dist/core/source/GithubSource.js +127 -25
- package/dist/core/source/GithubUsage.d.ts +21 -0
- package/dist/core/source/GithubUsage.js +47 -0
- package/dist/core/source/Source.d.ts +2 -0
- package/dist/core/source/Source.js +11 -0
- package/dist/core/text/MarkdownToTextDoc.d.ts +29 -0
- package/dist/core/text/MarkdownToTextDoc.js +524 -0
- package/dist/core/text/TextDocToMarkdown.d.ts +20 -0
- package/dist/core/text/TextDocToMarkdown.js +316 -0
- package/dist/core/util/Async.d.ts +2 -0
- package/dist/core/util/Async.js +12 -1
- package/dist/core/util/Checks.js +1 -1
- package/dist/core/util/JWT.d.ts +1 -1
- package/dist/core/util/Objects.d.ts +2 -0
- package/dist/core/util/Objects.js +7 -0
- package/dist/core/util/OrderKeys.d.ts +11 -0
- package/dist/core/util/OrderKeys.js +64 -0
- package/dist/core/util/Slugs.js +4 -3
- package/dist/core.d.ts +3 -0
- package/dist/core.js +8 -1
- package/dist/dashboard/App.css +56 -86
- package/dist/dashboard/App.d.ts +6 -2
- package/dist/dashboard/App.js +41 -20
- package/dist/dashboard/Href.d.ts +37 -0
- package/dist/dashboard/Href.js +46 -0
- package/dist/dashboard/ViewKeys.d.ts +2 -0
- package/dist/dashboard/ViewKeys.js +2 -0
- package/dist/dashboard/app/AccessDenied.js +26 -18
- package/dist/dashboard/app/ActivityStatus.d.ts +5 -4
- package/dist/dashboard/app/ActivityStatus.js +138 -153
- package/dist/dashboard/app/AppearanceToggle.js +31 -12
- package/dist/dashboard/app/AuthView.js +75 -63
- package/dist/dashboard/app/BlockSheet.d.ts +50 -0
- package/dist/dashboard/app/BlockSheet.js +207 -0
- package/dist/dashboard/app/BlockSheetStoryFrame.d.ts +6 -0
- package/dist/dashboard/app/BlockSheetStoryFrame.js +29 -0
- package/dist/dashboard/app/BlockTabs.d.ts +12 -0
- package/dist/dashboard/app/BlockTabs.js +26 -0
- package/dist/dashboard/app/CompactField.d.ts +19 -6
- package/dist/dashboard/app/CompactField.js +177 -50
- package/dist/dashboard/app/CroppedImage.d.ts +17 -0
- package/dist/dashboard/app/CroppedImage.js +73 -0
- package/dist/dashboard/app/DashboardErrorBoundary.js +27 -15
- package/dist/dashboard/app/DashboardLayout.d.ts +5 -3
- package/dist/dashboard/app/DashboardLayout.js +59 -37
- package/dist/dashboard/app/EntryActions.d.ts +11 -0
- package/dist/dashboard/app/EntryActions.js +30 -0
- package/dist/dashboard/app/EntryFields.d.ts +26 -13
- package/dist/dashboard/app/EntryFields.js +19 -9
- package/dist/dashboard/app/EntryForm.d.ts +6 -0
- package/dist/dashboard/app/EntryForm.js +28 -0
- package/dist/dashboard/app/EntryHeader.d.ts +2 -2
- package/dist/dashboard/app/EntryHeader.js +226 -144
- package/dist/dashboard/app/EntryHeaderActions.d.ts +4 -1
- package/dist/dashboard/app/EntryHeaderActions.js +8 -12
- package/dist/dashboard/app/EntryReferences.d.ts +13 -1
- package/dist/dashboard/app/EntryReferences.js +62 -55
- package/dist/dashboard/app/EntrySidebar.d.ts +7 -5
- package/dist/dashboard/app/EntrySidebar.js +104 -98
- package/dist/dashboard/app/EntrySidebarPreview.d.ts +4 -1
- package/dist/dashboard/app/EntrySidebarPreview.js +37 -106
- package/dist/dashboard/app/EntrySidebarToggle.js +5 -6
- package/dist/dashboard/app/EntryStatusIcon.d.ts +23 -0
- package/dist/dashboard/app/EntryStatusIcon.js +58 -0
- package/dist/dashboard/app/EntryTranslationBanner.js +37 -45
- package/dist/dashboard/app/EntryValidationModal.d.ts +13 -0
- package/dist/dashboard/app/EntryValidationModal.js +77 -0
- package/dist/dashboard/app/Explorer.d.ts +15 -6
- package/dist/dashboard/app/Explorer.js +276 -520
- package/dist/dashboard/app/ExplorerBatchActions.d.ts +19 -0
- package/dist/dashboard/app/ExplorerBatchActions.js +183 -0
- package/dist/dashboard/app/ExplorerBreadcrumbs.d.ts +13 -0
- package/dist/dashboard/app/ExplorerBreadcrumbs.js +119 -0
- package/dist/dashboard/app/ExplorerCards.d.ts +8 -3
- package/dist/dashboard/app/ExplorerCards.js +91 -289
- package/dist/dashboard/app/ExplorerControls.d.ts +20 -0
- package/dist/dashboard/app/ExplorerControls.js +170 -0
- package/dist/dashboard/app/ExplorerList.d.ts +7 -4
- package/dist/dashboard/app/ExplorerList.js +160 -95
- package/dist/dashboard/app/ExplorerModal.d.ts +2 -5
- package/dist/dashboard/app/ExplorerModal.js +7 -19
- package/dist/dashboard/app/ExplorerOverviewHeader.d.ts +6 -0
- package/dist/dashboard/app/ExplorerOverviewHeader.js +28 -0
- package/dist/dashboard/app/ExplorerPickerContent.d.ts +19 -3
- package/dist/dashboard/app/ExplorerPickerContent.js +87 -5
- package/dist/dashboard/app/ExplorerScope.d.ts +7 -0
- package/dist/dashboard/app/ExplorerScope.js +159 -0
- package/dist/dashboard/app/ExplorerTable.d.ts +8 -4
- package/dist/dashboard/app/ExplorerTable.js +150 -359
- package/dist/dashboard/app/ExplorerTabs.d.ts +12 -0
- package/dist/dashboard/app/ExplorerTabs.js +42 -0
- package/dist/dashboard/app/ExternalLinkPicker.js +45 -55
- package/dist/dashboard/app/FileKind.d.ts +8 -0
- package/dist/dashboard/app/FileKind.js +40 -0
- package/dist/dashboard/app/ImageEditor.d.ts +13 -0
- package/dist/dashboard/app/ImageEditor.js +302 -0
- package/dist/dashboard/app/ImageEditorCrop.d.ts +19 -0
- package/dist/dashboard/app/ImageEditorCrop.js +90 -0
- package/dist/dashboard/app/ImagePicker.d.ts +1 -1
- package/dist/dashboard/app/ImagePicker.js +30 -89
- package/dist/dashboard/app/LinkPicker.d.ts +1 -1
- package/dist/dashboard/app/LinkPicker.js +108 -126
- package/dist/dashboard/app/LocaleMenu.d.ts +4 -2
- package/dist/dashboard/app/LocaleMenu.js +59 -48
- package/dist/dashboard/app/MediaPreviewCell.d.ts +8 -0
- package/dist/dashboard/app/MediaPreviewCell.js +50 -0
- package/dist/dashboard/app/MoveConfirmDialog.d.ts +5 -0
- package/dist/dashboard/app/MoveConfirmDialog.js +79 -0
- package/dist/dashboard/app/MoveDialog.d.ts +10 -0
- package/dist/dashboard/app/MoveDialog.js +161 -0
- package/dist/dashboard/app/NodeEditor.d.ts +11 -0
- package/dist/dashboard/app/NodeEditor.js +13 -0
- package/dist/dashboard/app/OverviewCell.d.ts +15 -0
- package/dist/dashboard/app/OverviewCell.js +249 -0
- package/dist/dashboard/app/PendingUploadsDialog.d.ts +2 -0
- package/dist/dashboard/app/PendingUploadsDialog.js +49 -0
- package/dist/dashboard/app/PendingUploadsView.d.ts +20 -0
- package/dist/dashboard/app/PendingUploadsView.js +233 -0
- package/dist/dashboard/app/ReadOnlyBadge.d.ts +1 -1
- package/dist/dashboard/app/ReadOnlyBadge.js +1 -1
- package/dist/dashboard/app/RemoveDialog.d.ts +17 -0
- package/dist/dashboard/app/RemoveDialog.js +294 -0
- package/dist/dashboard/app/RemoveRedirect.d.ts +7 -0
- package/dist/dashboard/app/RemoveRedirect.js +123 -0
- package/dist/dashboard/app/SearchBar.d.ts +9 -0
- package/dist/dashboard/app/SearchBar.js +31 -0
- package/dist/dashboard/app/SidebarLayout.d.ts +2 -1
- package/dist/dashboard/app/SidebarLayout.js +28 -1133
- package/dist/dashboard/app/SidebarTree.d.ts +12 -6
- package/dist/dashboard/app/SidebarTree.js +220 -295
- package/dist/dashboard/app/ViewToggle.d.ts +1 -1
- package/dist/dashboard/app/ViewToggle.js +17 -10
- package/dist/dashboard/app/WorkspaceMenu.d.ts +5 -6
- package/dist/dashboard/app/WorkspaceMenu.js +76 -111
- package/dist/dashboard/app/WorkspaceRoots.d.ts +2 -4
- package/dist/dashboard/app/WorkspaceRoots.js +144 -172
- package/dist/dashboard/app/editor/FileEditor.js +161 -125
- package/dist/dashboard/app/editor/FilePreview.d.ts +8 -6
- package/dist/dashboard/app/editor/FilePreview.js +16 -143
- package/dist/dashboard/app/editor/MediaAltField.view.js +5 -5
- package/dist/dashboard/app/modals/CreateEntry.js +98 -106
- package/dist/dashboard/app/pages/EntryPage.d.ts +2 -1
- package/dist/dashboard/app/pages/EntryPage.js +139 -97
- package/dist/dashboard/app/pages/RootPage.js +4 -6
- package/dist/dashboard/app/pages/SplashPage.d.ts +19 -0
- package/dist/dashboard/app/pages/SplashPage.js +208 -193
- package/dist/dashboard/app/pages/UsersPage.d.ts +20 -1
- package/dist/dashboard/app/pages/UsersPage.js +182 -255
- package/dist/dashboard/app/ui/DashboardModal.d.ts +18 -12
- package/dist/dashboard/app/ui/DashboardModal.js +54 -69
- package/dist/dashboard/atoms/ReactiveNode.js +58 -19
- package/dist/dashboard/atoms/activity.d.ts +1 -0
- package/dist/dashboard/atoms/activity.js +8 -5
- package/dist/dashboard/atoms/auth.js +2 -2
- package/dist/dashboard/atoms/config.d.ts +5 -1
- package/dist/dashboard/atoms/core.d.ts +16 -2
- package/dist/dashboard/atoms/core.js +19 -7
- package/dist/dashboard/atoms/create.js +15 -14
- package/dist/dashboard/atoms/dashboard.d.ts +16 -0
- package/dist/dashboard/atoms/dashboard.js +11 -1
- package/dist/dashboard/atoms/editor.d.ts +7 -1
- package/dist/dashboard/atoms/editor.js +29 -42
- package/dist/dashboard/atoms/entry.d.ts +32 -42
- package/dist/dashboard/atoms/entry.js +240 -182
- package/dist/dashboard/atoms/entryTable.d.ts +10 -0
- package/dist/dashboard/atoms/entryTable.js +43 -0
- package/dist/dashboard/atoms/explorer.d.ts +212 -36
- package/dist/dashboard/atoms/explorer.js +597 -259
- package/dist/dashboard/atoms/graph.d.ts +5 -0
- package/dist/dashboard/atoms/graph.js +27 -2
- package/dist/dashboard/atoms/link.d.ts +2 -0
- package/dist/dashboard/atoms/link.js +11 -5
- package/dist/dashboard/atoms/move.d.ts +64 -0
- package/dist/dashboard/atoms/move.js +128 -0
- package/dist/dashboard/atoms/moveConfirmation.d.ts +34 -0
- package/dist/dashboard/atoms/moveConfirmation.js +95 -0
- package/dist/dashboard/atoms/nav.d.ts +36 -12
- package/dist/dashboard/atoms/nav.js +280 -53
- package/dist/dashboard/atoms/overview.d.ts +228 -0
- package/dist/dashboard/atoms/overview.js +519 -0
- package/dist/dashboard/atoms/remove.d.ts +112 -0
- package/dist/dashboard/atoms/remove.js +268 -0
- package/dist/dashboard/atoms/root.d.ts +44 -22
- package/dist/dashboard/atoms/root.js +294 -164
- package/dist/dashboard/atoms/upload.d.ts +105 -3
- package/dist/dashboard/atoms/upload.js +266 -11
- package/dist/dashboard/atoms/user.js +1 -1
- package/dist/dashboard/atoms/utils.d.ts +12 -4
- package/dist/dashboard/atoms/utils.js +35 -2
- package/dist/dashboard/boot/ActivityEvent.d.ts +1 -1
- package/dist/dashboard/boot/Boot.d.ts +2 -0
- package/dist/dashboard/boot/Boot.js +33 -18
- package/dist/dashboard/boot/BootDev.js +13 -10
- package/dist/dashboard/boot/BootProd.d.ts +6 -1
- package/dist/dashboard/boot/BootProd.js +3 -2
- package/dist/dashboard/boot/DashboardWorker.d.ts +7 -0
- package/dist/dashboard/boot/DashboardWorker.js +108 -24
- package/dist/dashboard/boot/LoadWorker.js +21 -11
- package/dist/dashboard/boot/SyncEvent.d.ts +7 -0
- package/dist/dashboard/boot/SyncEvent.js +14 -0
- package/dist/dashboard/boot/WorkerDB.d.ts +1 -0
- package/dist/dashboard/boot/WorkerDB.js +3 -0
- package/dist/dashboard/cms/EntryTable.d.ts +56 -0
- package/dist/dashboard/cms/EntryTable.js +273 -0
- package/dist/dashboard/cms/FieldChrome.d.ts +21 -0
- package/dist/dashboard/cms/FieldChrome.js +26 -0
- package/dist/dashboard/cms/ViewProps.d.ts +42 -0
- package/dist/dashboard/cms/ViewProps.js +0 -0
- package/dist/dashboard/cms/hooks.d.ts +120 -0
- package/dist/dashboard/cms/hooks.js +132 -0
- package/dist/dashboard/contexts.d.ts +59 -0
- package/dist/dashboard/contexts.js +43 -0
- package/dist/dashboard/editor/UseField.d.ts +29 -6
- package/dist/dashboard/fixture/cms.d.ts +2 -2
- package/dist/dashboard/hook/UseEntryEditor.d.ts +4 -1
- package/dist/dashboard/hook/UseEntryEditor.js +7 -3
- package/dist/dashboard/hook/UseGraph.d.ts +3 -1
- package/dist/dashboard/hook/UseLocale.d.ts +3 -1
- package/dist/dashboard/hook/UseRoot.d.ts +3 -1
- package/dist/dashboard/hook/UseSearchShortcut.d.ts +11 -0
- package/dist/dashboard/hook/UseSearchShortcut.js +32 -0
- package/dist/dashboard/hook/UseWorkspace.d.ts +3 -1
- package/dist/dashboard/hooks.d.ts +16 -98
- package/dist/dashboard/hooks.js +15 -90
- package/dist/dashboard/icons.d.ts +11 -0
- package/dist/dashboard/icons.js +125 -0
- package/dist/dashboard.d.ts +23 -1
- package/dist/dashboard.js +5 -2
- package/dist/database/BrowserEntryStore.d.ts +17 -24
- package/dist/database/BrowserEntryStore.js +139 -137
- package/dist/database/DatabaseTables.js +2 -2
- package/dist/database/EntryDatabase.d.ts +15 -1
- package/dist/database/EntryDatabase.js +61 -10
- package/dist/database/EntryStore.js +32 -20
- package/dist/database/EntryTransaction.d.ts +0 -5
- package/dist/database/EntryTransaction.js +173 -58
- package/dist/database/EntryUrlAliases.d.ts +4 -0
- package/dist/database/EntryUrlAliases.js +16 -10
- package/dist/database/Version.d.ts +2 -2
- package/dist/database/Version.js +1 -1
- package/dist/database/driver/RuntimeDatabase.js +3 -3
- package/dist/database/driver/WasmDatabase.d.ts +5 -18
- package/dist/database/driver/WasmDatabase.js +16 -15
- package/dist/database/entry/EntryTable.d.ts +5 -3
- package/dist/database/entry/EntryTable.js +34 -10
- package/dist/database/query/Condition.d.ts +9 -1
- package/dist/database/query/Condition.js +25 -6
- package/dist/database/query/EntryQuery.d.ts +4 -0
- package/dist/database/query/EntryQuery.js +148 -25
- package/dist/database/query/EntryReferences.d.ts +1 -1
- package/dist/database/query/EntryReferences.js +3 -2
- package/dist/database/query/Relation.d.ts +13 -1
- package/dist/database/query/Relation.js +33 -5
- package/dist/database/query/ResolveQuery.d.ts +1 -1
- package/dist/database/query/ResolveQuery.js +27 -18
- package/dist/database/query/Search.d.ts +10 -1
- package/dist/database/query/Search.js +83 -10
- package/dist/database/sync/Derive.d.ts +2 -1
- package/dist/database/sync/Derive.js +15 -10
- package/dist/database/sync/EntryParser.js +8 -7
- package/dist/database/sync/EntrySyncer.d.ts +3 -0
- package/dist/database/sync/EntrySyncer.js +10 -7
- package/dist/database/sync/Ingest.d.ts +2 -1
- package/dist/database/sync/Ingest.js +79 -49
- package/dist/database/sync/SyncQueries.d.ts +3 -2
- package/dist/database/sync/SyncQueries.js +19 -19
- package/dist/field/check/CheckField.js +3 -1
- package/dist/field/check/CheckField.view.js +13 -11
- package/dist/field/code/CodeField.d.ts +9 -0
- package/dist/field/code/CodeField.view.d.ts +3 -1
- package/dist/field/code/CodeField.view.js +30 -20
- package/dist/field/code/SimpleCodeEditor.js +0 -18
- package/dist/field/date/DateField.view.js +9 -25
- package/dist/field/link/EntryLink.d.ts +8 -9
- package/dist/field/link/FileLink.d.ts +11 -8
- package/dist/field/link/FileLink.js +7 -6
- package/dist/field/link/ImageLink.d.ts +16 -16
- package/dist/field/link/ImageLink.js +14 -23
- package/dist/field/link/Link.d.ts +1 -1
- package/dist/field/link/Link.js +2 -2
- package/dist/field/link/LinkField.d.ts +10 -5
- package/dist/field/link/LinkField.js +2 -0
- package/dist/field/link/LinkField.view.js +501 -684
- package/dist/field/link/UrlLink.d.ts +5 -4
- package/dist/field/link.d.ts +1 -0
- package/dist/field/list/ListField.d.ts +9 -5
- package/dist/field/list/ListField.js +10 -5
- package/dist/field/list/ListField.view.d.ts +15 -0
- package/dist/field/list/ListField.view.js +525 -645
- package/dist/field/localiser/LocalisedField.view.js +37 -88
- package/dist/field/localiser/LocalisedFieldTab.d.ts +7 -0
- package/dist/field/localiser/LocalisedFieldTab.js +30 -0
- package/dist/field/localiser/LocalisedFieldTabs.js +5 -5
- package/dist/field/localiser/Localiser.d.ts +17 -1
- package/dist/field/localiser/Localiser.js +152 -7
- package/dist/field/localiser/SelectLocale.d.ts +5 -0
- package/dist/field/localiser/SelectLocale.js +12 -0
- package/dist/field/metadata/MetadataAudit.d.ts +39 -0
- package/dist/field/metadata/MetadataAudit.js +124 -0
- package/dist/field/metadata/MetadataField.d.ts +20 -30
- package/dist/field/metadata/MetadataField.js +24 -107
- package/dist/field/metadata/MetadataField.view.d.ts +1 -0
- package/dist/field/metadata/MetadataField.view.js +36 -38
- package/dist/field/number/NumberField.view.js +9 -9
- package/dist/field/object/ObjectField.d.ts +3 -1
- package/dist/field/object/ObjectField.view.js +35 -25
- package/dist/field/path/PathField.view.js +3 -3
- package/dist/field/path/SlugField.d.ts +1 -2
- package/dist/field/path/SlugField.js +5 -7
- package/dist/field/richtext/PickTextAnchor.js +10 -10
- package/dist/field/richtext/PickTextLink.js +28 -41
- package/dist/field/richtext/RichTextBlock.d.ts +3 -1
- package/dist/field/richtext/RichTextBlock.js +190 -78
- package/dist/field/richtext/RichTextBlockHost.js +1 -1
- package/dist/field/richtext/RichTextExtensions.js +26 -20
- package/dist/field/richtext/RichTextField.story.d.ts +1 -0
- package/dist/field/richtext/RichTextField.view.js +13 -6
- package/dist/field/richtext/RichTextInsertMenu.js +59 -36
- package/dist/field/richtext/RichTextToolbar.js +82 -34
- package/dist/field/richtext/Toolbar.d.ts +9 -1
- package/dist/field/richtext/Toolbar.js +12 -2
- package/dist/field/richtext.d.ts +2 -0
- package/dist/field/richtext.js +2 -0
- package/dist/field/select/SelectField.view.js +15 -79
- package/dist/field/tabs/Tabs.d.ts +12 -3
- package/dist/field/tabs/Tabs.js +11 -2
- package/dist/field/tabs/Tabs.view.js +8 -8
- package/dist/field/text/TextField.view.js +9 -8
- package/dist/field/time/TimeField.view.js +10 -18
- package/dist/field/views.js +4 -0
- package/dist/field.d.ts +2 -2
- package/dist/field.js +3 -2
- package/dist/index.css +5408 -5223
- package/dist/index.d.ts +1 -0
- package/dist/index.js +3 -1
- package/dist/next.cjs +27 -20
- package/dist/next.d.ts +2 -0
- package/dist/next.edge.d.ts +2 -0
- package/dist/picker/entry/EntryPicker.d.ts +11 -4
- package/dist/picker/entry/EntryPicker.js +15 -1
- package/dist/picker/url/UrlPicker.js +1 -0
- package/dist/preview/react.js +3 -0
- package/dist/preview/widget.d.ts +3 -0
- package/dist/preview/widget.js +26 -8
- package/dist/query.d.ts +41 -266
- package/dist/query.js +4 -0
- package/dist/types.d.ts +12 -5
- package/dist/ui/RichText.js +31 -1
- package/dist/ui/Stack.d.ts +4 -2
- package/docs/ai-agents.md +316 -0
- package/docs/ai-setup.md +297 -0
- package/docs/cli.md +96 -0
- package/docs/components/alert.md +122 -0
- package/docs/components/app-shell.md +77 -0
- package/docs/components/badge.md +89 -0
- package/docs/components/blockquote.md +24 -0
- package/docs/components/breadcrumb.md +83 -0
- package/docs/components/button.md +142 -0
- package/docs/components/calendar.md +32 -0
- package/docs/components/checkbox-group.md +38 -0
- package/docs/components/checkbox.md +61 -0
- package/docs/components/code.md +37 -0
- package/docs/components/collapsible.md +53 -0
- package/docs/components/color-swatch-picker.md +47 -0
- package/docs/components/combo-box.md +146 -0
- package/docs/components/command.md +101 -0
- package/docs/components/content-card.md +64 -0
- package/docs/components/content-grid.md +71 -0
- package/docs/components/data-list.md +64 -0
- package/docs/components/date-field.md +34 -0
- package/docs/components/date-picker.md +35 -0
- package/docs/components/date-range-picker.md +34 -0
- package/docs/components/dialog.md +233 -0
- package/docs/components/drop-zone.md +45 -0
- package/docs/components/dropdown-menu.md +223 -0
- package/docs/components/empty.md +81 -0
- package/docs/components/field.md +66 -0
- package/docs/components/file-trigger.md +33 -0
- package/docs/components/fold-icon.md +34 -0
- package/docs/components/form.md +67 -0
- package/docs/components/heading.md +33 -0
- package/docs/components/icon.md +43 -0
- package/docs/components/kbd.md +29 -0
- package/docs/components/link.md +45 -0
- package/docs/components/list.md +105 -0
- package/docs/components/media-preview.md +43 -0
- package/docs/components/multiple-select.md +48 -0
- package/docs/components/nav-rail.md +79 -0
- package/docs/components/number-field.md +53 -0
- package/docs/components/page.md +97 -0
- package/docs/components/popover.md +71 -0
- package/docs/components/preview-frame.md +63 -0
- package/docs/components/radio-group.md +47 -0
- package/docs/components/resizable-panel-group.md +63 -0
- package/docs/components/search-field.md +54 -0
- package/docs/components/select.md +127 -0
- package/docs/components/sidebar.md +104 -0
- package/docs/components/sortable-list.md +110 -0
- package/docs/components/spinner.md +29 -0
- package/docs/components/stack.md +42 -0
- package/docs/components/surface.md +54 -0
- package/docs/components/switch.md +52 -0
- package/docs/components/table.md +262 -0
- package/docs/components/tabs.md +120 -0
- package/docs/components/tag-group.md +56 -0
- package/docs/components/text-field.md +142 -0
- package/docs/components/text.md +44 -0
- package/docs/components/time-field.md +41 -0
- package/docs/components/timestamp.md +45 -0
- package/docs/components/toggle-group.md +46 -0
- package/docs/components/toggle.md +37 -0
- package/docs/components/toolbar.md +96 -0
- package/docs/components/tooltip.md +78 -0
- package/docs/components/tree.md +67 -0
- package/docs/components.md +169 -0
- package/docs/configuration.md +177 -0
- package/docs/content-model.md +87 -0
- package/docs/custom-fields.md +359 -0
- package/docs/dashboard-ui.md +3 -0
- package/docs/deploy/alinea-cloud.md +26 -0
- package/docs/deploy/self-host.md +195 -0
- package/docs/deploy.md +127 -0
- package/docs/editing-content.md +195 -0
- package/docs/fields/check.md +40 -0
- package/docs/fields/code.md +35 -0
- package/docs/fields/date.md +90 -0
- package/docs/fields/entry.md +179 -0
- package/docs/fields/file.md +60 -0
- package/docs/fields/image.md +138 -0
- package/docs/fields/link.md +121 -0
- package/docs/fields/list.md +149 -0
- package/docs/fields/number.md +58 -0
- package/docs/fields/object.md +93 -0
- package/docs/fields/path.md +105 -0
- package/docs/fields/rich-text.md +267 -0
- package/docs/fields/select.md +99 -0
- package/docs/fields/tabs.md +111 -0
- package/docs/fields/text.md +46 -0
- package/docs/fields/url.md +51 -0
- package/docs/fields.md +231 -0
- package/docs/get-started.md +3 -0
- package/docs/guides.md +3 -0
- package/docs/index.md +140 -0
- package/docs/instant-publishing.md +61 -0
- package/docs/internationalization.md +218 -0
- package/docs/introduction.md +5 -0
- package/docs/live-previews.md +151 -0
- package/docs/mcp.md +500 -0
- package/docs/overviews.md +580 -0
- package/docs/query/advanced.md +123 -0
- package/docs/query/examples.md +231 -0
- package/docs/query/filtering.md +162 -0
- package/docs/query/related.md +178 -0
- package/docs/query/structural.md +165 -0
- package/docs/query.md +190 -0
- package/docs/quickstart.md +203 -0
- package/docs/reference.md +3 -0
- package/docs/roles-permissions.md +234 -0
- package/docs/schema/document.md +100 -0
- package/docs/schema/type.md +133 -0
- package/docs/schema.md +66 -0
- package/docs/tutorial/step-1-landing-page.md +244 -0
- package/docs/tutorial/step-2-block-list.md +364 -0
- package/docs/tutorial/step-3-layout-root.md +200 -0
- package/docs/tutorial/step-4-blog.md +384 -0
- package/docs/tutorial/step-5-catch-all.md +222 -0
- package/docs/tutorial.md +21 -0
- package/docs/typescript.md +115 -0
- package/docs/upgrading.md +368 -0
- package/docs/workspaces/media.md +134 -0
- package/docs/workspaces/root.md +127 -0
- package/docs/workspaces.md +98 -0
- package/llms-full.txt +13007 -3217
- package/package.json +25 -6
- package/readme.md +136 -55
- package/dist/adapter/next/previews.spec.d.ts +0 -1
- package/dist/chunks/chunk-AC4U3IMS.js +0 -205
- package/dist/chunks/chunk-DNJX6CRV.js +0 -129
- package/dist/chunks/chunk-NIVGVRDS.js +0 -6363
- package/dist/chunks/chunk-S4AU6SRS.js +0 -5503
- package/dist/chunks/chunk-SJBZFMQ2.js +0 -2966
- package/dist/components/Disclosure.d.ts +0 -5
- package/dist/components/Disclosure.js +0 -106
- package/dist/components/Label.d.ts +0 -48
- package/dist/components/Label.js +0 -210
- package/dist/components/Menu.d.ts +0 -16
- package/dist/components/Menu.js +0 -95
- package/dist/components/Modal.d.ts +0 -7
- package/dist/components/Modal.js +0 -58
- package/dist/components/ProgressCircle.d.ts +0 -6
- package/dist/components/ProgressCircle.js +0 -96
- package/dist/dashboard/app/AppShell.d.ts +0 -4
- package/dist/dashboard/app/AppShell.js +0 -29
- package/dist/dashboard/app/Badge.d.ts +0 -8
- package/dist/dashboard/app/Badge.js +0 -42
- package/dist/dashboard/app/EditorBackButton.d.ts +0 -5
- package/dist/dashboard/app/EditorBackButton.js +0 -33
- package/dist/dashboard/app/EntrySidebarPreview.spec.d.ts +0 -1
- package/dist/dashboard/app/ExplorerFileCard.d.ts +0 -10
- package/dist/dashboard/app/ExplorerFileCard.js +0 -115
- package/dist/dashboard/app/StatusBadge.d.ts +0 -6
- package/dist/dashboard/app/StatusBadge.js +0 -26
- package/dist/dashboard/app/WorkspaceMenu.spec.d.ts +0 -1
- package/dist/dashboard/app/WorkspaceMenu.stories.d.ts +0 -7
- package/dist/dashboard/app/ui/Rail.d.ts +0 -18
- package/dist/dashboard/app/ui/Rail.js +0 -41
- package/dist/dashboard/app/ui/Sidebar.d.ts +0 -15
- package/dist/dashboard/app/ui/Sidebar.js +0 -55
- package/dist/field/link/LinkField.spec.d.ts +0 -1
- package/dist/field/link/LinkField.stories.d.ts +0 -15
- package/dist/field/list/ListField.spec.d.ts +0 -1
- package/dist/field/list/ListField.stories.d.ts +0 -7
- package/dist/field/richtext/RichTextField.spec.d.ts +0 -1
- package/dist/chunks/{chunk-MOWR65LM.js → chunk-PYDOMKJZ.js} +71 -71
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
# Entry
|
|
2
|
+
|
|
3
|
+
An entry field links to other entries in the CMS: the author of a post, related articles, the categories of a product. Editors pick entries in a dialog, and you can limit what they can choose.
|
|
4
|
+
|
|
5
|
+
```tsx
|
|
6
|
+
import {Field} from 'alinea'
|
|
7
|
+
|
|
8
|
+
Field.entry('Author', {
|
|
9
|
+
condition: {_type: 'Author'}
|
|
10
|
+
})
|
|
11
|
+
|
|
12
|
+
Field.entry.multiple('Related posts', {
|
|
13
|
+
condition: {_type: 'BlogPost'},
|
|
14
|
+
max: 3
|
|
15
|
+
})
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Options
|
|
19
|
+
|
|
20
|
+
- `condition`: only offer entries that match this [filter](../query/filtering.md). The picker then shows all matches in one flat list, across locations. Can be a function, see below.
|
|
21
|
+
- `location`: the workspace and root (and optionally `parentId` and `locale`) the picker opens in, for example `{workspace: 'main', root: 'pages'}`. Can be a function.
|
|
22
|
+
- `limitLocations`: an array of `{workspace, root}` locations editors can browse. Others are hidden in the picker.
|
|
23
|
+
- `pickChildren`: offer only the direct children of the entry being edited, in a flat list.
|
|
24
|
+
- `defaultView`: show the picker's results as `'row'` (default) or `'thumb'`.
|
|
25
|
+
- `fields`: extra fields stored on each link, like the [Link field](link.md).
|
|
26
|
+
- `max` (multiple only): the maximum number of entries.
|
|
27
|
+
- `allowDuplicates` (multiple only): allow the same entry more than once. Default `false`.
|
|
28
|
+
- The [common options](../fields.md) `help`, `width`, `inline`, `initialValue`, `required`, `validate`, `readOnly`, `hidden` and `shared`.
|
|
29
|
+
|
|
30
|
+
## Conditions
|
|
31
|
+
|
|
32
|
+
A condition is a [filter](../query/filtering.md) on the entries that can be picked, written with the `_` prefixed entry properties: `_type`, `_workspace`, `_root`, `_parentId`, `_status`, `_locale`, `_path` and `_url`. It can also filter on the fields of those entries, such as `{_type: 'BlogPost', category: 'news'}`. All operators work, such as `in` and `startsWith`:
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
import {Field} from 'alinea'
|
|
36
|
+
|
|
37
|
+
// One type
|
|
38
|
+
Field.entry('Author', {condition: {_type: 'Author'}})
|
|
39
|
+
|
|
40
|
+
// Several types
|
|
41
|
+
Field.entry('Parent page', {
|
|
42
|
+
condition: {_type: {in: ['Page', 'Blog']}}
|
|
43
|
+
})
|
|
44
|
+
|
|
45
|
+
// Only posts below /blog in the pages root
|
|
46
|
+
Field.entry.multiple('Highlights', {
|
|
47
|
+
condition: {_type: 'BlogPost', _root: 'pages', _url: {startsWith: '/blog/'}}
|
|
48
|
+
})
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Where the picker opens
|
|
52
|
+
|
|
53
|
+
Without a `condition`, editors browse the content tree in the picker, starting in the root of the entry being edited. `location` sets another starting point: a workspace and root, optionally with a `parentId` to open inside a specific entry, and a `locale`. `limitLocations` lists the workspace and root pairs editors can switch to. Without it, they can browse every workspace and root.
|
|
54
|
+
|
|
55
|
+
```tsx
|
|
56
|
+
import {Field} from 'alinea'
|
|
57
|
+
|
|
58
|
+
declare const blogId: string
|
|
59
|
+
|
|
60
|
+
// Open the picker below the blog entry
|
|
61
|
+
Field.entry('Related post', {
|
|
62
|
+
location: {workspace: 'main', root: 'pages', parentId: blogId}
|
|
63
|
+
})
|
|
64
|
+
|
|
65
|
+
// Only let editors browse the pages roots of two workspaces
|
|
66
|
+
Field.entry('Page', {
|
|
67
|
+
location: {workspace: 'main', root: 'pages'},
|
|
68
|
+
limitLocations: [
|
|
69
|
+
{workspace: 'main', root: 'pages'},
|
|
70
|
+
{workspace: 'docs', root: 'pages'}
|
|
71
|
+
]
|
|
72
|
+
})
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
With a `condition`, the picker shows a flat list of the matching entries instead of the tree. Without a `location`, that list covers every workspace and root. With a `location`, it starts in that workspace and root, and when you set a `parentId` it only lists entries below that entry.
|
|
76
|
+
|
|
77
|
+
A `location` outside `limitLocations` isn't used: the picker opens in the first allowed location of the same workspace instead, or else the first one in the list.
|
|
78
|
+
|
|
79
|
+
## Combining the options
|
|
80
|
+
|
|
81
|
+
Each option restricts one thing, so combine them to get exactly the entries you want:
|
|
82
|
+
|
|
83
|
+
- Types: `condition: {_type: 'BlogPost'}`, or `{_type: {in: [...]}}` for several.
|
|
84
|
+
- Workspaces: `condition: {_workspace: 'main'}` limits what can be selected, `limitLocations` limits what editors can browse.
|
|
85
|
+
- Roots: `condition: {_root: 'pages'}`, or `limitLocations` to hide other roots.
|
|
86
|
+
- Starting point: `location`, with a `parentId` to start inside an entry. `pickChildren` uses the entry being edited as the parent.
|
|
87
|
+
- Number of entries: `max` on `Field.entry.multiple`, `required` to demand at least one.
|
|
88
|
+
|
|
89
|
+
This field accepts up to three blog posts, picked from below the blog entry:
|
|
90
|
+
|
|
91
|
+
```tsx
|
|
92
|
+
import {Field} from 'alinea'
|
|
93
|
+
|
|
94
|
+
declare const blogId: string
|
|
95
|
+
|
|
96
|
+
Field.entry.multiple('Related posts', {
|
|
97
|
+
// Only blog posts can be selected
|
|
98
|
+
condition: {_type: 'BlogPost'},
|
|
99
|
+
// List the posts below the blog entry in the pages root
|
|
100
|
+
location: {workspace: 'main', root: 'pages', parentId: blogId},
|
|
101
|
+
// Don't offer other workspaces and roots
|
|
102
|
+
limitLocations: [{workspace: 'main', root: 'pages'}],
|
|
103
|
+
// Pick up to three
|
|
104
|
+
max: 3
|
|
105
|
+
})
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
`condition` and `location` also work on the [Link field](link.md), where they apply to its page picker.
|
|
109
|
+
|
|
110
|
+
## Dynamic options
|
|
111
|
+
|
|
112
|
+
`condition` and `location` also accept a function. It receives the entry being edited (`id`, `type`, `workspace`, `root`, `parentId` and `locale`) and a `graph` to run queries with, and can be async. That's useful when the same type lives in several workspaces:
|
|
113
|
+
|
|
114
|
+
```tsx
|
|
115
|
+
import {Field} from 'alinea'
|
|
116
|
+
|
|
117
|
+
Field.entry('Author', {
|
|
118
|
+
// Open the picker in the authors root of the workspace being edited
|
|
119
|
+
location: ({entry}) => ({workspace: entry.workspace, root: 'authors'}),
|
|
120
|
+
// And only offer authors from that workspace
|
|
121
|
+
condition: ({entry}) => ({_type: 'Author', _workspace: entry.workspace})
|
|
122
|
+
})
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Picking children
|
|
126
|
+
|
|
127
|
+
With `pickChildren` the picker lists the children of the entry being edited, for example to choose a featured item among the entries of a collection:
|
|
128
|
+
|
|
129
|
+
```tsx
|
|
130
|
+
import {Field} from 'alinea'
|
|
131
|
+
|
|
132
|
+
Field.entry('Featured book', {
|
|
133
|
+
condition: {_type: 'Book'},
|
|
134
|
+
pickChildren: true
|
|
135
|
+
})
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Value
|
|
139
|
+
|
|
140
|
+
When you query an entry field, each link is resolved to the target's current data: `entryId`, `entryType`, `title`, `path`, and its `url` (also as `href`), with the values of any extra `fields` on `link.fields`. A single entry field is `null` while it's empty, a multiple one is an array.
|
|
141
|
+
|
|
142
|
+
Targets are looked up in the locale of the entry you queried (or entries without a locale) and with the same status. Links to entries that were deleted or aren't published are dropped from multiple fields; a single link to one has no `url`.
|
|
143
|
+
|
|
144
|
+
```tsx
|
|
145
|
+
import {cms} from '@/cms'
|
|
146
|
+
import {BlogPost} from '@/schema'
|
|
147
|
+
|
|
148
|
+
const post = await cms.get({type: BlogPost, path: 'hello-world'})
|
|
149
|
+
post.author?.title // "Jane Doe"
|
|
150
|
+
post.author?.url // "/authors/jane-doe"
|
|
151
|
+
post.categories.map(category => category.title)
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## Querying fields of the linked entries
|
|
155
|
+
|
|
156
|
+
The resolved link only holds the basics. To get other fields of the target, query through the field: `.first()` on a single entry field, `.find()`, `.first()` or `.count()` on a multiple one. They take the same options as a query, including `select`, `filter` and `orderBy`:
|
|
157
|
+
|
|
158
|
+
```tsx
|
|
159
|
+
import {cms} from '@/cms'
|
|
160
|
+
import {Author, BlogPost} from '@/schema'
|
|
161
|
+
import {Query} from 'alinea'
|
|
162
|
+
|
|
163
|
+
const post = await cms.get({
|
|
164
|
+
type: BlogPost,
|
|
165
|
+
path: 'hello-world',
|
|
166
|
+
select: {
|
|
167
|
+
title: Query.title,
|
|
168
|
+
author: BlogPost.author.first({
|
|
169
|
+
select: {name: Query.title, avatar: Author.avatar, bio: Author.bio}
|
|
170
|
+
}),
|
|
171
|
+
categories: BlogPost.categories.find({
|
|
172
|
+
select: {title: Query.title, url: Query.url},
|
|
173
|
+
orderBy: {asc: Query.title}
|
|
174
|
+
})
|
|
175
|
+
}
|
|
176
|
+
})
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
To go the other way, from an author to their posts, filter on the field. See [Related content](../query/related.md).
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# File
|
|
2
|
+
|
|
3
|
+
A file field links to a file in the [media library](../workspaces/media.md): a PDF brochure, a price list, a download. Editors pick it from the files uploaded to the media library. For images you want to display, use the [Image field](image.md): it returns dimensions and a blur placeholder too.
|
|
4
|
+
|
|
5
|
+
```tsx
|
|
6
|
+
import {Field} from 'alinea'
|
|
7
|
+
|
|
8
|
+
Field.file('Brochure')
|
|
9
|
+
|
|
10
|
+
Field.file.multiple('Downloads', {max: 10})
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
import {Config, Field} from 'alinea'
|
|
15
|
+
|
|
16
|
+
export default Config.type('File field', {
|
|
17
|
+
fields: {
|
|
18
|
+
file: Field.file('Brochure'),
|
|
19
|
+
fileMultiple: Field.file.multiple('Downloads', {
|
|
20
|
+
fields: {label: Field.text('Label')}
|
|
21
|
+
})
|
|
22
|
+
}
|
|
23
|
+
})
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Options
|
|
27
|
+
|
|
28
|
+
- `fields`: extra fields stored on each link, such as a label or description.
|
|
29
|
+
- `max` (multiple only): the maximum number of files.
|
|
30
|
+
- `location` and `limitLocations`: open the picker in, or limit it to, specific media roots or folders, like the [Entry field](entry.md).
|
|
31
|
+
- `defaultView`: show the picker as `'thumb'` (default) or `'row'`.
|
|
32
|
+
- The [common options](../fields.md) `help`, `width`, `inline`, `initialValue`, `required`, `validate`, `readOnly`, `hidden` and `shared`.
|
|
33
|
+
|
|
34
|
+
The picker offers every file in the media library, images included.
|
|
35
|
+
|
|
36
|
+
## Value
|
|
37
|
+
|
|
38
|
+
Each file is resolved to:
|
|
39
|
+
|
|
40
|
+
- `url` and `href`: the url of the file on your site (both hold the same value), such as `/admin/file/brochure.pdf`. It's served through your Alinea handler and keeps working when the file is moved or renamed.
|
|
41
|
+
- `title`: the file's title in the media library.
|
|
42
|
+
- `extension`: the file extension including the dot, `'.pdf'`.
|
|
43
|
+
- `size`: the size in bytes.
|
|
44
|
+
- `fields`: the values of your extra fields.
|
|
45
|
+
|
|
46
|
+
A single file field is `null` while it's empty, a multiple one is an array.
|
|
47
|
+
|
|
48
|
+
```tsx
|
|
49
|
+
import type {FileLink} from 'alinea'
|
|
50
|
+
|
|
51
|
+
export function Download({file}: {file: FileLink | null}) {
|
|
52
|
+
if (!file?.href) return null
|
|
53
|
+
const kb = Math.round(file.size / 1024)
|
|
54
|
+
return (
|
|
55
|
+
<a href={file.href} download>
|
|
56
|
+
{file.title} ({file.extension.slice(1).toUpperCase()}, {kb} KB)
|
|
57
|
+
</a>
|
|
58
|
+
)
|
|
59
|
+
}
|
|
60
|
+
```
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
# Image
|
|
2
|
+
|
|
3
|
+
An image field links to an image in the [media library](../workspaces/media.md). Queries return everything you need to render it well: the url, dimensions, alt text, the focal point the editor set and a tiny placeholder to show while it loads.
|
|
4
|
+
|
|
5
|
+
```tsx
|
|
6
|
+
import {Field} from 'alinea'
|
|
7
|
+
|
|
8
|
+
Field.image('Cover image')
|
|
9
|
+
|
|
10
|
+
Field.image.multiple('Gallery')
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
import {Config, Field} from 'alinea'
|
|
15
|
+
|
|
16
|
+
export default Config.type('Image field', {
|
|
17
|
+
fields: {
|
|
18
|
+
image: Field.image('Cover image'),
|
|
19
|
+
imageMultiple: Field.image.multiple('Gallery')
|
|
20
|
+
}
|
|
21
|
+
})
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Options
|
|
25
|
+
|
|
26
|
+
- `fields`: extra fields stored on each image, such as a caption or a credit.
|
|
27
|
+
- `max` (multiple only): the maximum number of images.
|
|
28
|
+
- `location` and `limitLocations`: open the picker in, or limit it to, specific media roots or folders, like the [Entry field](entry.md).
|
|
29
|
+
- `defaultView`: show the picker as `'thumb'` (default) or `'row'`.
|
|
30
|
+
- The [common options](../fields.md) `help`, `width`, `inline`, `initialValue`, `required`, `validate`, `readOnly`, `hidden` and `shared`.
|
|
31
|
+
|
|
32
|
+
The picker only offers images: files with an extension such as `.jpg`, `.png`, `.webp`, `.gif`, `.avif` or `.svg`.
|
|
33
|
+
|
|
34
|
+
## Value
|
|
35
|
+
|
|
36
|
+
Each image is resolved to an `ImageLink`:
|
|
37
|
+
|
|
38
|
+
- `src`: the url of the image on your site, such as `/admin/file/landscape.jpg?v=3f2a…`. It's served through your Alinea handler, and the `v` parameter changes when the file is replaced, so caches never serve an outdated copy.
|
|
39
|
+
- `width` and `height`: the dimensions in pixels.
|
|
40
|
+
- `alt`: the alt text editors enter in the media library, in the locale of the entry you queried when the media root is [translated](../workspaces/media.md).
|
|
41
|
+
- `focus`: the focal point as `{x, y}`, each between 0 and 1. Use it as `object-position` when you crop the image.
|
|
42
|
+
- `thumbHash` and `averageColor`: a compact placeholder and the average color (`'#aabbcc'`) to show while the image loads.
|
|
43
|
+
- `title`, `extension`, `size` (bytes) and `hash`.
|
|
44
|
+
- `fields`: the values of your extra fields.
|
|
45
|
+
|
|
46
|
+
A single image field is `null` while it's empty, a multiple one is an array.
|
|
47
|
+
|
|
48
|
+
## Rendering with next/image
|
|
49
|
+
|
|
50
|
+
`withAlinea` allows the image urls in your Next.js image config, so you can pass them to `next/image` directly. `imageBlurUrl` from `alinea/ui` turns the thumbhash into a data url for the blur placeholder:
|
|
51
|
+
|
|
52
|
+
File: components/CmsImage.tsx
|
|
53
|
+
```tsx
|
|
54
|
+
import type {ImageLink} from 'alinea'
|
|
55
|
+
import {imageBlurUrl} from 'alinea/ui'
|
|
56
|
+
import Image from 'next/image'
|
|
57
|
+
|
|
58
|
+
interface CmsImageProps {
|
|
59
|
+
image: ImageLink | null
|
|
60
|
+
sizes?: string
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export function CmsImage({image, sizes}: CmsImageProps) {
|
|
64
|
+
if (!image?.src) return null
|
|
65
|
+
const blurDataURL = imageBlurUrl(image) || undefined
|
|
66
|
+
return (
|
|
67
|
+
<Image
|
|
68
|
+
src={image.src}
|
|
69
|
+
width={image.width}
|
|
70
|
+
height={image.height}
|
|
71
|
+
alt={image.alt ?? ''}
|
|
72
|
+
sizes={sizes}
|
|
73
|
+
placeholder={blurDataURL ? 'blur' : 'empty'}
|
|
74
|
+
blurDataURL={blurDataURL}
|
|
75
|
+
style={{
|
|
76
|
+
objectFit: 'cover',
|
|
77
|
+
objectPosition: image.focus
|
|
78
|
+
? `${image.focus.x * 100}% ${image.focus.y * 100}%`
|
|
79
|
+
: undefined
|
|
80
|
+
}}
|
|
81
|
+
/>
|
|
82
|
+
)
|
|
83
|
+
}
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## Alt text and captions
|
|
87
|
+
|
|
88
|
+
`image.alt` is the alt text editors enter once, in the media library. When an image needs a description that depends on where it's used, or a caption or credit, add extra fields with the `fields` option. Editors fill them in next to the image they picked, and the values are stored with the link in your entry, not on the media file:
|
|
89
|
+
|
|
90
|
+
```tsx
|
|
91
|
+
import {Config, Field} from 'alinea'
|
|
92
|
+
|
|
93
|
+
export const Article = Config.document('Article', {
|
|
94
|
+
fields: {
|
|
95
|
+
image: Field.image('Image', {
|
|
96
|
+
fields: {
|
|
97
|
+
alt: Field.text('Alt text', {required: true}),
|
|
98
|
+
caption: Field.text('Caption'),
|
|
99
|
+
credit: Field.text('Credit', {width: 0.5})
|
|
100
|
+
}
|
|
101
|
+
})
|
|
102
|
+
}
|
|
103
|
+
})
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Options like `required`, `help` and `width` work on these fields as usual: an entry with an image but without its alt text can't be published.
|
|
107
|
+
|
|
108
|
+
Query results keep the extra values on `image.fields`, next to the properties of the image. An extra field named `alt` does not replace the alt text of the media library: `image.alt` still holds that one, and `image.fields.alt` the one entered on this entry. `ImageLink` takes the type of the extra fields as its type parameter:
|
|
109
|
+
|
|
110
|
+
```tsx
|
|
111
|
+
import type {ImageLink} from 'alinea'
|
|
112
|
+
|
|
113
|
+
interface FigureProps {
|
|
114
|
+
image: ImageLink<{alt: string; caption: string; credit: string}> | null
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
export function Figure({image}: FigureProps) {
|
|
118
|
+
if (!image?.src) return null
|
|
119
|
+
const {alt, caption, credit} = image.fields
|
|
120
|
+
return (
|
|
121
|
+
<figure>
|
|
122
|
+
<img
|
|
123
|
+
src={image.src}
|
|
124
|
+
width={image.width}
|
|
125
|
+
height={image.height}
|
|
126
|
+
alt={alt || image.alt || ''}
|
|
127
|
+
/>
|
|
128
|
+
{caption && (
|
|
129
|
+
<figcaption>
|
|
130
|
+
{caption} {credit && <small>{credit}</small>}
|
|
131
|
+
</figcaption>
|
|
132
|
+
)}
|
|
133
|
+
</figure>
|
|
134
|
+
)
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
In a multiple image field every image gets its own values. The [Link](link.md), [Entry](entry.md), File and Url fields take the same `fields` option and return the values on `link.fields` too.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Link
|
|
2
|
+
|
|
3
|
+
A link field lets editors link to a page in the CMS, an external url or an uploaded file, whichever they need. Use it for buttons and calls to action. When a link can only be one kind, use the [Entry](entry.md), [Url](url.md), [File](file.md) or [Image](image.md) field instead: they have a simpler picker and a narrower type.
|
|
4
|
+
|
|
5
|
+
```tsx
|
|
6
|
+
import {Field} from 'alinea'
|
|
7
|
+
|
|
8
|
+
Field.link('Button link')
|
|
9
|
+
|
|
10
|
+
Field.link.multiple('Related links', {max: 5})
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
import {Config, Field} from 'alinea'
|
|
15
|
+
|
|
16
|
+
export default Config.type('Link field', {
|
|
17
|
+
fields: {
|
|
18
|
+
link: Field.link('Single link'),
|
|
19
|
+
linkMultiple: Field.link.multiple('Multiple links'),
|
|
20
|
+
linkWithLabel: Field.link('Link with label', {
|
|
21
|
+
fields: {label: Field.text('Label')}
|
|
22
|
+
})
|
|
23
|
+
}
|
|
24
|
+
})
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Options
|
|
28
|
+
|
|
29
|
+
- `fields`: extra fields stored on each link, such as a label or an "open in new tab" toggle. Pass an object of fields or a type.
|
|
30
|
+
- `max` (multiple only): the maximum number of links.
|
|
31
|
+
- `allowDuplicates` (multiple only): allow the same link more than once. Default `true` for `Field.link.multiple`.
|
|
32
|
+
- `condition` and `location`: limit which entries the page picker offers and where it opens, see the [Entry field](entry.md). They don't affect the file picker.
|
|
33
|
+
- The [common options](../fields.md) `help`, `width`, `inline`, `initialValue`, `required`, `validate`, `readOnly`, `hidden` and `shared`.
|
|
34
|
+
|
|
35
|
+
## Allowing only some kinds of links
|
|
36
|
+
|
|
37
|
+
`Field.link` accepts all three kinds. To accept a single kind, use the field made for it:
|
|
38
|
+
|
|
39
|
+
- Pages, external urls and files: `Field.link`
|
|
40
|
+
- Only pages (internal links): [`Field.entry`](entry.md)
|
|
41
|
+
- Only external urls: [`Field.url`](url.md)
|
|
42
|
+
- Only files from the media library: [`Field.file`](file.md)
|
|
43
|
+
- Only images: [`Field.image`](image.md)
|
|
44
|
+
|
|
45
|
+
Each has the same `.multiple` variant, a narrower value type and a picker without the tabs for the other kinds.
|
|
46
|
+
|
|
47
|
+
`Field.link` has no option to hide one of its kinds. To accept two of them, such as a page or a url but no file, reject the third in `validate`. The stored link's `_type` is `'entry'`, `'url'` or `'file'`:
|
|
48
|
+
|
|
49
|
+
```tsx
|
|
50
|
+
import {Field} from 'alinea'
|
|
51
|
+
|
|
52
|
+
// A page or an external url, but no file
|
|
53
|
+
Field.link('Button link', {
|
|
54
|
+
validate(link) {
|
|
55
|
+
if (link?._type === 'file') return 'Link to a page or a url'
|
|
56
|
+
}
|
|
57
|
+
})
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
To offer only some pages, pass a `condition`. It applies to the page picker, the url and file pickers are unaffected:
|
|
61
|
+
|
|
62
|
+
```tsx
|
|
63
|
+
import {Field} from 'alinea'
|
|
64
|
+
|
|
65
|
+
Field.link('Button link', {
|
|
66
|
+
// Only offer pages of these types in the page picker
|
|
67
|
+
condition: {_type: {in: ['Page', 'BlogPost']}}
|
|
68
|
+
})
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Value
|
|
72
|
+
|
|
73
|
+
When you query a link field, every link is resolved to what you need to render it. Check `_type` to see which kind it is:
|
|
74
|
+
|
|
75
|
+
- `'entry'`: a page. `href` and `url` hold its current url (so the link survives moves and renames), plus `title`, `path`, `entryId` and `entryType`.
|
|
76
|
+
- `'url'`: an external link with the `url` and `href` (the same value), `title` and `target` (`'_blank'` or `'_self'`) the editor entered.
|
|
77
|
+
- `'file'`: an uploaded file with its `url` and `href` (the same value), `title`, `extension` and `size` in bytes.
|
|
78
|
+
|
|
79
|
+
The values of the extra `fields` are on `link.fields`. A single link is `null` while it's empty, a multiple link field is an array.
|
|
80
|
+
|
|
81
|
+
```tsx
|
|
82
|
+
import type {Link as LinkValue} from 'alinea'
|
|
83
|
+
import Link from 'next/link'
|
|
84
|
+
|
|
85
|
+
interface ButtonProps {
|
|
86
|
+
link: LinkValue<{label: string}> | null
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export function Button({link}: ButtonProps) {
|
|
90
|
+
if (!link?.href) return null
|
|
91
|
+
const label = link.fields.label || link.title
|
|
92
|
+
if (link._type === 'url')
|
|
93
|
+
return (
|
|
94
|
+
<a href={link.href} target={link.target || undefined}>
|
|
95
|
+
{label}
|
|
96
|
+
</a>
|
|
97
|
+
)
|
|
98
|
+
return <Link href={link.href}>{label}</Link>
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Links to entries that were deleted, or that aren't published, are dropped from multiple link fields. A single link to such an entry keeps its stored reference but has no `href`, so always check `href` before rendering.
|
|
103
|
+
|
|
104
|
+
## Extra fields
|
|
105
|
+
|
|
106
|
+
```tsx
|
|
107
|
+
import {Field} from 'alinea'
|
|
108
|
+
|
|
109
|
+
Field.link('Call to action', {
|
|
110
|
+
fields: {
|
|
111
|
+
label: Field.text('Label', {width: 0.5}),
|
|
112
|
+
style: Field.select('Style', {
|
|
113
|
+
width: 0.5,
|
|
114
|
+
initialValue: 'primary',
|
|
115
|
+
options: {primary: 'Primary', secondary: 'Secondary'}
|
|
116
|
+
})
|
|
117
|
+
}
|
|
118
|
+
})
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Editors fill in these fields in the link's row after picking the target. `LinkValue<{label: string}>` in the example above types them; see [Infer](../typescript.md) to derive the type from the fields instead.
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
# List
|
|
2
|
+
|
|
3
|
+
A list field holds an ordered list of rows, and every row has one of the types in its `schema`. Editors add, reorder and remove rows. Lists are how you build pages out of blocks: a hero, a text section, a gallery, in any order.
|
|
4
|
+
|
|
5
|
+
```tsx
|
|
6
|
+
import {Config, Field} from 'alinea'
|
|
7
|
+
|
|
8
|
+
const TextBlock = Config.type('Text', {
|
|
9
|
+
fields: {
|
|
10
|
+
title: Field.text('Title'),
|
|
11
|
+
text: Field.richText('Text')
|
|
12
|
+
}
|
|
13
|
+
})
|
|
14
|
+
|
|
15
|
+
const ImageBlock = Config.type('Image', {
|
|
16
|
+
fields: {
|
|
17
|
+
image: Field.image('Image'),
|
|
18
|
+
caption: Field.text('Caption')
|
|
19
|
+
}
|
|
20
|
+
})
|
|
21
|
+
|
|
22
|
+
export const Page = Config.document('Page', {
|
|
23
|
+
fields: {
|
|
24
|
+
blocks: Field.list('Blocks', {
|
|
25
|
+
schema: {TextBlock, ImageBlock}
|
|
26
|
+
})
|
|
27
|
+
}
|
|
28
|
+
})
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
import {Config, Field} from 'alinea'
|
|
33
|
+
|
|
34
|
+
export default Config.type("List field", {
|
|
35
|
+
fields: {
|
|
36
|
+
list: Field.list("List", {
|
|
37
|
+
schema: {
|
|
38
|
+
Item: Config.type("Item", {
|
|
39
|
+
fields: {
|
|
40
|
+
title: Field.text("Title"),
|
|
41
|
+
text: Field.richText("Text"),
|
|
42
|
+
}
|
|
43
|
+
})
|
|
44
|
+
}
|
|
45
|
+
}),
|
|
46
|
+
listMixed: Field.list("List mixed", {
|
|
47
|
+
schema: {
|
|
48
|
+
Text: Config.type("Text", {
|
|
49
|
+
fields: {
|
|
50
|
+
title: Field.text("Title"),
|
|
51
|
+
text: Field.richText("Text"),
|
|
52
|
+
}
|
|
53
|
+
}),
|
|
54
|
+
Image: Config.type("Image", {
|
|
55
|
+
fields: {
|
|
56
|
+
image: Field.image("Image")
|
|
57
|
+
}
|
|
58
|
+
})
|
|
59
|
+
}
|
|
60
|
+
})
|
|
61
|
+
}
|
|
62
|
+
})
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Options
|
|
66
|
+
|
|
67
|
+
- `schema` (required): the row types, keyed by name. The key is stored in each row's `_type`, so renaming it orphans existing rows.
|
|
68
|
+
- `min`: mark the field as invalid while it has fewer rows.
|
|
69
|
+
- `max`: hide the add buttons once the list has this many rows, and mark the field as invalid when it has more.
|
|
70
|
+
- `initialValue`: rows to start with, without `_id` or `_index`: they're generated.
|
|
71
|
+
- `validate`: receives the rows, including their `_id` and `_type`.
|
|
72
|
+
- The [common options](../fields.md) `help`, `width`, `inline`, `required`, `readOnly` and `hidden`.
|
|
73
|
+
|
|
74
|
+
Row types are ordinary [Types](../schema/type.md): they can have tabs, an `icon` that is shown in the add menu and nested lists. They don't need a title or path and don't have to be in the schema.
|
|
75
|
+
|
|
76
|
+
Options that change how a block looks rather than what it says, such as a background or a layout variant, can go in a tab of the type's `tabs`. Editors find each tab as a section of the block's settings sheet, below the label and anchor, which keeps the block form short. Their fields are stored on the row next to its other fields:
|
|
77
|
+
|
|
78
|
+
```tsx
|
|
79
|
+
const HeroBlock = Config.type('Hero', {
|
|
80
|
+
fields: {
|
|
81
|
+
title: Field.text('Title'),
|
|
82
|
+
text: Field.richText('Text')
|
|
83
|
+
},
|
|
84
|
+
tabs: {
|
|
85
|
+
style: Field.tab('Style', {
|
|
86
|
+
fields: {
|
|
87
|
+
background: Field.select('Background', {
|
|
88
|
+
options: {light: 'Light', dark: 'Dark'},
|
|
89
|
+
initialValue: 'light'
|
|
90
|
+
})
|
|
91
|
+
}
|
|
92
|
+
})
|
|
93
|
+
}
|
|
94
|
+
})
|
|
95
|
+
|
|
96
|
+
// A queried row: {_type: 'HeroBlock', title, text, background, ...}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Value
|
|
100
|
+
|
|
101
|
+
The value is an array of rows. Next to its fields, every row has:
|
|
102
|
+
|
|
103
|
+
- `_type`: the key of its type in `schema`.
|
|
104
|
+
- `_id`: a unique id, handy as React `key`.
|
|
105
|
+
- `_index`: a sort key. Rows are already sorted when you get them.
|
|
106
|
+
- `_label` and `_anchor`: optional. Editors can give a row a custom label (shown in the dashboard) and an anchor, so links can point to that row (`/page#anchor`). Anchors are unique within an entry.
|
|
107
|
+
|
|
108
|
+
When you query a list, link and image fields inside rows are resolved like fields at the top level.
|
|
109
|
+
|
|
110
|
+
## Rendering
|
|
111
|
+
|
|
112
|
+
Switch on `_type` to render each row. `Infer` turns the list's schema into a union type, so TypeScript knows the fields of every branch:
|
|
113
|
+
|
|
114
|
+
```tsx
|
|
115
|
+
import {Config, Field, type Infer} from 'alinea'
|
|
116
|
+
|
|
117
|
+
const TextBlock = Config.type('Text', {
|
|
118
|
+
fields: {text: Field.text('Text', {multiline: true})}
|
|
119
|
+
})
|
|
120
|
+
|
|
121
|
+
const ImageBlock = Config.type('Image', {
|
|
122
|
+
fields: {image: Field.image('Image')}
|
|
123
|
+
})
|
|
124
|
+
|
|
125
|
+
export const blocks = {TextBlock, ImageBlock}
|
|
126
|
+
|
|
127
|
+
export const Page = Config.document('Page', {
|
|
128
|
+
fields: {blocks: Field.list('Blocks', {schema: blocks})}
|
|
129
|
+
})
|
|
130
|
+
|
|
131
|
+
type Block = Infer<typeof Page>['blocks'][number]
|
|
132
|
+
|
|
133
|
+
export function Blocks({blocks}: {blocks: Array<Block>}) {
|
|
134
|
+
return blocks.map(block => {
|
|
135
|
+
switch (block._type) {
|
|
136
|
+
case 'TextBlock':
|
|
137
|
+
return <p key={block._id} id={block._anchor}>{block.text}</p>
|
|
138
|
+
case 'ImageBlock':
|
|
139
|
+
return <img key={block._id} src={block.image.src} alt={block.image.alt} />
|
|
140
|
+
}
|
|
141
|
+
})
|
|
142
|
+
}
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
## Good to know
|
|
146
|
+
|
|
147
|
+
- Different pages often allow different blocks. Keep block types in shared modules and compose a `schema` per page type, instead of one list that allows everything everywhere.
|
|
148
|
+
- Types used in a list are registered by the list, not by the schema. The same type object can be used in several lists.
|
|
149
|
+
- Filter entries on list contents with [`includes`](../query/filtering.md), for example all pages that contain a video block: `filter: {blocks: {includes: {_type: 'VideoBlock'}}}`.
|