@calcit/procs 0.12.46 → 0.12.48

package/editing-history/2026-06-16-1700-effects-graph-ste-tree.md

@@ -0,0 +1,84 @@
+# effects-graph STE Tree 格式改进
+
+日期: 2026-06-16
+
+## 问题
+
+`cr analyze effects-graph` 默认 `sketch` 格式产出的是项目级鸟瞰图（调用树+聚合 effect/state），而非 RFC 预想的 per-function State/Transform/Effect 分解图。用户无法通过输出快速理解单个函数的功能。
+
+## 改动
+
+### 1. State 提取：从操作名改为目标名
+
+`record_state_operator` 原先记录操作名（如 `swap!`），现改为提取目标 atom 名称（如 `*store`）。
+
+- 新增 `extract_state_target(list, op_name)` 从 AST 列表中提取第一个参数
+- `swap!/reset!/deref/set!` → 提取第一个参数名
+- `defatom/atom` → 提取第一个参数名
+- 修改 `walk_expr` → `inspect_call_head` 传参，传入完整 list
+
+### 2. Effect 分类：添加 Respo 约定函数
+
+`classify_by_name` 新增：
+- `render-app!/mount-app!/rerender-app!/clear-cache!/realize-ssr!` → `render`
+- `send-to-component!/dispatch!` → `lifecycle`
+- `save-store!` → `storage`
+
+`heuristic_effect_kinds` 优化：
+- `unknown/effect!` → `effect`（更简洁）
+- 函数名含 `load/init/setup` 时归类为 `io`
+
+`set!` 加入 `is_state_operator` 和 early-return 列表（之前会被误分类为 effect）
+
+### 3. 深度截断节点保留分析
+
+原先 `max_depth` 到达时直接返回空壳节点（`empty_shell_node`）。
+现改为：始终执行 `analyze_code` 提取 state/effects/transform，仅在 children 构建时跳过。
+新增 `depth_exceeded` 字段标记截断节点。
+
+### 4. STE Tree 格式（`--format tree`）
+
+新增 `format_as_ste_tree` 函数，输出每个函数的 State/Transform/Effect 树形分解：
+
+```
+└── respo.main/main!  [program]
+    ├── State
+    │   ├── atom     *store (write)
+    │   ├── return   unit
+    │   └── watch    *store
+    ├── Transform  (calls: 3)
+    │   ├── → respo.app.core/render-app!
+    │   └── → respo.main/save-store!
+    └── Effects
+        ├── console        println
+        ├── render         render-app!
+        └── storage        save-store!
+```
+
+- `[program]` = 含 effect 的函数
+- `[transform]` = 纯变换函数
+- `[depth limit ↑]` = 深度截断（有分析但无子节点）
+- `(summary)` = 折叠节点的单行摘要（doc + effects）
+
+`cr.rs` 中 `format=tree` 调度改为 `format_as_ste_tree`（原为 `format_for_llm` mermaid）。
+
+### 5. 其他修复
+
+- `birdview_state_labels` 匹配逻辑修复（kind 匹配而非 name 匹配）
+- `effect_channel_name` 新增 `storage`/`lifecycle` 通道映射
+- `ste_state_detail` 对 `return` 类型简化显示（仅类型，不显 "return" 前缀）
+- `node_transform_summary` 修复 doc 与 summary 重复问题
+- `empty_shell_node` 函数删除（不再使用）
+
+## 涉及文件
+
+- `src/effects_graph.rs` — 主要改动
+- `src/bin/cr.rs` — tree 格式调度
+- `src/cli_args.rs` — 无改动（格式字符串不变）
+
+## 验证
+
+- `cargo test effects_graph` — 5/5 通过
+- `cargo clippy -- -D warnings` — 通过
+- `yarn compile` — 通过
+- `cr analyze effects-graph --format tree` on respo — 产出可用的 per-function STE 分解

package/editing-history/2026-06-27-0052-cli-improvements.md

