@softure-ai/marketing-kit 0.16.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +72 -19
  3. package/dist/config/actions-schema.d.ts +14 -14
  4. package/dist/config/config.d.ts.map +1 -1
  5. package/dist/config/config.js +11 -1
  6. package/dist/config/config.js.map +1 -1
  7. package/dist/config/schema.d.ts +78 -70
  8. package/dist/config/schema.d.ts.map +1 -1
  9. package/dist/config/schema.js +25 -8
  10. package/dist/config/schema.js.map +1 -1
  11. package/dist/config/shot-steps.d.ts +16 -16
  12. package/dist/footage/compose.d.ts +17 -3
  13. package/dist/footage/compose.d.ts.map +1 -1
  14. package/dist/footage/compose.js +61 -17
  15. package/dist/footage/compose.js.map +1 -1
  16. package/dist/footage/declick.d.ts +49 -41
  17. package/dist/footage/declick.d.ts.map +1 -1
  18. package/dist/footage/declick.js +181 -92
  19. package/dist/footage/declick.js.map +1 -1
  20. package/dist/footage/film.d.ts +45 -2
  21. package/dist/footage/film.d.ts.map +1 -1
  22. package/dist/footage/film.js +23 -0
  23. package/dist/footage/film.js.map +1 -1
  24. package/dist/footage/isolate-ranges.d.ts +10 -1
  25. package/dist/footage/isolate-ranges.d.ts.map +1 -1
  26. package/dist/footage/isolate-ranges.js +56 -10
  27. package/dist/footage/isolate-ranges.js.map +1 -1
  28. package/dist/footage/paid.d.ts +1 -1
  29. package/dist/footage/paid.d.ts.map +1 -1
  30. package/dist/footage/paid.js +3 -2
  31. package/dist/footage/paid.js.map +1 -1
  32. package/dist/footage/pipeline.d.ts +6 -0
  33. package/dist/footage/pipeline.d.ts.map +1 -1
  34. package/dist/footage/pipeline.js +19 -14
  35. package/dist/footage/pipeline.js.map +1 -1
  36. package/dist/footage/render.d.ts +5 -1
  37. package/dist/footage/render.d.ts.map +1 -1
  38. package/dist/footage/render.js +6 -2
  39. package/dist/footage/render.js.map +1 -1
  40. package/dist/footage/speech-ranges.d.ts +28 -1
  41. package/dist/footage/speech-ranges.d.ts.map +1 -1
  42. package/dist/footage/speech-ranges.js +47 -2
  43. package/dist/footage/speech-ranges.js.map +1 -1
  44. package/dist/index.d.ts +5 -5
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +5 -5
  47. package/dist/index.js.map +1 -1
  48. package/dist/og/character-map.d.ts +2 -1
  49. package/dist/og/character-map.d.ts.map +1 -1
  50. package/dist/og/character-map.js +7 -63
  51. package/dist/og/character-map.js.map +1 -1
  52. package/dist/og/font-file.d.ts +53 -0
  53. package/dist/og/font-file.d.ts.map +1 -0
  54. package/dist/og/font-file.js +153 -0
  55. package/dist/og/font-file.js.map +1 -0
  56. package/dist/og/font-tables.d.ts +25 -0
  57. package/dist/og/font-tables.d.ts.map +1 -0
  58. package/dist/og/font-tables.js +212 -0
  59. package/dist/og/font-tables.js.map +1 -0
  60. package/dist/og/index.d.ts +3 -1
  61. package/dist/og/index.d.ts.map +1 -1
  62. package/dist/og/index.js +2 -1
  63. package/dist/og/index.js.map +1 -1
  64. package/dist/og/photo-cover.d.ts +49 -8
  65. package/dist/og/photo-cover.d.ts.map +1 -1
  66. package/dist/og/photo-cover.js +213 -53
  67. package/dist/og/photo-cover.js.map +1 -1
  68. package/package.json +1 -1
  69. package/schema/marketing.schema.json +76 -23
  70. package/src/config/config.ts +10 -2
  71. package/src/config/schema.ts +24 -5
  72. package/src/footage/compose.ts +72 -17
  73. package/src/footage/declick.ts +172 -97
  74. package/src/footage/film.ts +54 -2
  75. package/src/footage/isolate-ranges.ts +66 -11
  76. package/src/footage/paid.ts +3 -3
  77. package/src/footage/pipeline.ts +25 -14
  78. package/src/footage/render.ts +7 -3
  79. package/src/footage/speech-ranges.ts +55 -3
  80. package/src/index.ts +34 -5
  81. package/src/og/character-map.ts +8 -61
  82. package/src/og/font-file.ts +172 -0
  83. package/src/og/font-tables.ts +221 -0
  84. package/src/og/index.ts +19 -0
  85. package/src/og/photo-cover.ts +259 -62
