appcore-filemaker-cli

BÊTA PUBLIQUE — 0.1.0-beta.2 est publiée sur crates.io pour évaluation.

appcore-filemaker-cli 0.1.0-beta.2 est l'adaptateur de processus borné de appcore-filemaker. Il est publié sur crates.io comme prerelease beta.

La commande choisit le format d'export ; le YAML du template ne le choisit jamais. check, validate, preflight et les commandes de diagnostic sont en lecture seule, sauf artifacts de sortie explicites. render et mask publient les fichiers atomiquement et rejettent une sortie résolue vers le template d'entrée. migrate est réservé et échoue sans modifier l'entrée ; toute mutation future exige flag et contrat explicites. Chaque commande fournit un texte humain concis et un JSON stable pour l'automatisation. Les deux modes stdout se terminent par une newline et s'arrêtent à 512 Mio. Le pretty JSON est dimensionné avant la sortie puis sérialisé directement via un buffer fixe de 16 Kio, sans seconde string complète.

capabilities --json publie la matrice stable : 0 succès, 2 validation, 64 usage, 65 données, 66 entrée absente, 69 indisponible, 70 software, 73 création impossible, 74 I/O, 75 échec temporaire de ressource et 130 annulation.

schema --json décrit couleurs typées, cascade de style exécutable, unités de coordonnées, primitives et commandes de path sémantiques Canvas, graphiques avancés préparés, overrides export limités à la peinture et ordre layer/z-index indépendant de la collision.

debug TEMPLATE --grid 1|5|10|20 --view combined émet l'overlay complet et non mutant. mask exporte la géométrie collision/layout/visual/combined en PNG, PDF, SVG ou JSON stable occupied/free/collisions/overflow. inspect et explain exposent géométrie source, anchors, région, mesure, collision, page/reflow et provenance conservées par la scène résolue. free-regions interroge les rectangles libres bornés. --patch répétable applique des patches runtime JSON ordonnés, et --font-fallback fixe l'ordre exact des polices enregistrées. render --format csv exporte une table liée sans inventer de layout graphique pour les lignes dataset.

capabilities --json expose les PDF editable, flattened et hybride. Hybrid ajoute un texte Unicode invisible et subsetté sur des contours déterministes. WebP, XLSX, ZPL, ESC/POS, PDF/A, liens, bookmarks et accessibilité tagged restent préparés. schema --json déclare aussi les contrats writer/octets bornés, pertes strict/best-effort, DPI raster uniquement, métadonnées PDF déterministes et subsets de polices.

check, validate et preflight sont des frontières séparées de schéma, layout résolu et exporter. Le JSON conserve warnings bornés et truncated explicite ; strict rejette les warnings et la troncature échoue fermée. La découverte du schéma liste aussi validation des données typées, entrées complètes du fingerprint et cache immuable borné resolve-on-miss.

Les entrées template, données et polices sont lues via un seul handle ouvert et s'arrêtent à limit + 1 octets. Les commandes debug et mask transmettent les mêmes limites core à la géométrie diagnostique bornée.

Les dépendances AppCore directes sont appcore-args et appcore-filemaker.

Les commandes documentées utilisent les entrées concrètes et séparées basic.yml et intermediate.yml, avec des données JSON typées pour le flux intermédiaire.

Documentation maintenue par le crate : guide, exemple de base et exemple intermédiaire.