@@ -0,0 +1,41 @@
+## CLI 改进: target-replace → search-replace, 新增 batch-delete, --parent-path
+
+### 改动机
+根据 pudica-schedule-viewer 升级过程中暴露的多次 cr 命令使用痛点:
+
+1. `target-replace` 命名不直观（"目标替换"不如"搜索替换"清晰）
+2. 连续删除多个属性时需要手动从高到低删除，容易出错
+3. 搜索结果的路径是叶子路径，用户需要手动去掉末尾索引得到可编辑父路径
+4. map 属性中用 `$` 编辑的规则未在文档中明确
+
+### 改动清单
+
+**src/cli_args.rs:**
+- `TargetReplace(TreeTargetReplaceCommand)` → `SearchReplace(TreeSearchReplaceCommand)`
+- `#[argh(subcommand, name = "target-replace")]` → `#[argh(subcommand, name = "search-replace")]`
+- 新增 `BatchDelete(TreeBatchDeleteCommand)` 枚举变体
+- 新增 `TreeBatchDeleteCommand` 结构体（`-p` 接受多个路径）
+- `QuerySearchCommand` 新增 `--parent-path` 开关
+
+**src/bin/cli_handlers/tree.rs:**
+- `handle_target_replace` → `handle_search_replace`
+- 新增 `handle_batch_delete`: 按路径降序依次调用 `handle_delete`
+
+**src/bin/cli_handlers/query.rs:**
+- `SearchCommonOpts` 新增 `parent_path: bool` 字段
+- 搜索结果中 `--parent-path` 开启时额外打印父路径
+
+**src/bin/cli_handlers/command_echo.rs:**
+- 更新所有 `TargetReplace` → `SearchReplace` 分发
+- 新增 `BatchDelete` 的三个 match arm
+
+**src/bin/cli_handlers/edit.rs:**
+- 错误提示 `target-replace` → `search-replace`
+
+**src/bin/cli_handlers/docs_tests.rs:**
+- 测试数据中 `target-replace` → `search-replace`
+
+**docs/CalcitAgent.md + 其他文档:**
+- 所有 `target-replace` 替换为 `search-replace`
+- 新增 `batch-delete` 和 `--parent-path` 用法说明
+- 新增 `$` 在属性 map 中的编辑指南

package/editing-history/2026-06-27-0202-docs-indexing-improvements.md

@@ -0,0 +1,22 @@
+## 文档索引改进: abstract 字段 + --summary 模式 + Hub 标记
+
+### 改动内容
+
+**P0: abstract/summary 字段**
+- `GuideDocFrontmatter` 新增 `summary: Option<String>` 字段
+- `parse_doc_frontmatter` 支持解析 `summary:` 键值对
+- `score_metadata_hit` 加入 summary 评分（exact 200，contains 130）
+- 8 个核心文档已添加 summary 描述
+
+**P0: `cr docs search --summary` 模式**
+- `DocsSearchCommand` 新增 `--summary` 开关
+- 搜索时只显示文档标题 + summary，不输出内容片段
+- 无 summary 的文档显示 `(no summary)`
+
+**P0: Hub 标记**
+- 搜索结果中 `kind: hub` 的文档显示 `[Hub]` 前缀
+- 帮助 LLM 快速识别导航页 vs 详细页
+
+**文档更新**
+- `docs-indexing.md` 新增 `summary` 字段规范说明和 `--summary` 用法
+- `docs-validation.md` 新增 `--summary` 和 hub 标记的验证用例

package/editing-history/2026-06-27-0315-file-splits.md