@@ -0,0 +1,212 @@
1
+ import { brotliDecompressSync, inflateSync } from "node:zlib";
2
+ import { err, ok } from "./result.js";
3
+ const TRUETYPE_SIGNATURES = new Set([0x00010000, 0x74727565 /* true */]);
4
+ const OPENTYPE_SIGNATURE = 0x4f54544f; // OTTO
5
+ const WOFF_SIGNATURE = 0x774f4646; // wOFF
6
+ const WOFF2_SIGNATURE = 0x774f4632; // wOF2
7
+ const COLLECTION_SIGNATURE = 0x74746366; // ttcf
8
+ /** More tables than any real font has; a larger count is a broken or hostile file. */
9
+ const MAX_TABLES = 512;
10
+ /** The largest decompressed WOFF2 font read (a CJK font is about 20 MB). */
11
+ const MAX_WOFF2_SIZE = 64 * 1024 * 1024;
12
+ /** The WOFF2 known-table tags, by their 6-bit index (WOFF2 spec, 5.1). */
13
+ const WOFF2_KNOWN_TAGS = [
14
+ "cmap", "head", "hhea", "hmtx", "maxp", "name", "OS/2", "post", "cvt ", "fpgm", "glyf", "loca", "prep", "CFF ", "VORG",
15
+ "EBDT", "EBLC", "gasp", "hdmx", "kern", "LTSH", "PCLT", "VDMX", "vhea", "vmtx", "BASE", "GDEF", "GPOS", "GSUB", "EBSC",
16
+ "JSTF", "MATH", "CBDT", "CBLC", "COLR", "CPAL", "SVG ", "sbix", "acnt", "avar", "bdat", "bloc", "bsln", "cvar", "fdsc",
17
+ "feat", "fmtx", "fvar", "gvar", "hsty", "just", "lcar", "mort", "morx", "opbd", "prop", "trak", "Zapf", "Silf", "Glat",
18
+ "Gloc", "Feat", "Sill",
19
+ ];
20
+ export class OutOfBounds extends Error {
21
+ }
22
+ export function readUint8(data, offset) {
23
+ if (offset < 0 || offset + 1 > data.length)
24
+ throw new OutOfBounds();
25
+ return data.readUInt8(offset);
26
+ }
27
+ export function readUint16(data, offset) {
28
+ if (offset < 0 || offset + 2 > data.length)
29
+ throw new OutOfBounds();
30
+ return data.readUInt16BE(offset);
31
+ }
32
+ export function readInt16(data, offset) {
33
+ if (offset < 0 || offset + 2 > data.length)
34
+ throw new OutOfBounds();
35
+ return data.readInt16BE(offset);
36
+ }
37
+ export function readUint32(data, offset) {
38
+ if (offset < 0 || offset + 4 > data.length)
39
+ throw new OutOfBounds();
40
+ return data.readUInt32BE(offset);
41
+ }
42
+ export function readInt32(data, offset) {
43
+ if (offset < 0 || offset + 4 > data.length)
44
+ throw new OutOfBounds();
45
+ return data.readInt32BE(offset);
46
+ }
47
+ export function slice(data, offset, length) {
48
+ if (offset < 0 || length < 0 || offset + length > data.length)
49
+ throw new OutOfBounds();
50
+ return data.subarray(offset, offset + length);
51
+ }
52
+ function readTag(data, offset) {
53
+ return slice(data, offset, 4).toString("latin1");
54
+ }
55
+ function toTables(format, flavor, tables) {
56
+ return { format, flavor, get: (tag) => tables.get(tag) };
57
+ }
58
+ function getFlavor(signature) {
59
+ if (TRUETYPE_SIGNATURES.has(signature))
60
+ return "ttf";
61
+ if (signature === OPENTYPE_SIGNATURE)
62
+ return "otf";
63
+ return null;
64
+ }
65
+ function readTableCount(data, offset) {
66
+ const count = readUint16(data, offset);
67
+ return count > MAX_TABLES ? err(`the font lists ${count} tables`) : ok(count);
68
+ }
69
+ function readSfnt(data, flavor) {
70
+ const count = readTableCount(data, 4);
71
+ if (!count.ok)
72
+ return count;
73
+ const tables = new Map();
74
+ for (let index = 0; index < count.value; index++) {
75
+ const record = 12 + index * 16;
76
+ tables.set(readTag(data, record), slice(data, readUint32(data, record + 8), readUint32(data, record + 12)));
77
+ }
78
+ return ok(toTables(flavor, flavor, tables));
79
+ }
80
+ function readWoff(data) {
81
+ const flavor = getFlavor(readUint32(data, 4));
82
+ if (flavor === null)
83
+ return err("the WOFF file wraps neither a TrueType nor an OpenType font");
84
+ const count = readTableCount(data, 12);
85
+ if (!count.ok)
86
+ return count;
87
+ const tables = new Map();
88
+ for (let index = 0; index < count.value; index++) {
89
+ const entry = 44 + index * 20;
90
+ const tag = readTag(data, entry);
91
+ const stored = slice(data, readUint32(data, entry + 4), readUint32(data, entry + 8));
92
+ const length = readUint32(data, entry + 12);
93
+ if (stored.length >= length) {
94
+ tables.set(tag, stored);
95
+ continue;
96
+ }
97
+ try {
98
+ tables.set(tag, inflateSync(stored, { maxOutputLength: Math.max(length, 1) }));
99
+ }
100
+ catch {
101
+ return err(`the font's ${tag.trim()} table does not decompress`);
102
+ }
103
+ }
104
+ return ok(toTables("woff", flavor, tables));
105
+ }
106
+ /** A WOFF2 UIntBase128 at `offset`: the value and the offset after it, or null when it is malformed. */
107
+ function readBase128(data, offset) {
108
+ let value = 0;
109
+ for (let index = 0; index < 5; index++) {
110
+ const byte = readUint8(data, offset + index);
111
+ if (index === 0 && byte === 0x80)
112
+ return null;
113
+ if (value > 0x01ffffff)
114
+ return null;
115
+ value = value * 128 + (byte & 0x7f);
116
+ if ((byte & 0x80) === 0)
117
+ return { value, next: offset + index + 1 };
118
+ }
119
+ return null;
120
+ }
121
+ function readWoff2Directory(data, count) {
122
+ const entries = [];
123
+ let offset = 48;
124
+ for (let index = 0; index < count; index++) {
125
+ const flags = readUint8(data, offset);
126
+ offset += 1;
127
+ const known = flags & 0x3f;
128
+ let tag;
129
+ if (known === 0x3f) {
130
+ tag = readTag(data, offset);
131
+ offset += 4;
132
+ }
133
+ else {
134
+ const name = WOFF2_KNOWN_TAGS[known];
135
+ if (name === undefined)
136
+ return err(`the WOFF2 table directory names an unknown table index ${known}`);
137
+ tag = name;
138
+ }
139
+ const original = readBase128(data, offset);
140
+ if (original === null)
141
+ return err("the WOFF2 table directory is malformed");
142
+ offset = original.next;
143
+ const version = flags >> 6;
144
+ const isTransformed = tag === "glyf" || tag === "loca" ? version === 0 : version !== 0;
145
+ let length = original.value;
146
+ if (isTransformed) {
147
+ const transformed = readBase128(data, offset);
148
+ if (transformed === null)
149
+ return err("the WOFF2 table directory is malformed");
150
+ offset = transformed.next;
151
+ length = transformed.value;
152
+ }
153
+ entries.push({ tag, length });
154
+ }
155
+ return ok({ entries, end: offset });
156
+ }
157
+ function readWoff2(data) {
158
+ const flavorSignature = readUint32(data, 4);
159
+ if (flavorSignature === COLLECTION_SIGNATURE)
160
+ return err("font collections are not read");
161
+ const flavor = getFlavor(flavorSignature);
162
+ if (flavor === null)
163
+ return err("the WOFF2 file wraps neither a TrueType nor an OpenType font");
164
+ const count = readTableCount(data, 12);
165
+ if (!count.ok)
166
+ return count;
167
+ const totalSfntSize = readUint32(data, 16);
168
+ const compressedSize = readUint32(data, 20);
169
+ const directory = readWoff2Directory(data, count.value);
170
+ if (!directory.ok)
171
+ return directory;
172
+ const compressed = slice(data, directory.value.end, compressedSize);
173
+ const expected = directory.value.entries.reduce((sum, entry) => sum + entry.length, 0);
174
+ if (expected > MAX_WOFF2_SIZE || totalSfntSize > MAX_WOFF2_SIZE)
175
+ return err("the WOFF2 font is larger than 64 MB unpacked");
176
+ let stream;
177
+ try {
178
+ stream = brotliDecompressSync(compressed, { maxOutputLength: Math.max(expected, 1) });
179
+ }
180
+ catch {
181
+ return err("the WOFF2 font data does not decompress");
182
+ }
183
+ const tables = new Map();
184
+ let offset = 0;
185
+ for (const entry of directory.value.entries) {
186
+ tables.set(entry.tag, slice(stream, offset, entry.length));
187
+ offset += entry.length;
188
+ }
189
+ return ok(toTables("woff2", flavor, tables));
190
+ }
191
+ /** Reads a font file's tables; the error says why it cannot be read. */
192
+ export function readFontTables(data) {
193
+ try {
194
+ const signature = readUint32(data, 0);
195
+ const flavor = getFlavor(signature);
196
+ if (flavor !== null)
197
+ return readSfnt(data, flavor);
198
+ if (signature === WOFF_SIGNATURE)
199
+ return readWoff(data);
200
+ if (signature === WOFF2_SIGNATURE)
201
+ return readWoff2(data);
202
+ if (signature === COLLECTION_SIGNATURE)
203
+ return err("font collections are not read");
204
+ return err("the file is not a TrueType, OpenType, WOFF or WOFF2 font");
205
+ }
206
+ catch (error) {
207
+ if (error instanceof OutOfBounds)
208
+ return err("the font file is truncated or malformed");
209
+ throw error;
210
+ }
211
+ }
212
+ //# sourceMappingURL=font-tables.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"font-tables.js","sourceRoot":"","sources":["../../src/og/font-tables.ts"],"names":[],"mappings":"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"}
@@ -1,11 +1,13 @@
1
1
  export { loadCharacterMap, readCharacterMap, type CharacterMap } from "./character-map.js";
