@dxos/plugin-kanban 0.8.4-main.c85a9c8dae → 0.8.4-main.d9fc60f731

package/LICENSE

@@ -1,8 +1,105 @@
-MIT License 
-Copyright (c) 2022 DXOS
+# Functional Source License, Version 1.1, ALv2 Future License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+## Abbreviation
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+FSL-1.1-Apache-2.0
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/PLUGIN.mdl

@@ -0,0 +1,398 @@
+---
+id: org.dxos.plugin.kanban
+name: KanbanPlugin
+version: 0.1.0
+---
+
+Visual project management plugin for `DXOS` Composer — organise any ECHO type into drag-and-drop columns driven by a single-select field, with full local-first persistence and real-time peer replication.
+
+## Extensions
+
+The following extension dialects are used in this document.
+Each extension is defined in the Appendix or resolved via its URI.
+
+| Term        | URI                            |
+|-------------|--------------------------------|
+| `type`      | `org.dxos.mdl.type@1.0`        |
+| `feat`      | `org.dxos.mdl.feat@1.0`        |
+| `test`      | `org.dxos.mdl.test@1.0`        |
+| `component` | `org.dxos.mdl.component@1.0`   |
+| `op`        | `org.dxos.mdl.op@1.0`          |
+
+## Types
+
+```mdl
+type ArrangementColumnEntry
+  fields:
+    ids: string[]              # ordered card ids within the column
+    hidden?: boolean           # when true the column is hidden from the board
+```
+
+```mdl
+type Arrangement
+  fields:
+    order: string[]            # ordered column values
+    columns: Map<string, ArrangementColumnEntry>
+```
+
+```mdl
+type KanbanViewSpec
+  fields:
+    kind: "view"               # discriminator — items sourced from a View query
+    view: Ref<View>            # the View whose query drives card membership
+```
+
+```mdl
+type KanbanItemsSpec
+  fields:
+    kind: "items"              # discriminator — kanban owns items explicitly
+    pivotField: string         # property path that drives column membership
+    items: Ref<object>[]       # items owned directly by the kanban
+```
+
+```mdl
+type KanbanSpec
+  desc: Discriminated union of item-source strategies.
+  literals: KanbanViewSpec | KanbanItemsSpec
+```
+
+```mdl
+type Kanban
+  desc: Root ECHO object for a kanban board. Stored with typename org.dxos.type.kanban v0.2.0.
+  fields:
+    name?: string
+    arrangement: Arrangement
+    spec: KanbanSpec           # discriminated by spec.kind
+```
+
+```mdl
+type KanbanSettings
+  fields:
+    hideUncategorized?: boolean  # hides items with no pivot value
+```
+
+```mdl
+type KanbanViewSettings
+  fields:
+    columnFieldId: string        # id of the View field used as pivot column
+    hideUncategorized?: boolean
+```
+
+```mdl
+type CreateKanbanInput
+  fields:
+    name?: string
+    typename?: string            # ECHO typename of card objects
+    initialPivotColumn?: string  # initial single-select field to pivot on
+```
+
+## Components
+
+```mdl
+component KanbanArticle
+  desc: Main article surface for a Kanban. Branches internally on spec.kind — view-variant runs a typename query via the linked View; items-variant dereferences spec.items directly.
+  props:
+    subject: Kanban
+    role: "article" | "section"
+  state:
+    projection: ProjectionModel  # column/field projection derived from View + schema
+    items: AtomQuery             # reactive card query (view-variant) or array (items-variant)
+  actions:
+    addCard(columnValue: string) → string   # returns new card id
+    removeCard(card: object)
+    moveCard(card: object, toColumn: string, toIndex: number)
+    deleteCardField(fieldId: string)
+  layout: |
+    ┌──────────────────────────────────────┐
+    │ [toolbar slot]                        │
+    ├──────────────────────────────────────┤
+    │ Col A       │ Col B       │ Col C    │
+    │ ┌─────────┐ │ ┌─────────┐ │  …       │
+    │ │ card    │ │ │ card    │ │          │
+    │ └─────────┘ │ └─────────┘ │          │
+    │ [+ Add card]│             │          │
+    └──────────────────────────────────────┘
+```
+
+```mdl
+component KanbanSettings
+  desc: Properties panel for a Kanban. View-variant shows a column-field picker plus common settings; items-variant shows only common settings.
+  props:
+    subject: Kanban
+  state:
+    selectFields: { value: string; label: string }[]   # single-select fields available as pivot
+  actions:
+    changeColumnField(fieldId: string)
+    toggleHideUncategorized(hidden: boolean)
+```
+
+## Operations
+
+```mdl
+op deleteCard
+  desc: Removes a card object from the ECHO database.
+  input:
+    card: object               # the card to remove
+  output: DeleteCardOutput     # { card } snapshot of the removed card
+  effects: [echo:write]
+```
+
+```mdl
+op deleteCardField
+  desc: Removes a field projection from the View's schema; returns enough data to undo.
+  input:
+    view: View
+    fieldId: string
+  output: DeleteCardFieldOutput  # { field, props, index }
+  effects: [echo:write]
+  requires: [AtomRegistry, Database]
+```
+
+```mdl
+op restoreCard
+  desc: Undo counterpart to deleteCard — re-adds a previously removed card to the database.
+  input:
+    card: object               # the card snapshot to restore
+  output: void
+  effects: [echo:write]
+```
+
+```mdl
+op restoreCardField
+  desc: Undo counterpart to deleteCardField — re-inserts a field projection at its original index.
+  input:
+    view: View
+    field: FieldSchema
+    props: object              # field properties
+    index: number              # position to restore at
+  output: void
+  effects: [echo:write]
+  requires: [AtomRegistry, Database]
+```
+
+## Features
+
+```mdl
+feat F-1: Board Layout
+
+  req F-1.1: Columns are ordered by Arrangement.order; each column contains its cards in Arrangement.columns[value].ids order.
+  req F-1.2: Cards within a column are rendered in the stored id order.
+  req F-1.3:
+    when: settings.hideUncategorized is true
+    then: the uncategorized column is not rendered
+```
+
+```mdl
+feat F-2: Drag and Drop
+
+  req F-2.1:
+    when: user drags a card to a different column
+    then: card's pivot field is updated to the target column value; Arrangement updated
+
+  req F-2.2:
+    when: user drags a card within the same column
+    then: card ids are reordered in Arrangement.columns[value].ids
+
+  req F-2.3:
+    when: user drags a column header
+    then: Arrangement.order is updated to reflect the new column order
+```
+
+```mdl
+feat F-3: Card Management
+
+  req F-3.1:
+    when: user clicks Add Card in a column
+    then: a new ECHO object of the board's card type is created with the pivot field set to that column's value
+
+  req F-3.2:
+    when: user removes a card
+    then: op:deleteCard runs; card is removed from the ECHO database and from the board
+
+  req F-3.3:
+    when: user undoes a delete-card action
+    then: op:restoreCard re-adds the card; board reflects restored state
+```
+
+```mdl
+feat F-4: Column Configuration
+
+  req F-4.1:
+    when: user opens KanbanSettings for a view-variant board
+    then: column-field picker shows all single-select fields from the card schema
+
+  req F-4.2:
+    when: user selects a different column field
+    then: View.projection.pivotFieldId is updated; board re-renders with new columns
+
+  req F-4.3:
+    when: user removes a column field
+    then: op:deleteCardField removes the projection; op:restoreCardField can reverse it
+```
+
+```mdl
+feat F-5: Item Source Variants
+
+  req F-5.1:
+    when: spec.kind === "view"
+    then: items come from running the View's typename query against the ECHO database
+
+  req F-5.2:
+    when: spec.kind === "items"
+    then: items come from spec.items (explicit ref array); used by externally-synced boards (e.g. Linear, GitHub)
+
+  req F-5.3: Both variants share the same Arrangement persistence and drag-and-drop logic.
+```
+
+```mdl
+feat F-6: ECHO Persistence and Collaboration
+
+  req F-6.1: All Kanban, Arrangement, and card mutations are written to ECHO and replicated to peers.
+  req F-6.2:
+    when: a peer updates a card or moves it
+    then: KanbanArticle re-renders reactively via AtomQuery / AtomObj subscriptions
+
+  req F-6.3: View-variant kanbans own an associated View object that is hidden from the space browser.
+```
+
+```mdl
+feat F-7: AI Blueprint
+
+  req F-7.1: Plugin contributes a Kanban blueprint that lets an AI agent create and update kanban boards.
+  req F-7.2:
+    when: an AI agent calls the blueprint
+    then: agent can create boards, place cards in columns, and update card fields
+```
+
+## Acceptance
+
+```mdl
+test T-1: Create kanban board
+  given: a space with a custom ECHO type that has a single-select field "status"
+  when: user creates a new Kanban selecting that type and "status" as the pivot column
+  then:
+    - Kanban object written to ECHO with spec.kind === "view"
+    - columns correspond to the "status" field's enum values
+    - existing objects appear as cards in their respective columns
+```
+
+```mdl
+test T-2: Drag card between columns
+  given: a Kanban with columns "todo", "in-progress", "done" and a card in "todo"
+  when: user drags the card to "in-progress"
+  then:
+    - card's "status" field updated to "in-progress"
+    - Arrangement reflects card in "in-progress" column
+    - change replicated to peers via ECHO
+```
+
+```mdl
+test T-3: Reorder cards within a column
+  given: a column with cards [A, B, C] in order
+  when: user drags card C above card A
+  then:
+    - Arrangement.columns["col"].ids === [C, A, B]
+    - board renders in new order
+```
+
+```mdl
+test T-4: Add card to column
+  given: a board with a "todo" column
+  when: user clicks Add Card in "todo"
+  then:
+    - new ECHO object created with pivot field set to "todo"
+    - card appears at the bottom of the "todo" column
+```
+
+```mdl
+test T-5: Delete and restore card
+  given: a board with card X in column "todo"
+  when: user deletes card X, then undoes
+  then:
+    - after delete: card X absent from board and ECHO database
+    - after undo: card X restored to ECHO and reappears in "todo"
+```
+
+```mdl
+test T-6: Hide uncategorized column
+  given: a board with some cards that have no pivot value (uncategorized)
+  when: user enables "Hide uncategorized column" in KanbanSettings
+  then:
+    - uncategorized column no longer rendered
+    - Arrangement.columns[UNCATEGORIZED].hidden === true
+```
+
+```mdl
+test T-7: Switch pivot column field
+  given: a view-variant board currently pivoting on "status"
+  when: user opens settings and selects "priority" as the column field
+  then:
+    - View.projection.pivotFieldId updated to "priority"
+    - board re-renders with columns derived from "priority" enum values
+```
+
+---
+
+## Appendix: Extension Definitions
+
+```mdl
+ext type
+  uri: org.dxos.mdl.type@1.0
+  desc: A named data structure with typed fields and optional literals.
+  fields:
+    desc?: Prose
+    fields?: FieldMap
+    literals?: UnionList
+    extends?: TypeRef[]
+```
+
+```mdl
+ext feat
+  uri: org.dxos.mdl.feat@1.0
+  desc: A named feature grouping one or more requirements.
+  fields:
+    desc?: Prose
+    req: RequirementList
+  nesting: self
+```
+
+```mdl
+ext test
+  uri: org.dxos.mdl.test@1.0
+  desc: An acceptance scenario expressed as given / when / then steps.
+  fields:
+    given?: Step | Step[]
+    when?: Step | Step[]
+    then: Step | Step[]
+    tags?: TagList
+```
+
+```mdl
+ext component
+  uri: org.dxos.mdl.component@1.0
+  desc: A UI component with props, internal state, slots, actions, and events.
+  fields:
+    desc?: Prose
+    props?: FieldMap
+    state?: FieldMap
+    slots?: FieldMap
+    actions?: ActionMap
+    emits?: EventMap
+    layout?: CodeBlock
+```
+
+```mdl
+ext op
+  uri: org.dxos.mdl.op@1.0
+  desc: |
+    A named operation with typed inputs, outputs, and declared errors.
+    Pure ops have no effects or requires. Effectful ops declare both.
+  fields:
+    desc?: Prose
+    input?: FieldMap
+    output?: TypeExpr
+    errors?: ErrorMap
+    effects?: EffectList
+    requires?: ServiceList
+    note?: Prose
+```