@@ -0,0 +1,17 @@
+## 文档拆分: agent-advanced.md 和 CalcitAgent.md 的部分内容拆成独立文件
+
+### 改动内容
+
+**从 `run/agent-advanced.md` 拆分:**
+- `## 快速开始` 节 (原 lines 24-58) → 新建 `run/quick-start.md` (47行)
+- 原文替换为交叉链接
+
+**从 `CalcitAgent.md` 拆分:**
+- `calcit.cirru EDN 结构` + `deps.cirru` 两节 (原 lines 156-231) → 新建 `run/project-structure.md` (82行)
+- `结构化策略（5 招）` 节 → 新建 `run/structural-strategies.md` (53行)
+- 原文替换为交叉链接
+
+### 新文件
+- `docs/run/quick-start.md` — 新 LLM 快速开始工作流
+- `docs/run/project-structure.md` — calcit.cirru EDN 结构 + deps.cirru
+- `docs/run/structural-strategies.md` — cp/mv/wrap/raise/rewrite 策略

package/editing-history/2026-06-27-0416-agent-advanced-split.md

@@ -0,0 +1,15 @@
+## agent-advanced.md 拆分: CLI 命令和语言基础节替换为交叉链接, 开发调试拆出独立文件
+
+### 改动
+
+**`run/agent-advanced.md` 精简 (1598→807 行, ~49%):**
+
+- `## Calcit CLI 命令` 节 (~508行): 替换为独立文件链接列表，保留 `LLM 辅助：动态方法提示` 和 `复杂表达式分段组装策略` 两个独特子节
+- `## Calcit 语言基础` 节 (~266行): 替换为 cirru-syntax.md / features/tuples.md / features/static-analysis.md 链接，保留 `其他易错点`
+- `## 开发调试` 节 (~99行): 拆出为独立 `run/debugging.md`
+
+**新增文件:**
+- `run/debugging.md` — watcher 监听模式、增量更新、编译检查
+
+### 删除的重复内容
+CLI 命令和语言基础的子节内容在 `run/query.md`、`run/edit-tree.md`、`cirru-syntax.md`、`features/static-analysis.md` 等文件中已有完整覆盖。

package/editing-history/202607040040-fix-format-cirru-edn-quoting.md

@@ -0,0 +1,14 @@
+## fix format-cirru-edn missing quotes for strings with spaces in JS codegen
+
+### 问题
+`format-cirru-edn` 在 JS runtime 中对含空格的字符串（如 `"a b"`）输出缺少外层双引号，产生 `|a b` 而非正确的 `"|a b"`。
+
+### 定位
+`ts-src/js-cirru.mts:439` — `format_cirru_edn` 对字符串类型直接拼接 `"\ndo " + to_cirru_edn(data)`，跳过了 `writer.ts` 中 `generateLeaf` 的 `JSON.stringify` 引号回退逻辑。
+
+### 修复
+改为走 `writeCirruCode([[to_cirru_edn(data)]])` → `generateLeaf` 路径，利用已有的字符合法性检查（`isCharAllowed`）决定是否加引号。同时保持 `\ndo ... \n` 外围格式与 Rust 版本一致。
+
+### 文件变更
+- `ts-src/js-cirru.mts` — 字符串分支改用 `writeCirruCode` 格式化
+- `calcit/test-edn.cirru` — 新增含空格字符串和无空格字符串的测试用例

package/editing-history/archived/2026-06-20-1142-ts-declaration-d-mts.md

@@ -0,0 +1,5 @@
+- `tsconfig.json` 添加 `declaration: true`，使 `yarn compile` 生成 `.d.mts` 类型声明文件
+- `yarn compile` 后 `lib/` 中与 `.mjs` 一一对应生成 18 个 `.d.mts` 文件
+- `.npmignore` 不排除 `lib/`，这些声明文件在 npm publish 时会被包含
+- 对 hovenia-editor：移除手动 `calcit-procs.d.ts`，改用上游生成的 `.d.mts`
+- 本地验证：`cargo fmt` `cargo clippy` `yarn compile` `cargo test` `yarn check-all` 全部通过

package/editing-history/archived/2026-06-29-0117-upgrade-doc-snapshot-migration.md

@@ -0,0 +1,2 @@
+- docs/run/upgrade.md: added snapshot migration section — documents the transition from two-file setup (calcit.cirru snapshot + compact.cirru compact code) to single calcit.cirru with compact code only, no separate snapshot file needed
+- Recommended: delete old snapshot file, compact code saved directly in calcit.cirru for cr command to use directly