2
+ export { FONT_USES, findMissingCharacters, readFontFileInfo, type FontFileInfo, type FontFileWeight, type FontUnusableReason, type FontUse, type FontUseVerdict, } from "./font-file.js";
3
+ export type { FontFileFormat } from "./font-tables.js";
2
4
  export { describeCharacter, findMissingGlyphs, selectSatoriFont, type MissingGlyphs } from "./glyphs.js";
3
5
  export { h, listNodes, type OgChild, type OgNode, type OgStyle } from "./element.js";
4
6
  export { OG_FONT_KINDS, OG_FONT_WEIGHTS, loadOgFonts, pickWeight, toFontFamilyCss, type OgFontFamily, type OgFontKind, type OgFontWeight, type OgFonts, type ReadFontFile, type SatoriFont } from "./fonts.js";
5
7
  export { getOgPalette, toOpaqueHex, withAlpha, type OgPalette } from "./palette.js";
6
8
  export type { OgResult } from "./result.js";
7
9
  export { DEFAULT_OG_SIZE, buildOgTree, countOgSlides, getDefaultOgSize, renderConfiguredOgImage, renderOgImage, renderOgSvg, type ConfiguredOgImageOptions, type OgBrand, type OgImageInput, } from "./render.js";
8
- export { MAX_COVER_CAPTION_LENGTH, PHOTO_COVER_QUALITY, PHOTO_COVER_SIZE, getCoverBand, getCoverCaptionSize, renderPhotoCover, type CoverBand, type PhotoCover, type PhotoCoverInput, } from "./photo-cover.js";
10
+ export { MAX_COVER_CAPTION_LENGTH, MAX_COVER_KICKER_LENGTH, MAX_COVER_PILL_LENGTH, PHOTO_COVER_LAYOUTS, PHOTO_COVER_QUALITY, PHOTO_COVER_SIZE, getCoverBand, getCoverCaptionSize, isPointUnderCoverText, renderPhotoCover, type CoverBand, type CoverBox, type CoverPoint, type PhotoCover, type PhotoCoverInput, type PhotoCoverLayout, type PhotoCoverTone, } from "./photo-cover.js";
9
11
  export { getCoverCrop, getOrientationMatrix, getOrientedSize, readPhotoInfo, readTiffOrientation, type CoverCrop, type FocusPoint, type PhotoFormat, type PhotoInfo, type PhotoOrientation, } from "./photo.js";
