psd 3.4.0 → 4.1.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 (216) hide show
  1. package/README.md +196 -149
  2. package/dist/descriptor.d.ts +20 -0
  3. package/dist/descriptor.d.ts.map +1 -0
  4. package/dist/descriptor.js +114 -0
  5. package/dist/descriptor.js.map +1 -0
  6. package/dist/engine-data.d.ts +11 -0
  7. package/dist/engine-data.d.ts.map +1 -0
  8. package/dist/engine-data.js +82 -0
  9. package/dist/engine-data.js.map +1 -0
  10. package/dist/image.d.ts +52 -0
  11. package/dist/image.d.ts.map +1 -0
  12. package/dist/image.js +301 -0
  13. package/dist/image.js.map +1 -0
  14. package/dist/index.d.ts +16 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +10 -0
  17. package/dist/index.js.map +1 -0
  18. package/dist/layer-info.d.ts +494 -0
  19. package/dist/layer-info.d.ts.map +1 -0
  20. package/dist/layer-info.js +529 -0
  21. package/dist/layer-info.js.map +1 -0
  22. package/dist/layer-styles.d.ts +160 -0
  23. package/dist/layer-styles.d.ts.map +1 -0
  24. package/dist/layer-styles.js +183 -0
  25. package/dist/layer-styles.js.map +1 -0
  26. package/dist/layer.d.ts +143 -0
  27. package/dist/layer.d.ts.map +1 -0
  28. package/dist/layer.js +249 -0
  29. package/dist/layer.js.map +1 -0
  30. package/dist/nodes.d.ts +233 -0
  31. package/dist/nodes.d.ts.map +1 -0
  32. package/dist/nodes.js +326 -0
  33. package/dist/nodes.js.map +1 -0
  34. package/dist/path-record.d.ts +34 -0
  35. package/dist/path-record.d.ts.map +1 -0
  36. package/dist/path-record.js +44 -0
  37. package/dist/path-record.js.map +1 -0
  38. package/dist/png.d.ts +10 -0
  39. package/dist/png.d.ts.map +1 -0
  40. package/dist/png.js +85 -0
  41. package/dist/png.js.map +1 -0
  42. package/dist/psd.d.ts +49 -0
  43. package/dist/psd.d.ts.map +1 -0
  44. package/dist/psd.js +106 -0
  45. package/dist/psd.js.map +1 -0
  46. package/dist/reader.d.ts +41 -0
  47. package/dist/reader.d.ts.map +1 -0
  48. package/dist/reader.js +100 -0
  49. package/dist/reader.js.map +1 -0
  50. package/dist/resources.d.ts +105 -0
  51. package/dist/resources.d.ts.map +1 -0
  52. package/dist/resources.js +173 -0
  53. package/dist/resources.js.map +1 -0
  54. package/dist/type-tool.d.ts +142 -0
  55. package/dist/type-tool.d.ts.map +1 -0
  56. package/dist/type-tool.js +222 -0
  57. package/dist/type-tool.js.map +1 -0
  58. package/package.json +26 -32
  59. package/src/descriptor.ts +141 -0
  60. package/src/engine-data.ts +86 -0
  61. package/src/image.ts +338 -0
  62. package/src/index.ts +38 -0
  63. package/src/layer-info.ts +578 -0
  64. package/src/layer-styles.ts +339 -0
  65. package/src/layer.ts +334 -0
  66. package/src/nodes.ts +411 -0
  67. package/src/path-record.ts +69 -0
  68. package/src/png.ts +92 -0
  69. package/src/psd.ts +133 -0
  70. package/src/reader.ts +125 -0
  71. package/src/resources.ts +273 -0
  72. package/src/type-tool.ts +270 -0
  73. package/.travis.yml +0 -5
  74. package/Cakefile +0 -61
  75. package/DEVELOPMENT.md +0 -27
  76. package/bower.json +0 -26
  77. package/docs/docco.css +0 -284
  78. package/docs/lib/psd/blend_mode.coffee.html +0 -72
  79. package/docs/lib/psd/channel_image.coffee.html +0 -81
  80. package/docs/lib/psd/color.coffee.html +0 -13
  81. package/docs/lib/psd/descriptor.coffee.html +0 -173
  82. package/docs/lib/psd/file.coffee.html +0 -78
  83. package/docs/lib/psd/header.coffee.html +0 -71
  84. package/docs/lib/psd/image.coffee.html +0 -94
  85. package/docs/lib/psd/image_export.coffee.html +0 -5
  86. package/docs/lib/psd/image_exports/png.coffee.html +0 -19
  87. package/docs/lib/psd/image_format.coffee.html +0 -8
  88. package/docs/lib/psd/image_formats/layer_raw.coffee.html +0 -9
  89. package/docs/lib/psd/image_formats/layer_rle.coffee.html +0 -10
  90. package/docs/lib/psd/image_formats/raw.coffee.html +0 -6
  91. package/docs/lib/psd/image_formats/rle.coffee.html +0 -37
  92. package/docs/lib/psd/image_mode.coffee.html +0 -7
  93. package/docs/lib/psd/image_modes/cmyk.coffee.html +0 -36
  94. package/docs/lib/psd/image_modes/greyscale.coffee.html +0 -17
  95. package/docs/lib/psd/image_modes/rgb.coffee.html +0 -32
  96. package/docs/lib/psd/init.coffee.html +0 -22
  97. package/docs/lib/psd/layer/blend_modes.coffee.html +0 -22
  98. package/docs/lib/psd/layer/blending_ranges.coffee.html +0 -29
  99. package/docs/lib/psd/layer/channel_image.coffee.html +0 -13
  100. package/docs/lib/psd/layer/helpers.coffee.html +0 -19
  101. package/docs/lib/psd/layer/info.coffee.html +0 -69
  102. package/docs/lib/psd/layer/mask.coffee.html +0 -11
  103. package/docs/lib/psd/layer/name.coffee.html +0 -15
  104. package/docs/lib/psd/layer/position_channels.coffee.html +0 -24
  105. package/docs/lib/psd/layer.coffee.html +0 -64
  106. package/docs/lib/psd/layer_info/blend_clipping_elements.coffee.html +0 -11
  107. package/docs/lib/psd/layer_info/blend_interior_elements.coffee.html +0 -11
  108. package/docs/lib/psd/layer_info/fill_opacity.coffee.html +0 -10
  109. package/docs/lib/psd/layer_info/gradient_fill.coffee.html +0 -12
  110. package/docs/lib/psd/layer_info/layer_id.coffee.html +0 -10
  111. package/docs/lib/psd/layer_info/layer_name_source.coffee.html +0 -10
  112. package/docs/lib/psd/layer_info/legacy_typetool.coffee.html +0 -82
  113. package/docs/lib/psd/layer_info/locked.coffee.html +0 -24
  114. package/docs/lib/psd/layer_info/metadata.coffee.html +0 -30
  115. package/docs/lib/psd/layer_info/nested_section_divider.coffee.html +0 -23
  116. package/docs/lib/psd/layer_info/object_effects.coffee.html +0 -12
  117. package/docs/lib/psd/layer_info/section_divider.coffee.html +0 -41
  118. package/docs/lib/psd/layer_info/solid_color.coffee.html +0 -24
  119. package/docs/lib/psd/layer_info/typetool.coffee.html +0 -121
  120. package/docs/lib/psd/layer_info/unicode_name.coffee.html +0 -14
  121. package/docs/lib/psd/layer_info/vector_mask.coffee.html +0 -37
  122. package/docs/lib/psd/layer_info/vector_origination.coffee.html +0 -12
  123. package/docs/lib/psd/layer_info/vector_stroke.coffee.html +0 -12
  124. package/docs/lib/psd/layer_info/vector_stroke_content.coffee.html +0 -12
  125. package/docs/lib/psd/layer_info.coffee.html +0 -11
  126. package/docs/lib/psd/layer_mask.coffee.html +0 -73
  127. package/docs/lib/psd/lazy_execute.coffee.html +0 -80
  128. package/docs/lib/psd/mask.coffee.html +0 -47
  129. package/docs/lib/psd/node.coffee.html +0 -100
  130. package/docs/lib/psd/nodes/ancestry.coffee.html +0 -47
  131. package/docs/lib/psd/nodes/build_preview.coffee.html +0 -6
  132. package/docs/lib/psd/nodes/group.coffee.html +0 -19
  133. package/docs/lib/psd/nodes/layer.coffee.html +0 -17
  134. package/docs/lib/psd/nodes/root.coffee.html +0 -61
  135. package/docs/lib/psd/nodes/search.coffee.html +0 -23
  136. package/docs/lib/psd/path_record.coffee.html +0 -73
  137. package/docs/lib/psd/resource.coffee.html +0 -20
  138. package/docs/lib/psd/resource_section.coffee.html +0 -16
  139. package/docs/lib/psd/resources/layer_comps.coffee.html +0 -31
  140. package/docs/lib/psd/resources.coffee.html +0 -44
  141. package/docs/lib/psd/util.coffee.html +0 -24
  142. package/docs/lib/psd.coffee.html +0 -85
  143. package/index.js +0 -2
  144. package/lib/psd/blend_mode.coffee +0 -78
  145. package/lib/psd/channel_image.coffee +0 -87
  146. package/lib/psd/color.coffee +0 -10
  147. package/lib/psd/descriptor.coffee +0 -189
  148. package/lib/psd/file.coffee +0 -88
  149. package/lib/psd/header.coffee +0 -83
  150. package/lib/psd/image.coffee +0 -107
  151. package/lib/psd/image_export.coffee +0 -2
  152. package/lib/psd/image_exports/png.coffee +0 -28
  153. package/lib/psd/image_format.coffee +0 -5
  154. package/lib/psd/image_formats/layer_raw.coffee +0 -6
  155. package/lib/psd/image_formats/layer_rle.coffee +0 -7
  156. package/lib/psd/image_formats/raw.coffee +0 -3
  157. package/lib/psd/image_formats/rle.coffee +0 -38
  158. package/lib/psd/image_mode.coffee +0 -4
  159. package/lib/psd/image_modes/cmyk.coffee +0 -36
  160. package/lib/psd/image_modes/greyscale.coffee +0 -14
  161. package/lib/psd/image_modes/rgb.coffee +0 -39
  162. package/lib/psd/init.coffee +0 -21
  163. package/lib/psd/layer/blend_modes.coffee +0 -20
  164. package/lib/psd/layer/blending_ranges.coffee +0 -28
  165. package/lib/psd/layer/channel_image.coffee +0 -10
  166. package/lib/psd/layer/helpers.coffee +0 -16
  167. package/lib/psd/layer/info.coffee +0 -76
  168. package/lib/psd/layer/mask.coffee +0 -8
  169. package/lib/psd/layer/name.coffee +0 -12
  170. package/lib/psd/layer/position_channels.coffee +0 -22
  171. package/lib/psd/layer.coffee +0 -64
  172. package/lib/psd/layer_info/artboard.coffee +0 -16
  173. package/lib/psd/layer_info/blend_clipping_elements.coffee +0 -8
  174. package/lib/psd/layer_info/blend_interior_elements.coffee +0 -8
  175. package/lib/psd/layer_info/fill_opacity.coffee +0 -7
  176. package/lib/psd/layer_info/gradient_fill.coffee +0 -9
  177. package/lib/psd/layer_info/layer_id.coffee +0 -7
  178. package/lib/psd/layer_info/layer_name_source.coffee +0 -7
  179. package/lib/psd/layer_info/legacy_typetool.coffee +0 -80
  180. package/lib/psd/layer_info/locked.coffee +0 -21
  181. package/lib/psd/layer_info/metadata.coffee +0 -27
  182. package/lib/psd/layer_info/nested_section_divider.coffee +0 -22
  183. package/lib/psd/layer_info/object_effects.coffee +0 -9
  184. package/lib/psd/layer_info/section_divider.coffee +0 -38
  185. package/lib/psd/layer_info/solid_color.coffee +0 -21
  186. package/lib/psd/layer_info/typetool.coffee +0 -172
  187. package/lib/psd/layer_info/unicode_name.coffee +0 -11
  188. package/lib/psd/layer_info/vector_mask.coffee +0 -35
  189. package/lib/psd/layer_info/vector_origination.coffee +0 -9
  190. package/lib/psd/layer_info/vector_stroke.coffee +0 -9
  191. package/lib/psd/layer_info/vector_stroke_content.coffee +0 -9
  192. package/lib/psd/layer_info.coffee +0 -8
  193. package/lib/psd/layer_mask.coffee +0 -73
  194. package/lib/psd/lazy_execute.coffee +0 -86
  195. package/lib/psd/mask.coffee +0 -52
  196. package/lib/psd/node.coffee +0 -150
  197. package/lib/psd/nodes/ancestry.coffee +0 -44
  198. package/lib/psd/nodes/build_preview.coffee +0 -3
  199. package/lib/psd/nodes/group.coffee +0 -16
  200. package/lib/psd/nodes/layer.coffee +0 -14
  201. package/lib/psd/nodes/root.coffee +0 -59
  202. package/lib/psd/nodes/search.coffee +0 -20
  203. package/lib/psd/path_record.coffee +0 -72
  204. package/lib/psd/resource.coffee +0 -17
  205. package/lib/psd/resource_section.coffee +0 -16
  206. package/lib/psd/resources/guides.coffee +0 -25
  207. package/lib/psd/resources/layer_comps.coffee +0 -28
  208. package/lib/psd/resources/layer_links.coffee +0 -17
  209. package/lib/psd/resources/resolution_info.coffee +0 -26
  210. package/lib/psd/resources.coffee +0 -41
  211. package/lib/psd/util.coffee +0 -23
  212. package/lib/psd.coffee +0 -92
  213. package/output/Logo_Glyph.png +0 -0
  214. package/output/Make a change and save..png +0 -0
  215. package/output/Matte.png +0 -0
  216. package/webpack.config.js +0 -23