package/editing-history/archived/2026-06-29-calcit-cli.md

@@ -0,0 +1,80 @@
+# calcit.cli / cr exec 完整实现
+
+## 概要
+
+实现 `cr exec` + `calcit.cli/*` 内建函数（共 77 个），让 Agent 用 Cirru heredoc 调用常用 `cr query` / `edit` / `tree` / `analyze` / `docs` 能力，绕开 Shell 转义。RFC：`RFCs/06-29-cr-exec-cli-builtins-rfc.md`。
+
+## 架构
+
+- **运行时**：`src/bin/injection/mod.rs` 注册 handler；**单一 options map 参数**（arity 1）
+- **参数解析**：`calcit_cli_args.rs` — `resolve_cli_args`、类型 coercion、默认值填充、command echo
+- **参数规格**：`calcit_cli_specs.rs` — 每个函数的 `CliArgSpec` 列表（语义化键名）
+- **元数据**：`src/cirru/calcit-core.cirru` 的 `|calcit.cli` — schema 为 `(:args $ [] (:: :map :tag :dynamic))`
+- **同步**：`python3 scripts/gen_calcit_cli_core.py`（从 mod.rs + calcit_cli_specs.rs 生成）
+- **约束**：`calcit_cli*` 不得依赖 `cli_handlers`（保证 `cr-wasm` 可编译）
+
+### 调用约定（2026-06-29 重构）
+
+```cirru
+calcit.cli/peek-def $ {} (:file-path |calcit.cirru) (:target |app.main/main!)
+```
+
+- 唯一参数为 options map；键为 tag（`:file-path`、`:target`、`:lines` 等）
+- 省略的可选键由 Rust 侧默认值填充；非 quiet 模式下 stderr echo 展示完整调用（含默认值）
+- 位置参数已移除（breaking change）
+
+| 文件 | 职责 |
+|------|------|
+| `calcit_cli_args.rs` | map 解析、echo、docs_hint 生成 |
+| `calcit_cli_specs.rs` | 77 个函数的参数 spec 常量 |
+| `calcit_cli.rs` | 基础 query/write、snapshot 读写、`load_calcit_snapshot_with_deps` |
+| `calcit_cli_tree.rs` | AST 树变换（delete/insert/wrap/cp/mv…） |
+| `calcit_cli_extra.rs` | edit/config/cirru 工具、trigger-inc、semver bump |
+| `calcit_cli_program.rs` | 加载 snapshot+modules+core 并 preprocess（analyze/validate） |
+| `calcit_cli_analyze.rs` | call/effects/count + check-types/weak-types |
+| `calcit_cli_query.rs` | show-pkg/ns、list-defs-by-tag、validate-file、search-*、list-host-procs |
+| `calcit_cli_docs.rs` | docs-agents/read/sections |
+| `src/type_coverage.rs` | check-types / weak-types 共享逻辑（`cr analyze` 与 calcit.cli 共用） |
+
+## 分批功能（合并记录）
+
+### 第一批：树/定义/import 写操作（17）
+
+`tree-delete` `tree-insert` `tree-wrap` `tree-unwrap` `tree-raise` `tree-cp` `tree-mv` `rename-def` `rm-def` `mv-def` `split-def` `add-ns` `edit-doc` `edit-schema` `add-example` `rm-import` `show-error`
+
+要点：`tree-wrap` 用 `self` leaf；`position` 同 CLI（`|before` `|after` 等）。
+
+### 第二批：edit/config/cirru（20）
+
+`rm-ns` `set-imports` `format-file` `show-doc` `show-ns-doc` `list-tags` `set-tags` `rm-example` `clear-examples` `set-examples` `tree-replace-leaf` `tree-swap-*` `tree-batch-delete` `tree-rewrite` `set-config` `add/rm-module` `cirru-parse/format` `read-text-file`
+
+修复：`build_ns_code` 对齐 `(ns name (:require ...))` 嵌套结构。
+
+### 第三批：analyze / inc / docs 搜索（9）
+
+`trigger-inc` `cirru-parse-edn` `cirru-show-guide` `docs-search` `tree-replace-leaf-regex` `analyze-call-graph` `analyze-effects-graph` `analyze-count-calls`
+
+### 第四批：P0–P3（15）
+
+- **P0**：`show-pkg` `show-ns` `list-defs-by-tag` `validate-file` `bump-version` `edit-ns-doc`
+- **P1**：`search-project` `search-def-regex` `search-expr` `list-host-procs`
+- **P2**：`analyze-check-types` `analyze-weak-types`（依赖 `type_coverage` 提取）
+- **P3**：`docs-agents` `docs-read` `docs-sections`
+
+### Core 声明 + 预处理
+
+- core 可选参数 schema 用 `(:rest :dynamic)`，勿写 `:rest $ :dynamic`（EDN 解析失败）
+- 预处理：`is_registered_proc` 必须在 `has_def_code` 之前，避免 core 元数据 stub 被当作普通 def 编译（`preprocess/mod.rs`）
+
+## 验证
+
+```bash
+python3 scripts/gen_calcit_cli_core.py
+unset CARGO_TARGET_DIR && cargo fmt
+cargo clippy --all-targets -- -D warnings
+cargo test --bin cr
+./target/debug/cr calcit/test.cirru exec << 'EOF'
+calcit.cli/show-pkg $ {} (:file-path |calcit/test.cirru)
+calcit.cli/validate-file $ {} (:file-path |calcit/test.cirru)
+EOF
+```