10
12
  export { OG_TEMPLATE_IDS, OG_TEMPLATES, isOgTemplateId, type OgTemplateId } from "./templates/index.js";
11
13
  export { PORTRAIT_BASE, getLayoutScale, type OgLayout, type OgTemplateContext } from "./templates/context.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,OAAO,EACZ,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,OAAO,EACZ,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
package/dist/og/index.js CHANGED
@@ -1,12 +1,13 @@
1
1
  // `@softure-ai/marketing-kit/og`: OG images from templates and data, for the CLI and for a thin Next
2
2
  // route. Nothing here loads Playwright, so a route can import it.
3
3
  export { loadCharacterMap, readCharacterMap } from "./character-map.js";
4
+ export { FONT_USES, findMissingCharacters, readFontFileInfo, } from "./font-file.js";
4
5
  export { describeCharacter, findMissingGlyphs, selectSatoriFont } from "./glyphs.js";
5
6
  export { h, listNodes } from "./element.js";
6
7
  export { OG_FONT_KINDS, OG_FONT_WEIGHTS, loadOgFonts, pickWeight, toFontFamilyCss } from "./fonts.js";
7
8
  export { getOgPalette, toOpaqueHex, withAlpha } from "./palette.js";
8
9
  export { DEFAULT_OG_SIZE, buildOgTree, countOgSlides, getDefaultOgSize, renderConfiguredOgImage, renderOgImage, renderOgSvg, } from "./render.js";