package/README.md

@@ -12,4 +12,4 @@ Surface plugin for kanban entities.
 
 Your ideas, issues, and code are most welcome. Please take a look at our [community code of conduct](https://github.com/dxos/dxos/blob/main/CODE_OF_CONDUCT.md), the [issue guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-issues), and the [PR contribution guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-prs).
 
-License: [MIT](./LICENSE) Copyright 2023 © DXOS
+License: [FSL-1.1-Apache-2.0](./LICENSE) Copyright 2023 © DXOS

package/dist/lib/neutral/KanbanArticle-V3UCZQB6.mjs

@@ -0,0 +1,133 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/KanbanArticle/KanbanArticle.tsx
+import { Atom, RegistryContext } from "@effect-atom/atom-react";
+import React, { useCallback, useContext, useMemo } from "react";
+import { useCapabilities, useOperationInvoker } from "@dxos/app-framework/ui";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { useSchemaFilter } from "@dxos/app-toolkit/ui";
+import { Filter, Obj, Query, Type } from "@dxos/echo";
+import { AtomObj, AtomQuery } from "@dxos/echo-atom";
+import { useObject, useType } from "@dxos/react-client/echo";
+import { Panel, Toolbar } from "@dxos/react-ui";
+import { getTagFromQuery, getTypenameFromQuery } from "@dxos/schema";
+import { KanbanBoard } from "#components";
+import { useEchoChangeCallback, useItemsProjection, useProjectionModel } from "#hooks";
+import { KanbanOperation } from "#types";
+import { Kanban } from "#types";
+var KanbanArticle = (props) => {
+  return Kanban.isKanbanItems(props.subject) ? /* @__PURE__ */ React.createElement(ItemsKanbanArticle, {
+    ...props,
+    subject: props.subject
+  }) : /* @__PURE__ */ React.createElement(ViewKanbanArticle, props);
+};
+var ViewKanbanArticle = ({ role, subject: object }) => {
+  const registry = useContext(RegistryContext);
+  const schemas = useCapabilities(AppCapabilities.Schema);
+  const db = Obj.getDatabase(object);
+  const { invokePromise } = useOperationInvoker();
+  const [view] = useObject(object.spec.kind === "view" ? object.spec.view : void 0);
+  const typename = view?.query ? getTypenameFromQuery(view.query.ast) : void 0;
+  const tag = view?.query ? getTagFromQuery(view.query.ast) : void 0;
+  const schemaFromDb = useType(db, typename);
+  const cardSchema = useMemo(() => schemaFromDb ?? schemas.flat().find((schema) => Type.getTypename(schema) === typename), [
+    schemaFromDb,
+    schemas,
+    typename
+  ]);
+  const baseFilter = useSchemaFilter(cardSchema);
+  const items = useMemo(() => {
+    if (!db) {
+      return null;
+    }
+    const query = tag ? Query.select(baseFilter).select(Filter.tag(tag)) : Query.select(baseFilter);
+    return AtomQuery.make(db, query);
+  }, [
+    db,
+    baseFilter,
+    tag
+  ]);
+  const projection = useProjectionModel(cardSchema, object, registry);
+  const change = useEchoChangeCallback(object);
+  const pivotFieldId = view?.projection?.pivotFieldId;
+  const columnFieldPath = projection && pivotFieldId ? projection.tryGetFieldProjection(pivotFieldId)?.props.property : void 0;
+  const handleCardAdd = useCallback((columnValue) => {
+    if (db && cardSchema && columnFieldPath) {
+      const card = Obj.make(Type.assertObject(cardSchema), {
+        [columnFieldPath]: columnValue
+      });
+      db.add(card);
+      return card.id;
+    }
+  }, [
+    db,
+    cardSchema,
+    columnFieldPath
+  ]);
+  const handleCardRemove = useCallback((card) => {
+    void invokePromise(KanbanOperation.DeleteCard, {
+      card
+    });
+  }, [
+    invokePromise
+  ]);
+  if (!object || !db || !items || !projection || !change) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(Panel.Root, {
+    role
+  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(Toolbar.Root, null)), /* @__PURE__ */ React.createElement(KanbanBoard.Root, {
+    kanban: object,
+    projection,
+    items,
+    change,
+    onCardAdd: handleCardAdd,
+    onCardRemove: handleCardRemove
+  }, /* @__PURE__ */ React.createElement(Panel.Content, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(KanbanBoard.Content, null))));
+};
+var ItemsKanbanArticle = ({ role, subject: object }) => {
+  const db = Obj.getDatabase(object);
+  const projection = useItemsProjection(object);
+  const change = useEchoChangeCallback(object);
+  const itemsAtom = useMemo(() => Atom.make((get) => {
+    const out = [];
+    for (const ref of object.spec.items) {
+      const target = get(AtomObj.make(ref));
+      if (target == null) {
+        continue;
+      }
+      if (Obj.isDeleted(target)) {
+        continue;
+      }
+      out.push(target);
+    }
+    return out;
+  }), [
+    object.spec.items
+  ]);
+  const handleCardRemove = useCallback(() => void 0, []);
+  if (!object || !db || !change) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(Panel.Root, {
+    role
+  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(Toolbar.Root, null)), /* @__PURE__ */ React.createElement(KanbanBoard.Root, {
+    kanban: object,
+    projection,
+    items: itemsAtom,
+    change,
+    onCardRemove: handleCardRemove
+  }, /* @__PURE__ */ React.createElement(Panel.Content, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(KanbanBoard.Content, null))));
+};
+export {
+  KanbanArticle as default
+};
+//# sourceMappingURL=KanbanArticle-V3UCZQB6.mjs.map

package/dist/lib/neutral/KanbanArticle-V3UCZQB6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/KanbanArticle/KanbanArticle.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Atom, RegistryContext } from '@effect-atom/atom-react';\nimport React, { useCallback, useContext, useMemo } from 'react';\n\nimport { useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { useSchemaFilter, type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Filter, Obj, Query, type Ref, Type } from '@dxos/echo';\nimport { AtomObj, AtomQuery } from '@dxos/echo-atom';\nimport { useObject, useType } from '@dxos/react-client/echo';\nimport { Panel, Toolbar } from '@dxos/react-ui';\nimport { getTagFromQuery, getTypenameFromQuery } from '@dxos/schema';\n\nimport { KanbanBoard } from '#components';\nimport { useEchoChangeCallback, useItemsProjection, useProjectionModel } from '#hooks';\nimport { KanbanOperation } from '#types';\nimport { Kanban } from '#types';\n\nexport type KanbanArticleProps = AppSurface.ObjectArticleProps<Kanban.Kanban>;\n\nexport const KanbanArticle = (props: KanbanArticleProps) => {\n  // Branch on `kanban.spec.kind`: view-variant runs a typename query through\n  // `useProjectionModel`; items-variant dereferences `kanban.spec.items` and\n  // uses a stub projection from `useItemsProjection`.\n  return Kanban.isKanbanItems(props.subject) ? (\n    <ItemsKanbanArticle {...props} subject={props.subject} />\n  ) : (\n    <ViewKanbanArticle {...props} />\n  );\n};\n\nconst ViewKanbanArticle = ({ role, subject: object }: KanbanArticleProps) => {\n  const registry = useContext(RegistryContext);\n  const schemas = useCapabilities(AppCapabilities.Schema);\n  const db = Obj.getDatabase(object);\n  const { invokePromise } = useOperationInvoker();\n  const [view] = useObject(object.spec.kind === 'view' ? object.spec.view : undefined);\n  const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;\n  const tag = view?.query ? getTagFromQuery(view.query.ast) : undefined;\n\n  const schemaFromDb = useType(db, typename);\n  const cardSchema = useMemo(\n    () => schemaFromDb ?? schemas.flat().find((schema) => Type.getTypename(schema) === typename),\n    [schemaFromDb, schemas, typename],\n  );\n\n  const baseFilter = useSchemaFilter(cardSchema);\n  const items = useMemo(() => {\n    if (!db) {\n      return null;\n    }\n    const query = tag ? Query.select(baseFilter).select(Filter.tag(tag)) : Query.select(baseFilter);\n    return AtomQuery.make(db, query);\n  }, [db, baseFilter, tag]);\n\n  const projection = useProjectionModel(cardSchema, object, registry);\n  const change = useEchoChangeCallback(object);\n\n  const pivotFieldId = view?.projection?.pivotFieldId;\n  const columnFieldPath =\n    projection && pivotFieldId ? projection.tryGetFieldProjection(pivotFieldId)?.props.property : undefined;\n\n  const handleCardAdd = useCallback(\n    (columnValue: string | undefined) => {\n      if (db && cardSchema && columnFieldPath) {\n        const card = Obj.make(Type.assertObject(cardSchema), {\n          [columnFieldPath]: columnValue,\n        });\n        db.add(card);\n        return card.id;\n      }\n    },\n    [db, cardSchema, columnFieldPath],\n  );\n\n  const handleCardRemove = useCallback(\n    (card: { id: string }) => {\n      void invokePromise(KanbanOperation.DeleteCard, { card });\n    },\n    [invokePromise],\n  );\n\n  if (!object || !db || !items || !projection || !change) {\n    return null;\n  }\n\n  return (\n    <Panel.Root role={role}>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root />\n      </Panel.Toolbar>\n      <KanbanBoard.Root\n        kanban={object}\n        projection={projection}\n        items={items}\n        change={change}\n        onCardAdd={handleCardAdd}\n        onCardRemove={handleCardRemove}\n      >\n        <Panel.Content asChild>\n          <KanbanBoard.Content />\n        </Panel.Content>\n      </KanbanBoard.Root>\n    </Panel.Root>\n  );\n};\n\ntype ItemsKanbanArticleProps = Omit<KanbanArticleProps, 'subject'> & { subject: Kanban.KanbanItems };\n\nconst ItemsKanbanArticle = ({ role, subject: object }: ItemsKanbanArticleProps) => {\n  const db = Obj.getDatabase(object);\n  const projection = useItemsProjection(object);\n  const change = useEchoChangeCallback(object);\n\n  // TODO(wittjosiah): pass refs (not loaded objects) through to the kanban\n  //   board and let `KanbanCard` subscribe to its own ref via `useObject`.\n  //   Today this atom subscribes to *every* item — any one changing causes the\n  //   container (and the model's per-column atoms) to recompute. With cards\n  //   subscribing themselves, the container only needs the refs and the\n  //   per-card render is independent. Requires:\n  //     - `KanbanCard` to accept `Ref<Obj.Unknown>` as `data` and call\n  //       `useObject(ref)` internally.\n  //     - The model to handle a ref-bearing item shape (id from\n  //       `ref.dxn.asEchoDXN()?.echoUri`) and use arrangement-only ordering\n  //       for items-variant (no pivot-value fallback, since refs don't expose\n  //       the pivot field without loading).\n  //     - `Mosaic.isItem` to accept the ref wrapper alongside `Obj.isObject`.\n  const itemsAtom = useMemo(\n    () =>\n      Atom.make((get) => {\n        const out: Obj.Unknown[] = [];\n        for (const ref of object.spec.items as ReadonlyArray<Ref.Ref<Obj.Unknown>>) {\n          const target = get(AtomObj.make(ref));\n          if (target == null) {\n            continue;\n          }\n          // Drop soft-deleted cards (e.g. Trello-closed cards). The ref\n          // stays in `spec.items` so arrangement is preserved, but the card\n          // shouldn't render.\n          if (Obj.isDeleted(target)) {\n            continue;\n          }\n          out.push(target as unknown as Obj.Unknown);\n        }\n        return out;\n      }),\n    [object.spec.items],\n  );\n\n  const handleCardRemove = useCallback(() => undefined, []);\n\n  if (!object || !db || !change) {\n    return null;\n  }\n\n  // TODO(wittjosiah): wire `onCardAdd` to the create-object flow so\n  //   users can add items directly from the kanban (currently the column's\n  //   \"+\" button is hidden because `onCardAdd` is undefined).\n  return (\n    <Panel.Root role={role}>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root />\n      </Panel.Toolbar>\n      <KanbanBoard.Root\n        kanban={object}\n        projection={projection}\n        items={itemsAtom}\n        change={change}\n        onCardRemove={handleCardRemove}\n      >\n        <Panel.Content asChild>\n          <KanbanBoard.Content />\n        </Panel.Content>\n      </KanbanBoard.Root>\n    </Panel.Root>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["Atom", "RegistryContext", "React", "useCallback", "useContext", "useMemo", "useCapabilities", "useOperationInvoker", "AppCapabilities", "useSchemaFilter", "Filter", "Obj", "Query", "Type", "AtomObj", "AtomQuery", "useObject", "useType", "Panel", "Toolbar", "getTagFromQuery", "getTypenameFromQuery", "KanbanBoard", "useEchoChangeCallback", "useItemsProjection", "useProjectionModel", "KanbanOperation", "Kanban", "KanbanArticle", "props", "isKanbanItems", "subject", "ItemsKanbanArticle", "ViewKanbanArticle", "role", "object", "registry", "schemas", "Schema", "db", "getDatabase", "invokePromise", "view", "spec", "kind", "undefined", "typename", "query", "ast", "tag", "schemaFromDb", "cardSchema", "flat", "find", "schema", "getTypename", "baseFilter", "items", "select", "make", "projection", "change", "pivotFieldId", "columnFieldPath", "tryGetFieldProjection", "property", "handleCardAdd", "columnValue", "card", "assertObject", "add", "id", "handleCardRemove", "DeleteCard", "Root", "asChild", "kanban", "onCardAdd", "onCardRemove", "Content", "itemsAtom", "get", "out", "ref", "target", "isDeleted", "push"]
+}