package/editing-history/archived/2026-06-29-typed-calcit-cli-schemas.md

@@ -0,0 +1,23 @@
+# calcit.cli 选项 map 类型化 schema（Rust spec 直检）
+
+## 变更概要
+
+- 选项 spec 收敛到 `src/builtins/cli_options.rs`（Rust 单一来源），注册时写入 `RegisteredProcDescriptor.cli_options`。
+- preprocess 直接读 Rust spec 校验 options map，不再生成 defstruct / 不做 map→record 转换。
+- core 中 `:args` 仍由脚本生成 inline 类型 map（供 query/docs），校验走 Rust 而非 Calcit 类型系统。
+
+## 后续优化（Rust spec 直检）
+
+- preprocess 热路径改用 `registered_proc_cli_options()`，不再 clone 整个 `RegisteredProcDescriptor`。
+- `registered_proc_has_tag` 同样改为只读 map 查询。
+- `check_cli_options_map` 与 `resolve_cli_args` 共用 `collect_validation_errors`，preprocess 侧用引用收集 map 条目，避免多余 clone。
+- Registered 调用检查复用已有的 `processed_args`，去掉重复 `ys.drop_left()` 和 `alias` clone。
+
+## 验证案例（cr eval）
+
+| 案例 | 结果 |
+|------|------|
+| `:file-pth` 拼写错误 | `W_CLI_OPTION_UNKNOWN_KEY` |
+| 缺少 `:file-path` | `W_CLI_OPTION_MISSING_REQUIRED` |
+| `:lines \|bad` 类型错误 | `W_CLI_OPTION_TYPE_MISMATCH` |
+| 正确调用 | Check passed |

package/editing-history/archived/20260630-duplication-analysis.md

