mirror of
https://github.com/storytold/gridcraft.git
synced 2026-10-27 12:16:54 -06:00
vangel76andClaude Opus 5.5
ed62390244
Pass-through of package content GridCraft does not model: on read the raw parts are kept with their content types and relationship graph per owner (package root, workbook, sheet); on write they get fresh part names where needed and new relationship ids, and the r:ids in kept XML are rewritten. Kept: custom document properties, ribbon customisation, add-in task panes, custom XML, links to external workbooks with <externalReferences> (never followed), connections, sheet query tables, printer settings with the <pageSetup r:id> (#324), form and ActiveX controls, OLE objects and sheet backgrounds with their VML shapes (merged with GridCraft's note shapes). Content whose graph reaches parts GridCraft rewrites is dropped with a warning; sheet content goes with its sheet and is not copied by Copy Sheet. Fixes #324 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
71 lines
2.9 KiB
Rust
71 lines
2.9 KiB
Rust
//! File content GridCraft does not model, carried through unchanged so that saving a workbook
|
|
//! never silently drops it (XLSX pass-through: custom XML, external links, connections, query
|
|
//! tables, form controls, OLE objects…).
|
|
//!
|
|
//! The data is opaque to everything except the file-format crate: the model only holds it, so a
|
|
//! sheet's kept content disappears with the sheet. It is not part of the JSON format.
|
|
|
|
use std::sync::Arc;
|
|
|
|
/// A relationship from an owning part (the package root, the workbook or a sheet, or a kept part)
|
|
/// to a kept part or to an external target.
|
|
#[derive(Clone, Debug, Default, PartialEq, Eq)]
|
|
pub struct PreservedRel {
|
|
/// The id in the source file (`rId7`). Ids of an owner GridCraft writes are reassigned on save.
|
|
pub id: String,
|
|
/// The full relationship type URI.
|
|
pub rel_type: String,
|
|
/// The original part name of the target (no leading `/`), or the raw target of an external
|
|
/// relationship. External targets are never opened.
|
|
pub target: String,
|
|
pub external: bool,
|
|
}
|
|
|
|
/// A kept package part.
|
|
#[derive(Clone, Debug, Default, PartialEq, Eq)]
|
|
pub struct PreservedPart {
|
|
/// Part name in the source file (no leading `/`).
|
|
pub name: String,
|
|
pub content_type: String,
|
|
pub data: Arc<[u8]>,
|
|
/// The part's own relationships, ids unchanged (the part's bytes refer to them).
|
|
pub rels: Vec<PreservedRel>,
|
|
}
|
|
|
|
/// A raw XML element of an owning part that refers to kept parts, re-emitted on save with its
|
|
/// relationship ids rewritten.
|
|
#[derive(Clone, Debug, Default, PartialEq, Eq)]
|
|
pub struct PreservedXml {
|
|
/// Which slot of the owner it belongs in (`externalReferences`, `oleObjects`, `controls`).
|
|
pub slot: String,
|
|
/// The element, namespace declarations it needs included.
|
|
pub xml: String,
|
|
}
|
|
|
|
/// Unmodelled content kept for one owner (the workbook, which also holds package-root content,
|
|
/// or one sheet).
|
|
#[derive(Clone, Debug, Default, PartialEq, Eq)]
|
|
pub struct Preserved {
|
|
/// Relationships of the package root (`_rels/.rels`) to kept parts (workbook owner only).
|
|
pub package_rels: Vec<PreservedRel>,
|
|
/// Relationships of the owning workbook or sheet part to kept parts.
|
|
pub rels: Vec<PreservedRel>,
|
|
/// Every kept part reachable from `package_rels` and `rels`.
|
|
pub parts: Vec<PreservedPart>,
|
|
/// Owner XML elements that refer to kept parts.
|
|
pub elements: Vec<PreservedXml>,
|
|
/// The sheet's legacy VML drawing when kept elements need its shapes (form controls, OLE
|
|
/// objects). Its own relationships point into `parts`.
|
|
pub vml: Option<PreservedPart>,
|
|
}
|
|
|
|
impl Preserved {
|
|
pub fn is_empty(&self) -> bool {
|
|
self.package_rels.is_empty() && self.rels.is_empty() && self.parts.is_empty() && self.elements.is_empty() && self.vml.is_none()
|
|
}
|
|
/// Total bytes held.
|
|
pub fn byte_len(&self) -> usize {
|
|
self.parts.iter().chain(self.vml.iter()).fold(0usize, |n, p| n.saturating_add(p.data.len()))
|
|
}
|
|
}
|