9
- export { MAX_COVER_CAPTION_LENGTH, PHOTO_COVER_QUALITY, PHOTO_COVER_SIZE, getCoverBand, getCoverCaptionSize, renderPhotoCover, } from "./photo-cover.js";
10
+ export { MAX_COVER_CAPTION_LENGTH, MAX_COVER_KICKER_LENGTH, MAX_COVER_PILL_LENGTH, PHOTO_COVER_LAYOUTS, PHOTO_COVER_QUALITY, PHOTO_COVER_SIZE, getCoverBand, getCoverCaptionSize, isPointUnderCoverText, renderPhotoCover, } from "./photo-cover.js";
10
11
  export { getCoverCrop, getOrientationMatrix, getOrientedSize, readPhotoInfo, readTiffOrientation, } from "./photo.js";
11
12
  export { OG_TEMPLATE_IDS, OG_TEMPLATES, isOgTemplateId } from "./templates/index.js";
12
13
  export { PORTRAIT_BASE, getLayoutScale } from "./templates/context.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,kEAAkE;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,CAAC,EAAE,SAAS,EAA2C,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAA2G,MAAM,YAAY,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAkB,MAAM,cAAc,CAAC;AAEpF,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,WAAW,GAIZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,mBAAmB,GAMpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAyC,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,GAOtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAA+C,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,kEAAkE;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,gBAAgB,GAMjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,CAAC,EAAE,SAAS,EAA2C,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAA2G,MAAM,YAAY,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAkB,MAAM,cAAc,CAAC;AAEpF,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,WAAW,GAIZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GAQjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,mBAAmB,GAMpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAyC,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,GAOtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAA+C,MAAM,qBAAqB,CAAC"}