@@ -0,0 +1,116 @@
+# calcit.cli 与 CLI handlers 重复代码分析与重构方案
+
+时间: 2026-06-30
+作者: AI Agent
+
+## 现状
+
+### 两套独立实现
+
+| 方面 | `injection/calcit_cli*.rs` | `cli_handlers/*.rs` |
+|------|---------------------------|---------------------|
+| 代码量 | ~2714 行 | ~5967 行 |
+| 入口 | `fn(xs: Vec<Calcit>, _: &CallStackList) -> Result<Calcit, CalcitErr>` | `fn(opts: &SpecificCommandStruct, snapshot_file: &str) -> Result<(), String>` |
+| 参数解析 | `resolve_cli_args()` → `ResolvedCliArgs` (从 Calcit Map 中提取) | argh 自动解析 CLI 参数到结构体 |
+| 输出 | `Calcit::Str(...)` 返回给 Calcit 运行时 | `println!()` 直接输出 |
+| 快照加载 | `load_calcit_snapshot()` | `load_snapshot()` |
+| 快照保存 | `save_calcit_snapshot()` | `save_snapshot()` |
+
+### 完全重复的辅助函数
+
+| 函数 | injection/ 位置 | cli_handlers/ 位置 |
+|------|----------------|-------------------|
+| load_snapshot | calcit_cli.rs:1155 | edit.rs:101 |
+| save_snapshot | calcit_cli.rs:1217 | edit.rs:109 |
+| parse_path | calcit_cli.rs:933 | common.rs:182 |
+| navigate_to_node | calcit_cli.rs:905 | edit.rs:1267 |
+| parse_target | calcit_cli_args.rs (复用 cli_options) | edit.rs:22 |
+| check_ns_editable | calcit_cli.rs:1033 | edit.rs:114 |
+| apply_operation_at_path | calcit_cli_tree.rs | edit.rs:1152 |
+| process_node_with_references | calcit_cli_tree.rs | edit.rs:1290 |
+
+## 推荐的桥接方案
+
+### 方案: 提取共享核心 + 让 calcit.cli 代理到 cli_handlers
+
+不直接让 `calcit.cli` procs 调用 `cli_handlers`（因为接口类型不同），而是:
+
+1. **将核心业务逻辑（load → modify → save）提取到共享函数**，放在 `snapshot.rs` 或新建 `src/snapshot_ops.rs`
+2. **`cli_handlers` 调用共享函数**
+3. **`calcit.cli` 内部转发到共享函数**，而不是自己再实现一遍
+
+### 关键接口对齐
+
+calcit.cli proc 的处理流程:
+```
+Vec<Calcit> → resolve_cli_args() → ResolvedCliArgs → 提取参数 → 业务逻辑 → Calcit
+```
+
+CLI handler 的处理流程:
+```
+CLI struct → 提取参数 → 业务逻辑 → println!
+```
+
+共同点: 都需要 `(file_path, target, path, code)` 等参数, 都调用 `load_snapshot` / `save_snapshot` / `navigate_to_path` / `apply_operation_at_path`
+
+### 具体步骤
+
+1. 把 `load_snapshot`, `save_snapshot`, `navigate_to_path`, `parse_path`, `check_ns_editable`, `apply_operation_at_path`, `process_node_with_references` 等辅助函数统一放到 `src/snapshot_ops.rs` (或 `src/bin/cli_handlers/ops.rs`)
+2. 把每个业务操作（如 tree-replace、show-def、list-defs）提取为纯函数:
+   ```rust
+   pub fn op_tree_replace(snapshot: &mut Snapshot, ns: &str, def: &str, path: &[usize], new_node: &Cirru) -> Result<(), String>
+   pub fn op_show_def(snapshot: &Snapshot, ns: &str, def: &str) -> Result<String, String>
+   ```
+3. `calcit.cli` 的每个 proc handler 变成薄薄的代理层:
+   ```rust
+   pub fn tree_replace(xs: Vec<Calcit>, _cs: &CallStackList) -> Result<Calcit, CalcitErr> {
+     let args = resolve_cli_args("calcit.cli/tree-replace", &xs, TREE_REPLACE)?;
+     let mut snapshot = load_snapshot(&args.file_path()?)?;
+     let (ns, def) = args.target("target")?;
+     let path = parse_path(&args.string("path")?, false)?;
+     let code = args.cirru_quote("code")?;
+     ops::op_tree_replace(&mut snapshot, &ns, &def, &path, &code)?;
+     save_snapshot(&snapshot, &args.file_path()?)?;
+     Ok(Calcit::Str(Arc::from("replaced")))
+   }
+   ```
+4. CLI handlers 也变成薄代理:
+   ```rust
+   fn handle_replace(opts: &TreeReplaceCommand, snapshot_file: &str) -> Result<(), String> {
+     let (ns, def) = parse_target(&opts.target)?;
+     let path = parse_path(&opts.path)?;
+     let code = parse_input_to_cirru(...)?;
+     let mut snapshot = load_snapshot(snapshot_file)?;
+     ops::op_tree_replace(&mut snapshot, ns, def, &path, &code)?;
+     save_snapshot(&snapshot, snapshot_file)?;
+     // print preview...
+   }
+   ```
+
+### 收益
+- 消除 ~2000 行重复代码
+- 修复 bug 只需改一处
+- 新功能只需写一次共享逻辑
+
+### 风险
+- 大规模重构需要充分测试
+- 需要迁移 `calcit_cli_tree.rs` 中的复杂逻辑（rewrite with references）
+- `calcit.cli` 的 `CalcitErr` 错误类型和 `cli_handlers` 的 `String` 错误类型需要对齐
+
+## 代码规模统计
+
+```
+src/bin/injection/
+  calcit_cli.rs         1297 行  ← 需要拆解: 辅助函数 + proc handlers
+  calcit_cli_extra.rs    846 行  ← 同上
+  calcit_cli_tree.rs     232 行  ← 纯辅助函数, 可整体移出
+  calcit_cli_args.rs     147 行  ← 桥接层, 保留
+  calcit_cli_specs.rs    192 行  ← 参数规格定义, 保留
+  mod.rs                 ~60 行  ← 注册代码, 保留
+
+src/bin/cli_handlers/
+  edit.rs              2026 行  ← 辅助函数 + handler 逻辑
+  tree.rs              1433 行  ← handler 逻辑
+  query.rs             2135 行  ← handler 逻辑
+  common.rs             373 行  ← 工具函数
+```

