allyhub 0.4.0 → 0.6.0

package/dist/node_modules/@allyhub-next/formats/dist/data/slides.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as o}from"zod";import{SCRIPT_NAME as u}from"./script.js";export const SLIDES_FILE="slides.yaml",slidesFileFor=l=>`${l}/${SLIDES_FILE}`;const i=o.string().regex(u,"A name is letters, digits, _ and -.");export const THEME_COLORS=["dk1","lt1","dk2","lt2","accent1","accent2","accent3","accent4","accent5","accent6","hlink","folHlink"],TEXT_ALIGNS=["l","ctr","r","just"],SHAPE_GEOMETRIES=["rect","roundRect","ellipse","triangle","rightArrow","leftArrow","upArrow","downArrow","leftRightArrow","diamond","parallelogram","trapezoid","pentagon","hexagon","octagon","chevron","homePlate","plus","star4","star5","wedgeRectCallout","line"],ANIMATION_EFFECTS=["appear","fade","wipe","fly-in","zoom","disappear","fade-out","wipe-out","fly-out","zoom-out","pulse","path"],ANIMATION_STARTS=["on-click","with-previous","after-previous"],ANIMATION_DIRECTIONS=["from-bottom","from-top","from-left","from-right"],LINE_DASHES=["solid","sysDash","sysDot","dash","dashDot","lgDash","lgDashDot","lgDashDotDot"],LINE_ENDS=["none","triangle","arrow","stealth","diamond","oval"],FrameSchema=o.strictObject({x:o.number(),y:o.number(),w:o.number().nonnegative(),h:o.number().nonnegative()}),ColorFileSchema=o.union([o.enum(THEME_COLORS),o.string().regex(/^#[0-9A-Fa-f]{6}$/u,"a theme colour or #RRGGBB")]),NUMBERINGS=["arabicPeriod","arabicParenR","alphaLcPeriod","alphaUcPeriod","romanLcPeriod","romanUcPeriod"],TextStyleSchema=o.strictObject({size:o.number().positive().max(4e3).optional(),bold:o.boolean().optional(),italic:o.boolean().optional(),color:ColorFileSchema.optional(),font:o.string().min(1).optional(),align:o.enum(TEXT_ALIGNS).optional(),numbered:o.enum(NUMBERINGS).optional()});const g=o.strictObject({left:o.number().min(0).max(1).optional(),top:o.number().min(0).max(1).optional(),right:o.number().min(0).max(1).optional(),bottom:o.number().min(0).max(1).optional()}),m=o.lazy(()=>o.union([o.string(),o.number(),o.boolean(),o.null(),o.array(m),o.record(o.string(),m)]));export const CHART_TYPES=["column-clustered","column-stacked","column-stacked-100","bar-clustered","bar-stacked","bar-stacked-100","line","line-markers","area","area-stacked","area-stacked-100","pie","doughnut"],SHEET_CHART_TYPES=[...CHART_TYPES,"scatter","scatter-lines","scatter-smooth"],CHART_LEGEND_POSITIONS=["bottom","top","left","right"];const b=o.strictObject({min:o.number().optional(),max:o.number().optional(),major:o.number().positive().optional(),gridlines:o.boolean().optional(),visible:o.boolean().optional(),format:o.string().min(1).optional(),reverse:o.boolean().optional(),gridline_color:ColorFileSchema.optional(),line_color:ColorFileSchema.optional()});export const ChartSchema=o.strictObject({type:o.enum(SHEET_CHART_TYPES),data:o.string().min(1).optional(),categories:o.union([o.string().min(1),o.array(o.string())]).optional(),series:o.array(o.union([o.string().min(1),o.strictObject({name:o.string().min(1),values:o.array(o.number().nullable()).optional(),x:o.array(o.number().nullable()).optional(),color:ColorFileSchema.optional(),format:o.string().min(1).optional(),smooth:o.boolean().optional(),line_width:o.number().positive().optional(),marker_size:o.number().int().min(2).max(72).optional()})])).min(1),legend:o.enum(CHART_LEGEND_POSITIONS).optional(),labels:o.union([o.boolean(),o.strictObject({value:o.boolean().optional(),percentage:o.boolean().optional(),category:o.boolean().optional(),series:o.boolean().optional(),format:o.string().min(1).optional(),position:o.enum(["outEnd","inEnd","ctr","inBase","t","b","l","r","bestFit"]).optional(),size:o.number().positive().optional(),color:ColorFileSchema.optional()})]).optional(),gap_width:o.number().min(0).max(500).optional(),overlap:o.number().min(-100).max(100).optional(),vary_by_categories:o.boolean().optional(),hole_size:o.number().min(10).max(90).optional(),value_axis:b.optional(),category_axis:b.optional(),size:o.number().positive().optional(),title_size:o.number().positive().optional(),color:ColorFileSchema.optional()});const r=o.number().min(0).max(1);export const GradientSchema=o.strictObject({angle:o.number().min(0).max(360).optional(),stops:o.array(o.strictObject({at:r,color:ColorFileSchema,transparency:r.optional()})).min(2).max(10)}),ShadowSchema=o.strictObject({color:ColorFileSchema.optional(),blur:o.number().min(0).max(100).optional(),distance:o.number().min(0).max(200).optional(),angle:o.number().min(0).max(360).optional(),transparency:r.optional()}),ShapeSchema=o.strictObject({frame:FrameSchema.optional(),z:o.int().optional(),fill:ColorFileSchema.optional(),fill_transparency:r.optional(),gradient:GradientSchema.optional(),shadow:ShadowSchema.optional(),line:o.union([ColorFileSchema,o.literal("none")]).optional(),line_width:o.number().positive().max(1584).optional(),line_dash:o.enum(LINE_DASHES).optional(),line_begin:o.enum(LINE_ENDS).optional(),line_end:o.enum(LINE_ENDS).optional(),text:TextStyleSchema.optional(),textbox:o.literal(!0).optional(),picture:o.string().min(1).optional(),crop:g.optional(),movie:o.string().min(1).optional(),poster:o.number().min(0).optional(),geometry:o.enum(SHAPE_GEOMETRIES).optional(),path:o.strictObject({w:o.number().positive(),h:o.number().positive(),d:o.string().min(1)}).optional(),table:o.strictObject({columns:o.array(o.number().positive()).min(1),rows:o.array(o.strictObject({height:o.number().positive(),fill:ColorFileSchema.optional(),text:TextStyleSchema.optional(),line:ColorFileSchema.optional()})).min(1)}).optional(),chart:ChartSchema.optional(),group:i.optional(),component:i.optional(),props:o.record(o.string(),m).optional()}),SHAPE_KINDS=["textbox","picture","movie","geometry","path","table","chart","component"],SLIDE_TRANSITIONS=["fade","push","wipe","morph"],TransitionSchema=o.strictObject({type:o.enum(SLIDE_TRANSITIONS),direction:o.enum(ANIMATION_DIRECTIONS).optional(),duration:o.number().positive().optional()}),AnimationSchema=o.strictObject({shape:o.string().min(1),paragraph:o.int().min(0).optional(),effect:o.enum(ANIMATION_EFFECTS),direction:o.enum(ANIMATION_DIRECTIONS).optional(),start:o.enum(ANIMATION_STARTS).optional(),duration:o.number().min(0).optional(),delay:o.number().min(0).optional(),path:o.string().min(1).optional()}),SlideSchema=o.strictObject({id:i,layout:o.string().min(1).optional(),generate:i.optional(),hidden:o.union([o.literal(!0),o.array(o.string())]).optional(),shapes:o.record(o.string().min(1),ShapeSchema).optional(),animations:o.array(AnimationSchema).optional(),transition:TransitionSchema.optional()}),SlidesFileSchema=o.strictObject({slides:o.array(SlideSchema).default([])}).superRefine((l,n)=>{const c=new Set;l.slides.forEach((t,a)=>{c.has(t.id)&&n.addIssue({code:"custom",path:["slides",a,"id"],message:`Two slides are "${t.id}".`}),c.add(t.id),(t.layout===void 0?0:1)+(t.generate===void 0?0:1)!==1&&n.addIssue({code:"custom",path:["slides",a],message:`Slide ${t.id} has a layout or a generator: one of them.`}),t.hidden!==void 0&&t.generate===void 0&&t.hidden!==!0&&n.addIssue({code:"custom",path:["slides",a,"hidden"],message:`Slide ${t.id} is hidden (true); a list of ids is a generated block's.`});for(const[e,h]of Object.entries(t.shapes??{})){const d=SHAPE_KINDS.filter(p=>h[p]!==void 0);d.length>1&&n.addIssue({code:"custom",path:["slides",a,"shapes",e],message:`Shape ${e} is one kind of shape, not ${d.join(" and ")}.`});const s=e.includes("/")?e.split("/"):[e];(!(s.length<=2&&s.every(p=>u.test(p)))||s.length===2&&t.generate===void 0)&&n.addIssue({code:"custom",path:["slides",a,"shapes",e],message:"A shape's name is letters, digits, _ and -; <slide>/<shape> only in a generated block."})}})});

package/dist/node_modules/@allyhub-next/formats/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./layout.js";
+export * from "./note-shape.js";
+export * from "./items.js";
+export * from "./schemas.js";
+export * from "./strict.js";
+export * from "./data/file.js";
+export * from "./data/words.js";
+export * from "./data/edits.js";
+export * from "./data/elements.js";
+export * from "./data/gen.js";
+export * from "./data/comments.js";
+export * from "./data/messages.js";
+export * from "./data/script.js";
+export * from "./data/sheet.js";
+export * from "./data/slides.js";
+export * from "./data/config.js";
+export * from "./data/faces.js";
+export * from "./data/reference.js";
+export * from "./zip.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/formats/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export*from"./layout.js";export*from"./note-shape.js";export*from"./items.js";export*from"./schemas.js";export*from"./strict.js";export*from"./data/file.js";export*from"./data/words.js";export*from"./data/edits.js";export*from"./data/elements.js";export*from"./data/gen.js";export*from"./data/comments.js";export*from"./data/messages.js";export*from"./data/script.js";export*from"./data/sheet.js";export*from"./data/slides.js";export*from"./data/config.js";export*from"./data/faces.js";export*from"./data/reference.js";export*from"./zip.js";

package/dist/node_modules/@allyhub-next/formats/dist/items.d.ts

@@ -0,0 +1,120 @@
+/** The extensions a code entry file may have. */
+export declare const CODE_EXTENSIONS: readonly ["ts", "tsx", "mts", "js", "jsx", "mjs"];
+/** The editors an item opens in: one per kind. */
+export declare const EDITORS: readonly ["video", "slides", "doc", "sheet", "scenery", "website"];
+export type EditorId = (typeof EDITORS)[number];
+export declare const ITEM_KINDS: {
+    readonly video: {
+        readonly entries: readonly string[];
+        readonly editor: "video";
+        readonly name: "video";
+    };
+    readonly slides: {
+        readonly entries: readonly string[];
+        readonly editor: "slides";
+        readonly name: "slides";
+    };
+    readonly doc: {
+        readonly entries: readonly ["doc.mdx"];
+        readonly editor: "doc";
+        readonly name: "doc";
+    };
+    readonly sheet: {
+        readonly entries: readonly ["sheet.yaml"];
+        readonly editor: "sheet";
+        readonly name: "sheet";
+    };
+    readonly scenery: {
+        readonly entries: readonly string[];
+        readonly editor: "scenery";
+        readonly name: "3D scenery";
+    };
+    readonly model: {
+        readonly entries: readonly string[];
+        readonly editor: "scenery";
+        readonly name: "3D model";
+    };
+    readonly website: {
+        readonly entries: readonly ["astro.config.mjs", "astro.config.ts", "astro.config.mts", "astro.config.js"];
+        readonly editor: "website";
+        readonly name: "website";
+    };
+};
+export type ItemKind = keyof typeof ITEM_KINDS;
+/**
+ * A choice about how a file is made: one of `values`, the first the
+ * default, or without them on or off. `only` lists the file types it means
+ * something for.
+ */
+export interface ExportOption {
+    name: string;
+    only: readonly string[];
+    values?: readonly string[];
+}
+/**
+ * What an item of a kind is exported as in its editor: the file types to
+ * choose one of, the first the default, those that may come with it, and how
+ * they are made. A kind that is not here has no Export. `allyhub render`
+ * makes these and more.
+ */
+export declare const EXPORT_OFFER: Partial<Record<ItemKind, {
+    types: readonly string[];
+    extras: readonly string[];
+    options?: readonly ExportOption[];
+}>>;
+export declare const KINDS: ItemKind[];
+/** The kind a file name is the entry file of, if any. */
+export declare function entryKind(name: string): ItemKind | undefined;
+/** An item of the project, by its folder. */
+export interface Item {
+    kind: ItemKind;
+    /** Its folder, a project path: what names the item. */
+    dir: string;
+    /** Its entry file, a project path. */
+    entry: string;
+}
+export type ItemProblem = 
+/** A folder with more than one entry file: it is no item until one goes. */
+{
+    code: "two-entries";
+    dir: string;
+    entries: string[];
+}
+/** An item inside another item's folder: the outer one has it as a file. */
+ | {
+    code: "nested";
+    dir: string;
+    inside: string;
+}
+/** An entry file at the project's root: the root is the project, not an item. */
+ | {
+    code: "at-root";
+    entry: string;
+};
+export interface ItemScan {
+    /** The items, by their folders, in path order. */
+    items: Item[];
+    problems: ItemProblem[];
+}
+/**
+ * The items of a project, from its files (project paths; dot folders and
+ * node_modules are left out here whatever is passed).
+ */
+export declare function scanItems(files: Iterable<string>): ItemScan;
+/** The item a project path belongs to: the one whose folder holds it. */
+export declare function itemFor(path: string, items: readonly Item[]): Item | undefined;
+/** The registry as data, for a host that does not run this code. */
+export interface ItemManifest {
+    version: 1;
+    kinds: {
+        kind: ItemKind;
+        name: string;
+        editor: EditorId;
+        /** Glob patterns of its entry files, from the project's root. */
+        patterns: string[];
+    }[];
+    /** Folders never looked into, as glob patterns. */
+    ignore: string[];
+}
+export declare function itemManifest(): ItemManifest;
+//# sourceMappingURL=items.d.ts.map

package/dist/node_modules/@allyhub-next/formats/dist/items.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{baseOf as f,dirOf as l,unscanned as u,within as m}from"./layout.js";export const CODE_EXTENSIONS=["ts","tsx","mts","js","jsx","mjs"];const d=e=>CODE_EXTENSIONS.map(o=>`${e}.${o}`);export const EDITORS=["video","slides","doc","sheet","scenery","website"],ITEM_KINDS={video:{entries:d("video"),editor:"video",name:"video"},slides:{entries:d("slides"),editor:"slides",name:"slides"},doc:{entries:["doc.mdx"],editor:"doc",name:"doc"},sheet:{entries:["sheet.yaml"],editor:"sheet",name:"sheet"},scenery:{entries:d("scenery"),editor:"scenery",name:"3D scenery"},model:{entries:d("model"),editor:"scenery",name:"3D model"},website:{entries:["astro.config.mjs","astro.config.ts","astro.config.mts","astro.config.js"],editor:"website",name:"website"}},EXPORT_OFFER={video:{types:["mp4","mov","gif"],extras:["srt","cover"]},slides:{types:["pptx","pdf","png"],extras:["cover"],options:[{name:"pptx",only:["pptx"],values:["native","picture"]},{name:"steps",only:["pdf","png"]}]},doc:{types:["pdf","docx","png","md"],extras:[]},sheet:{types:["xlsx","pdf","png","csv","md","json"],extras:[]},model:{types:["glb"],extras:[]}},KINDS=Object.keys(ITEM_KINDS);const x=new Map(KINDS.flatMap(e=>ITEM_KINDS[e].entries.map(o=>[o,e])));export function entryKind(e){return x.get(f(e))}export function scanItems(e){const o=[...e].filter(t=>!u(t)).sort(),n=[],r=new Map;for(const t of o){if(entryKind(t)===void 0)continue;const s=l(t);if(s===""){n.push({code:"at-root",entry:t});continue}r.set(s,[...r.get(s)??[],t])}const c=[];for(const[t,s]of r){const[i]=s;if(s.length>1||i===void 0){n.push({code:"two-entries",dir:t,entries:s});continue}const a=entryKind(i);a&&c.push({kind:a,dir:t,entry:i})}c.sort((t,s)=>t.dir.localeCompare(s.dir));const p=[];for(const t of c){const s=p.find(i=>m(t.dir,i.dir));s?n.push({code:"nested",dir:t.dir,inside:s.dir}):p.push(t)}return{items:p,problems:n}}export function itemFor(e,o){let n;for(const r of o)m(e,r.dir)&&(!n||r.dir.length>n.dir.length)&&(n=r);return n}export function itemManifest(){return{version:1,kinds:KINDS.map(e=>({kind:e,name:ITEM_KINDS[e].name,editor:ITEM_KINDS[e].editor,patterns:ITEM_KINDS[e].entries.map(o=>`**/${o}`)})),ignore:["**/.*/**","**/node_modules/**"]}}