@@ -4,16 +4,29 @@ import { type FocusPoint } from "./photo.js";
4
4
  import { type OgResult } from "./result.js";
5
5
  /**
6
6
  * A publish-ready cover for a vertical video from a photo the owner picks: the photo scaled to cover the frame and
7
- * cropped around a focus point (EXIF orientation applied), and an optional short caption in the brand's display
8
- * font, kept inside the lower half of the centre 4:5 band the platforms keep when they crop the cover for the profile
9
- * grid. Satori
10
- * lays the caption out, resvg draws the whole cover, `jpeg-js` encodes it: no network, no system fonts.
7
+ * cropped around a focus point (EXIF orientation applied), and optional text in the brand's display font laid out by
8
+ * one of `PHOTO_COVER_LAYOUTS`, kept inside the centre 4:5 band the platforms keep when they crop the cover for the
9
+ * profile grid. Satori lays the text out, resvg draws the whole cover, `jpeg-js` encodes it: no network, no system
10
+ * fonts.
11
11
  */
12
12
  /** A Reels, Shorts and TikTok cover. */
13
13
  export declare const PHOTO_COVER_SIZE: readonly [number, number];
14
14
  export declare const PHOTO_COVER_QUALITY = 90;
15
15
  /** The longest caption accepted before layout; whether a shorter one fits is measured on the drawn caption. */
16
16
  export declare const MAX_COVER_CAPTION_LENGTH = 80;
17
+ /** The longest kicker (the small line above the title in `kicker-title`). */
18
+ export declare const MAX_COVER_KICKER_LENGTH = 40;
19
+ /** The longest label of the `pill` layout (the caption set in a rounded box). */
20
+ export declare const MAX_COVER_PILL_LENGTH = 32;
21
+ /**
22
+ * Where the cover's text goes. `photo`: no text. `title-bottom`, `title-center`, `title-top`: the caption in the lower
23
+ * half, the middle third or the upper half of the band. `kicker-title`: a small kicker line above the caption, in the
24
+ * lower half. `pill`: the caption as a short label in a rounded box, in the lower half.
25
+ */
26
+ export declare const PHOTO_COVER_LAYOUTS: readonly ["photo", "title-bottom", "title-center", "title-top", "kicker-title", "pill"];
27
+ export type PhotoCoverLayout = (typeof PHOTO_COVER_LAYOUTS)[number];
28
+ /** `light`: light text over a dark scrim. `dark`: dark text over a light scrim. */
29
+ export type PhotoCoverTone = "light" | "dark";
17
30
  /** The centre 4:5 band of a cover, in pixels. */