package/lib/calcit-data.d.mts

@@ -0,0 +1,39 @@
+import { Hash } from "@calcit/ternary-tree";
+import { CalcitValue } from "./js-primes.mjs";
+import { CalcitRef } from "./js-ref.mjs";
+export declare class CalcitTag {
+    value: string;
+    cachedHash: Hash;
+    idx: number;
+    constructor(x: string);
+    toString(): string;
+    cmp(other: CalcitTag): number;
+}
+export declare class CalcitSymbol {
+    value: string;
+    cachedHash: Hash;
+    constructor(x: string);
+    toString(): string;
+}
+export declare class CalcitRecur {
+    args: CalcitValue[];
+    cachedHash: Hash;
+    constructor(xs: CalcitValue[]);
+    toString(): string;
+}
+export declare let isNestedCalcitData: (x: CalcitValue) => boolean;
+export declare let tipNestedCalcitData: (x: CalcitValue) => string;
+export type CalcitFn = (...xs: CalcitValue[]) => CalcitValue;
+export declare let getStringName: (x: CalcitValue) => string;
+/** returns -1 when not found */
+export declare function findInFields(xs: Array<CalcitTag>, y: CalcitTag): number;
+export declare let newTag: (content: string) => CalcitTag;
+export declare let castTag: (x: CalcitValue) => CalcitTag;
+export declare var refsRegistry: Map<string, CalcitRef>;
+export declare let hashFunction: (x: CalcitValue) => Hash;
+export declare let toString: (x: CalcitValue, escaped: boolean, disableJsDataWarning?: boolean) => string;
+export declare let to_js_data: (x: CalcitValue, addColon?: boolean) => any;
+export declare let _$n_map_$o_get: (xs: CalcitValue, k: CalcitValue) => CalcitValue;
+export declare let _$n__$e_: (x: CalcitValue, y: CalcitValue) => boolean;
+/** special trick for disabling ternary tree list check */
+export declare let disable_list_structure_check_$x_: () => void;