@@ -0,0 +1,578 @@
1
+ import { readDescriptor, type Descriptor } from './descriptor.ts';
2
+ import type { InfoBlock } from './layer.ts';
3
+ import { readLayerStyles } from './layer-styles.ts';
4
+ import { readPathRecords } from './path-record.ts';
5
+ import type { Header } from './psd.ts';
6
+ import type { Reader, SpaceColor } from './reader.ts';
7
+ import { readLegacyTypeTool, TypeTool } from './type-tool.ts';
8
+
9
+ interface Ctx {
10
+ header: Header;
11
+ /** Length of the block's data. */
12
+ length: number;
13
+ /** Offset where the block's data ends. */
14
+ end: number;
15
+ }
16
+
17
+ type Parser = (r: Reader, ctx: Ctx) => unknown;
18
+
19
+ /** Skips `skip` bytes of version info, then reads a descriptor. */
20
+ const descriptorAfter = (skip: number) => (r: Reader) => {
21
+ r.skip(skip);
22
+ return readDescriptor(r);
23
+ };
24
+
25
+ /** A boolean followed by 3 bytes of padding. */
26
+ const flag = (r: Reader) => r.bool();
27
+
28
+ const SECTION_DIVIDER_TYPES = ['other', 'open folder', 'closed folder', 'bounding section divider'] as const;
29
+ const SHEET_COLORS = ['none', 'red', 'orange', 'yellow', 'green', 'blue', 'violet', 'gray'] as const;
30
+ const CHANNEL_LETTERS: Record<string, string[]> = { RGBColor: ['R', 'G', 'B'], CMYKColor: ['C', 'M', 'Y', 'K'] };
31
+ /** Indexed from 1. */
32
+ const BEVEL_STYLES = ['Outer Bevel', 'Inner Bevel', 'Emboss', 'Pillow Emboss', 'Stroke Emboss'];
33
+
34
+ function readDivider(r: Reader, { length }: Ctx) {
35
+ const code = r.int32();
36
+ const divider = {
37
+ type: SECTION_DIVIDER_TYPES[code] ?? 'other',
38
+ isFolder: code === 1 || code === 2,
39
+ /** Marks the end of a group. */
40
+ isHidden: code === 3,
41
+ /** The group's blend mode key, which overrides the layer record's. */
42
+ blendMode: undefined as string | undefined,
43
+ subType: undefined as 'normal' | 'scene group' | undefined,
44
+ };
45
+ if (length >= 12) {
46
+ r.skip(4); // signature
47
+ divider.blendMode = r.ascii(4);
48
+ }
49
+ if (length >= 16) divider.subType = r.int32() === 0 ? 'normal' : 'scene group';
50
+ return divider;
51
+ }
52
+
53
+ /** A point count followed by (output, input) pairs. */
54
+ const readCurvePoints = (r: Reader) =>
55
+ Array.from({ length: r.int16() }, () => ({ output: r.int16(), input: r.int16() }));
56
+
57
+ export function readCurves(r: Reader, { end }: Pick<Ctx, 'end'>) {
58
+ r.skip(3); // padding + version
59
+ const tag = r.int32();
60
+ const curves: Array<{ channelIndex: number; points: Array<{ output: number; input: number }> }> = [];
61
+ // Legacy format: bit i of the tag says whether a curve for channel i is present.
62
+ for (let i = 0; i < 32; i++) {
63
+ if (tag & (1 << i)) curves.push({ channelIndex: i, points: readCurvePoints(r) });
64
+ }
65
+ // Photoshop CS repeats the curves in an extended section with explicit channel indexes,
66
+ // which replaces the legacy data.
67
+ if (r.pos < end - 4) {
68
+ if (r.ascii(4) !== 'Crv ') throw new Error('Malformed extended curves data');
69
+ r.skip(2);
70
+ const count = r.int32();
71
+ return Array.from({ length: count }, () => ({ channelIndex: r.int16(), points: readCurvePoints(r) }));
72
+ }
73
+ return curves;
74
+ }
75
+
76
+ function readLevels(r: Reader, { end }: Ctx) {
77
+ r.skip(2); // version
78
+ const record = () => ({
79
+ inputFloor: r.int16(),
80
+ inputCeiling: r.int16(),
81
+ outputFloor: r.int16(),
82
+ outputCeiling: r.int16(),
83
+ gamma: r.int16() / 100,
84
+ });
85
+ const records = Array.from({ length: 29 }, record);
86
+ if (r.pos < end - 4) {
87
+ if (r.ascii(4) !== 'Lvls') throw new Error('Malformed extended levels data');
88
+ r.skip(2);
89
+ const extra = r.int16() - 29;
90
+ for (let i = 0; i < extra; i++) records.push(record());
91
+ }
92
+ return records;
93
+ }
94
+
95
+ function readGradientMap(r: Reader) {
96
+ r.skip(2); // version
97
+ const reverse = r.bool();
98
+ const dither = r.bool();
99
+ const name = r.unicode();
100
+ const colorStops = Array.from({ length: r.int16() }, () => {
101
+ const stop = { location: r.int32(), midpoint: r.int32(), color: r.spaceColor() };
102
+ r.skip(2);
103
+ return stop;
104
+ });
105
+ const transparencyStops = Array.from({ length: r.int16() }, () => ({
106
+ location: r.int32(),
107
+ midpoint: r.int32(),
108
+ opacity: r.int16(),
109
+ }));
110
+ const map = {
111
+ reverse,
112
+ dither,
113
+ name,
114
+ colorStops,
115
+ transparencyStops,
116
+ interpolation: undefined as number | undefined,
117
+ noise: undefined as
118
+ | {
119
+ mode: number;
120
+ randomSeed: number;
121
+ showingTransparency: boolean;
122
+ usingVectorColor: boolean;
123
+ roughnessFactor: number;
124
+ colorModel: number;
125
+ minimumColor: number[];
126
+ maximumColor: number[];
127
+ }
128
+ | undefined,
129
+ };
130
+ if (r.int16() > 0) {
131
+ map.interpolation = r.int16();
132
+ if (r.int16() >= 32) {
133
+ map.noise = {
134
+ mode: r.int16(),
135
+ randomSeed: r.int32(),
136
+ showingTransparency: r.int16() > 0,
137
+ usingVectorColor: r.int16() > 0,
138
+ roughnessFactor: r.int32(),
139
+ colorModel: r.int16(),
140
+ minimumColor: [0, 0, 0, 0].map(() => r.uint16() >> 8),
141
+ maximumColor: [0, 0, 0, 0].map(() => r.uint16() >> 8),
142
+ };
143
+ }
144
+ }
145
+ return map;
146
+ }
147
+
148
+ function readHueSaturation(r: Reader) {
149
+ r.skip(2); // version
150
+ const type = r.uint8() === 0 ? ('hue' as const) : ('colorization' as const);
151
+ r.skip(1);
152
+ const hsl = () => ({ hue: r.int16(), saturation: r.int16(), lightness: r.int16() });
153
+ const colorization = hsl();
154
+ const master = hsl();
155
+ const ranges = Array.from({ length: 6 }, () => ({
156
+ range: [r.int16(), r.int16(), r.int16(), r.int16()],
157
+ settings: [r.int16(), r.int16(), r.int16()],
158
+ }));
159
+ return { type, colorization, master, ranges };
160
+ }
161
+
162
+ function readSelectiveColor(r: Reader) {
163
+ r.skip(2); // version
164
+ const correctionMode = r.int16() === 0 ? ('relative' as const) : ('absolute' as const);
165
+ r.skip(8); // the first record is unused
166
+ const corrections = Array.from({ length: 9 }, () => ({
167
+ cyan: r.int16(),
168
+ magenta: r.int16(),
169
+ yellow: r.int16(),
170
+ black: r.int16(),
171
+ }));
172
+ return { correctionMode, corrections };
173
+ }
174
+
175
+ function readPhotoFilter(r: Reader) {
176
+ const version = r.int16();
177
+ let color: { colorSpace: number; components: number[] } | { x: number; y: number; z: number };
178
+ if (version === 3) {
179
+ color = { x: r.int32() >> 8, y: r.int32() >> 8, z: r.int32() >> 8 };
180
+ } else if (version === 2) {
181
+ color = { colorSpace: r.int16(), components: [r.int16(), r.int16(), r.int16(), r.int16()] };
182
+ } else {
183
+ throw new Error(`Unsupported photo filter version ${version}`);
184
+ }
185
+ return { color, density: r.int32(), preserveLuminosity: r.bool() };
186
+ }
187
+
188
+ /** The legacy (pre-Photoshop 6) layer effects block. */
189
+ function readEffectsLayer(r: Reader) {
190
+ r.skip(2); // version
191
+ const count = r.int16();
192
+ const effects: {
193
+ visible?: boolean;
194
+ dropShadow?: ReturnType<typeof shadow>;
195
+ innerShadow?: ReturnType<typeof shadow>;
196
+ outerGlow?: ReturnType<typeof glow>;
197
+ innerGlow?: ReturnType<typeof glow>;
198
+ bevel?: ReturnType<typeof bevel>;
199
+ solidFill?: ReturnType<typeof solidFill>;
200
+ } = {};
201
+
202
+ const blendKey = () => {
203
+ r.skip(4); // signature
204
+ return r.ascii(4);
205
+ };
206
+ const opacity = () => Math.round((r.uint8() / 255) * 100);
207
+ // Documented as int32, but Photoshop writes 16.16 fixed point.
208
+ const fixed = () => r.int32() >> 16;
209
+
210
+ function shadow() {
211
+ const size = r.int32();
212
+ const end = r.pos + size;
213
+ const data = {
214
+ version: r.int32(),
215
+ blur: fixed(),
216
+ intensity: fixed(),
217
+ angle: fixed(),
218
+ distance: fixed(),
219
+ color: r.spaceColor(),
220
+ blendMode: blendKey(),
221
+ enabled: r.bool(),
222
+ useGlobalLight: r.bool(),
223
+ /** Percent. */
224
+ opacity: opacity(),
225
+ nativeColor: undefined as SpaceColor | undefined,
226
+ };
227
+ if (size >= 51) data.nativeColor = r.spaceColor();
228
+ r.seek(end);
229
+ return data;
230
+ }
231
+
232
+ function glow(inner: boolean) {
233
+ const size = r.int32();
234
+ const end = r.pos + size;
235
+ const data = {
236
+ version: r.int32(),
237
+ blur: fixed(),
238
+ intensity: fixed(),
239
+ color: r.spaceColor(),
240
+ blendMode: blendKey(),
241
+ enabled: r.bool(),
242
+ opacity: opacity(),
243
+ invert: undefined as boolean | undefined,
244
+ nativeColor: undefined as SpaceColor | undefined,
245
+ };
246
+ if (data.version === 2) {
247
+ if (inner) data.invert = r.bool();
248
+ data.nativeColor = r.spaceColor();
249
+ }
250
+ r.seek(end);
251
+ return data;
252
+ }
253
+
254
+ function bevel() {
255
+ const size = r.int32();
256
+ const end = r.pos + size;
257
+ const version = r.int32();
258
+ const angle = fixed();
259
+ const strength = fixed();
260
+ const blur = fixed();
261
+ const highlightBlendMode = blendKey();
262
+ const shadowBlendMode = blendKey();
263
+ const highlightColor = r.spaceColor();
264
+ const shadowColor = r.spaceColor();
265
+ const styleId = r.uint8();
266
+ const data = {
267
+ version,
268
+ angle,
269
+ strength,
270
+ blur,
271
+ highlightBlendMode,
272
+ shadowBlendMode,
273
+ highlightColor,
274
+ shadowColor,
275
+ style: BEVEL_STYLES[styleId - 1],
276
+ highlightOpacity: opacity(),
277
+ shadowOpacity: opacity(),
278
+ enabled: r.bool(),
279
+ useGlobalLight: r.bool(),
280
+ direction: r.uint8() === 0 ? ('up' as const) : ('down' as const),
281
+ realHighlightColor: undefined as SpaceColor | undefined,
282
+ realShadowColor: undefined as SpaceColor | undefined,
283
+ };
284
+ if (version === 2) {
285
+ data.realHighlightColor = r.spaceColor();
286
+ data.realShadowColor = r.spaceColor();
287
+ }
288
+ r.seek(end);
289
+ return data;
290
+ }
291
+
292
+ function solidFill() {
293
+ const size = r.int32();
294
+ const end = r.pos + size;
295
+ const data = {
296
+ version: r.int32(),
297
+ blendMode: blendKey(),
298
+ color: r.spaceColor(),
299
+ opacity: opacity(),
300
+ enabled: r.bool(),
301
+ nativeColor: r.spaceColor(),
302
+ };
303
+ r.seek(end);
304
+ return data;
305
+ }
306
+
307
+ for (let i = 0; i < count; i++) {
308
+ const sig = r.ascii(4);
309
+ if (sig !== '8BIM') throw new Error(`Bad effects layer signature '${sig}'`);
310
+ const key = r.ascii(4);
311
+ switch (key) {
312
+ case 'cmnS': {
313
+ const size = r.int32();
314
+ r.skip(size);
315
+ effects.visible = true;
316
+ break;
317
+ }
318
+ case 'dsdw':
319
+ effects.dropShadow = shadow();
320
+ break;
321
+ case 'isdw':
322
+ effects.innerShadow = shadow();
323
+ break;
324
+ case 'oglw':
325
+ effects.outerGlow = glow(false);
326
+ break;
327
+ case 'iglw':
328
+ effects.innerGlow = glow(true);
329
+ break;
330
+ case 'bevl':
331
+ effects.bevel = bevel();
332
+ break;
333
+ case 'sofi':
334
+ effects.solidFill = solidFill();
335
+ break;
336
+ default:
337
+ r.skip(r.int32());
338
+ }
339
+ }
340
+ return effects;
341
+ }
342
+
343
+ function readMetadata(r: Reader) {
344
+ const metadata: { layerComp?: Descriptor } = {};
345
+ const count = r.int32();
346
+ for (let i = 0; i < count; i++) {
347
+ r.skip(4); // signature
348
+ const key = r.ascii(4);
349
+ r.skip(4); // copy on sheet duplication + padding
350
+ const length = r.int32();
351
+ const end = r.pos + length;
352
+ if (key === 'cmls') {
353
+ r.skip(4); // descriptor version
354
+ metadata.layerComp = readDescriptor(r);
355
+ }
356
+ r.seek(end);
357
+ }
358
+ return metadata;
359
+ }
360
+
361
+ /** Every layer info block this library understands, by name. */
362
+ const LAYER_INFO = {
363
+ artboard: {
364
+ keys: ['artb', 'artd', 'abdd'],
365
+ parse: (r: Reader) => {
366
+ const data = descriptorAfter(4)(r);
367
+ const rect = data.artboardRect;
368
+ return { data, coords: { left: rect['Left'], top: rect['Top '], right: rect['Rght'], bottom: rect['Btom'] } };
369
+ },
370
+ },
371
+ blackWhite: {
372
+ keys: ['blwh'],
373
+ parse: (r: Reader) => {
374
+ const d = descriptorAfter(4)(r);
375
+ return {
376
+ red: d['Rd '] as number,
377
+ yellow: d['Yllw'] as number,
378
+ green: d['Grn '] as number,
379
+ cyan: d['Cyn '] as number,
380
+ blue: d['Bl '] as number,
381
+ magenta: d['Mgnt'] as number,
382
+ tint: d.useTint as boolean,
383
+ tintColor: { red: d.tintColor['Rd '] as number, green: d.tintColor['Grn '] as number, blue: d.tintColor['Bl '] as number },
384
+ presetKind: d.bwPresetKind as number,
385
+ presetFileName: d.blackAndWhitePresetFileName as string,
386
+ data: d,
387
+ };
388
+ },
389
+ },
390
+ blendClippingElements: { keys: ['clbl'], parse: flag },
391
+ blendInteriorElements: { keys: ['infx'], parse: flag },
392
+ /** Only meaningful with "Use Legacy" checked; otherwise see `contentGenerator`. */
393
+ brightnessContrast: {
394
+ keys: ['brit'],
395
+ parse: (r: Reader) => ({ brightness: r.int16(), contrast: r.int16(), meanValue: r.int16(), labColor: r.bool() }),
396
+ },
397
+ channelBlendingRestrictions: {
398
+ keys: ['brst'],
399
+ parse: (r: Reader, { length, header }: Ctx) => {
400
+ const channels = Array.from({ length: length / 4 }, () => r.int32());
401
+ const letters = CHANNEL_LETTERS[header.modeName];
402
+ return { channels, letters: letters ? channels.map((c) => letters[c]) : undefined };
403
+ },
404
+ },
405
+ channelMixer: {
406
+ keys: ['mixr'],
407
+ parse: (r: Reader) => {
408
+ r.skip(2); // version
409
+ const monochrome = r.int16() > 0;
410
+ const channels = Array.from({ length: 4 }, () => ({
411
+ redCyan: r.int16(),
412
+ greenMagenta: r.int16(),
413
+ blueYellow: r.int16(),
414
+ black: r.int16(),
415
+ constant: r.int16(),
416
+ }));
417
+ return { monochrome, channels };
418
+ },
419
+ },
420
+ colorBalance: {
421
+ keys: ['blnc'],
422
+ parse: (r: Reader) => {
423
+ const range = () => ({ cyanRed: r.int16(), magentaGreen: r.int16(), yellowBlue: r.int16() });
424
+ return { shadows: range(), midtones: range(), highlights: range(), preserveLuminosity: r.int16() > 0 };
425
+ },
426
+ },
427
+ colorLookup: { keys: ['clrL'], parse: descriptorAfter(6) },
428
+ /** Brightness/contrast in Photoshop CS3+. */
429
+ contentGenerator: {
430
+ keys: ['CgEd'],
431
+ parse: (r: Reader) => {
432
+ const d = descriptorAfter(4)(r);
433
+ return {
434
+ brightness: d.Brgh as number,
435
+ contrast: d.Cntr as number,
436
+ meanValue: d.means as number,
437
+ labColor: d['Lab '] as boolean,
438
+ useLegacy: d.useLegacy as boolean,
439
+ auto: d.Auto as boolean,
440
+ data: d,
441
+ };
442
+ },
443
+ },
444
+ curves: { keys: ['curv'], parse: readCurves },
445
+ effectsLayer: { keys: ['lrFX'], parse: readEffectsLayer },
446
+ exposure: {
447
+ keys: ['expA'],
448
+ parse: (r: Reader) => {
449
+ r.skip(2); // version
450
+ return { exposure: r.float32(), offset: r.float32(), gamma: r.float32() };
451
+ },
452
+ },
453
+ /** 0-255. */
454
+ fillOpacity: { keys: ['iOpa'], parse: (r: Reader) => r.uint8() },
455
+ gradientFill: { keys: ['GdFl'], parse: descriptorAfter(4) },
456
+ gradientMap: { keys: ['grdm'], parse: readGradientMap },
457
+ hueSaturation: { keys: ['hue2'], parse: readHueSaturation },
458
+ /** Present (and `true`) on invert adjustment layers. */
459
+ invert: { keys: ['nvrt'], parse: () => true },
460
+ knockout: {
461
+ keys: ['knko'],
462
+ parse: (r: Reader) => {
463
+ const value = r.uint8();
464
+ return { enabled: value > 0, mode: value === 1 ? ('shallow' as const) : value === 2 ? ('deep' as const) : undefined };
465
+ },
466
+ },
467
+ layerId: { keys: ['lyid'], parse: (r: Reader) => r.int32() },
468
+ layerMaskAsGlobalMask: { keys: ['lmgm'], parse: flag },
469
+ /** Minimum Photoshop version needed to read the layer, times 10 (70 = 7.0). */
470
+ layerVersion: { keys: ['lyvr'], parse: (r: Reader) => r.int32() },
471
+ layerNameSource: { keys: ['lnsr'], parse: (r: Reader) => r.ascii(4) },
472
+ legacyTypeTool: { keys: ['tySh'], parse: readLegacyTypeTool },
473
+ levels: { keys: ['levl'], parse: readLevels },
474
+ locked: {
475
+ keys: ['lspf'],
476
+ parse: (r: Reader) => {
477
+ const value = r.int32();
478
+ const all = value === -2147483648;
479
+ const locked = {
480
+ transparency: all || (value & 0x01) > 0,
481
+ composite: all || (value & 0x02) > 0,
482
+ position: all || (value & 0x04) > 0,
483
+ all: false,
484
+ };
485
+ locked.all = locked.transparency && locked.composite && locked.position;
486
+ return locked;
487
+ },
488
+ },
489
+ metadata: { keys: ['shmd'], parse: readMetadata },
490
+ /** The Unicode layer name. */
491
+ name: { keys: ['luni'], parse: (r: Reader) => r.unicode() },
492
+ /** Group markers in files that lack `sectionDivider`. */
493
+ nestedSectionDivider: {
494
+ keys: ['lsdk'],
495
+ parse: (r: Reader) => {
496
+ const code = r.int32();
497
+ return { isFolder: code === 1 || code === 2, isHidden: code === 3 };
498
+ },
499
+ },
500
+ /** Layer styles (drop shadow, stroke, etc.). Photoshop stores a group's styles in `lfxs`. */
501
+ objectEffects: { keys: ['lfx2', 'lmfx', 'lfxs'], parse: (r: Reader) => readLayerStyles(descriptorAfter(8)(r)) },
502
+ patternFill: { keys: ['PtFl'], parse: descriptorAfter(4) },
503
+ photoFilter: { keys: ['phfl'], parse: readPhotoFilter },
504
+ /** Smart object data. */
505
+ placedLayer: { keys: ['SoLd', 'SoLE'], parse: descriptorAfter(12) },
506
+ posterize: { keys: ['post'], parse: (r: Reader) => r.int16() },
507
+ referencePoint: { keys: ['fxrp'], parse: (r: Reader) => ({ x: r.float64(), y: r.float64() }) },
508
+ sectionDivider: { keys: ['lsct'], parse: readDivider },
509
+ selectiveColor: { keys: ['selc'], parse: readSelectiveColor },
510
+ /** The layer's color label. */
511
+ sheetColor: { keys: ['lclr'], parse: (r: Reader) => SHEET_COLORS[r.int16()] ?? 'none' },
512
+ solidColor: {
513
+ keys: ['SoCo'],
514
+ parse: (r: Reader) => {
515
+ const data = descriptorAfter(4)(r);
516
+ const c = data['Clr '];
517
+ return { r: Math.round(c['Rd ']), g: Math.round(c['Grn ']), b: Math.round(c['Bl ']), data };
518
+ },
519
+ },
520
+ threshold: { keys: ['thrs'], parse: (r: Reader) => r.int16() },
521
+ transparencyShapesLayer: { keys: ['tsly'], parse: (r: Reader) => r.uint8() === 1 },
522
+ typeTool: { keys: ['TySh'], parse: (r: Reader) => new TypeTool(r) },
523
+ vectorMask: {
524
+ keys: ['vmsk', 'vsms'],
525
+ parse: (r: Reader, { length }: Ctx) => {
526
+ r.skip(4); // version
527
+ const flags = r.int32();
528
+ return {
529
+ invert: (flags & 0x01) > 0,
530
+ notLink: (flags & 0x02) > 0,
531
+ disable: (flags & 0x04) > 0,
532
+ paths: readPathRecords(r, Math.floor((length - 8) / 26)),
533
+ };
534
+ },
535
+ },
536
+ vectorMaskAsGlobalMask: { keys: ['vmgm'], parse: flag },
537
+ vectorOrigination: { keys: ['vogk'], parse: descriptorAfter(8) },
538
+ vectorStroke: { keys: ['vstk'], parse: descriptorAfter(4) },
539
+ vectorStrokeContent: { keys: ['vscg'], parse: descriptorAfter(8) },
540
+ vibrance: {
541
+ keys: ['vibA'],
542
+ parse: (r: Reader) => {
543
+ const data = descriptorAfter(4)(r);
544
+ return { vibrance: data.vibrance as number | undefined, saturation: data['Strt'] as number | undefined, data };
545
+ },
546
+ },
547
+ } satisfies Record<string, { keys: string[]; parse: Parser }>;
548
+
549
+ export type LayerInfo = {
550
+ readonly [K in keyof typeof LAYER_INFO]?: ReturnType<(typeof LAYER_INFO)[K]['parse']>;
551
+ };
552
+
553
+ const BY_KEY = new Map<string, [string, Parser]>(
554
+ Object.entries(LAYER_INFO).flatMap(([name, { keys, parse }]) => keys.map((key) => [key, [name, parse as Parser]] as const)),
555
+ );
556
+
557
+ /** Builds the `layer.info` object: one memoized getter per known block present in the layer. */
558
+ export function createLayerInfo(reader: Reader, blocks: InfoBlock[], header: Header): LayerInfo {
559
+ const info = {};
560
+ for (const block of blocks) {
561
+ const entry = BY_KEY.get(block.key);
562
+ if (!entry || Object.hasOwn(info, entry[0])) continue;
563
+ const [name, parse] = entry;
564
+ let value: unknown;
565
+ let parsed = false;
566
+ Object.defineProperty(info, name, {
567
+ enumerable: true,
568
+ get() {
569
+ if (!parsed) {
570
+ value = parse(reader.at(block.offset), { header, length: block.length, end: block.offset + block.length });
571
+ parsed = true;
572
+ }
573
+ return value;
574
+ },
575
+ });
576
+ }
577
+ return info;
578
+ }