18
31
  export interface CoverBand {
19
32
  left: number;
@@ -32,24 +45,52 @@ export interface PhotoCoverInput {
32
45
  size?: readonly [number, number];
33
46
  /** The point of the upright photo to keep in view, as fractions of its width and height; the centre by default. */
34
47
  focus?: FocusPoint;
35
- /** A short title (2 to 6 words fit best); none draws the cropped photo alone. */
48
+ /** Where the text goes (`PHOTO_COVER_LAYOUTS`); `title-bottom` with a caption and `photo` without one by default. */
49
+ layout?: PhotoCoverLayout;
50
+ /** The title (2 to 6 words fit best), or the `pill` label; required by every layout but `photo`, refused by it. */
36
51
  caption?: string;
37
- /** The text is the lighter of `foreground` and `background`; the scrim and the shadow the darker. */
52
+ /** The small line above the title; required by `kicker-title` and refused by the other layouts. */
53
+ kicker?: string;
54
+ /** `light` text over a dark scrim, or `dark` text over a light one; `light` by default. */
55
+ tone?: PhotoCoverTone;
56
+ /** The light colour is the lighter of `foreground` and `background`, the dark colour the darker. */
38
57
  colors: BrandColors;
39
- /** The brand's fonts (`loadOgFonts`); the caption is set in the heading (display) family. */
58
+ /** The brand's fonts (`loadOgFonts`); the text is set in the heading (display) family. */
40
59
  fonts: OgFonts;
41
60
  /** JPEG quality, 1-100; 90 by default. */
42
61
  quality?: number;
43
62
  /** Names the cover in errors, e.g. the video's id. */
44
63
  id?: string;
45
64
  }
65
+ /** A box on the cover, in pixels: `left` and `top` included, `right` and `bottom` excluded. */
66
+ export interface CoverBox {
67
+ left: number;
68
+ top: number;
69
+ right: number;
70
+ bottom: number;
71
+ }
72
+ /** A point on the cover, in pixels from its top left corner. */
73
+ export interface CoverPoint {
74
+ x: number;
75
+ y: number;
76
+ }
46
77
  export interface PhotoCover {
47
78
  /** A baseline JPEG of exactly `width` × `height`, without an ICC profile (sRGB). */
48
79
  jpeg: Buffer;
49
80
  width: number;
50
81
  height: number;
51
82
  bytes: number;
83
+ /** The drawn text's bounds on the cover, its shadow included (the box the fit check measured); null for layout `photo`. */
84
+ textBox: CoverBox | null;
85
+ /** Where the focus point landed on the cover after the crop; off-centre when the photo's edge stops the shift. */
86
+ focusPoint: CoverPoint;
52
87
  }
53
- /** Renders the cover: the photo cropped to `size` around the focus point, the caption (if any) over a soft scrim. */
88
+ /** Renders the cover: the photo cropped to `size` around the focus point, the layout's text (if any) over a soft scrim. */
54
89
  export declare function renderPhotoCover(input: PhotoCoverInput): Promise<OgResult<PhotoCover>>;
90
+ /**
91
+ * Whether `point` lies under the cover's text: inside its `textBox` grown by `marginPx` on every side (0 by default).
92
+ * A cover without text (layout `photo`) covers no point. Use it with `focusPoint` to warn when the text hides the
93
+ * photo's subject.
94
+ */
95
+ export declare function isPointUnderCoverText(cover: Pick<PhotoCover, "textBox">, point: CoverPoint, marginPx?: number): boolean;
55
96
  //# sourceMappingURL=photo-cover.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"photo-cover.d.ts","sourceRoot":"","sources":["../../src/og/photo-cover.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EAAsE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;GAMG;AAEH,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAgB,CAAC;AAExE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,+GAA+G;AAC/G,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAW3C,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAKvE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3D;AAeD,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mHAAmH;IACnH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,MAAM,EAAE,WAAW,CAAC;IACpB,6FAA6F;IAC7F,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAmID,qHAAqH;AACrH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CA8C5F"}
1
+ {"version":3,"file":"photo-cover.d.ts","sourceRoot":"","sources":["../../src/og/photo-cover.ts"],"names":[],"mappings":"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"}