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,86 @@
1
+ /**
2
+ * Parses the PostScript-like "EngineData" format Photoshop uses for text layers, e.g.
3
+ * `<< /Key (string) /List [ 1 .5 true ] /Dict << /Name /Value >> >>`.
4
+ * Strings are byte strings with `\` escapes, and are UTF-16BE when they start with a BOM.
5
+ */
6
+ export type EngineValue = string | number | boolean | EngineValue[] | EngineDict;
7
+ export interface EngineDict {
8
+ [key: string]: any;
9
+ }
10
+
11
+ const utf16 = new TextDecoder('utf-16be');
12
+ const isSpace = (b: number) => b === 0x20 || b === 0x09 || b === 0x0a || b === 0x0d || b === 0x00;
13
+ const isDelimiter = (b: number) => isSpace(b) || b === 0x2f || b === 0x5b || b === 0x5d || b === 0x3c || b === 0x3e || b === 0x28;
14
+
15
+ export function parseEngineData(bytes: Uint8Array): EngineDict {
16
+ let pos = 0;
17
+
18
+ const skipSpace = () => {
19
+ while (pos < bytes.length && isSpace(bytes[pos]!)) pos++;
20
+ };
21
+
22
+ const word = () => {
23
+ const start = pos;
24
+ while (pos < bytes.length && !isDelimiter(bytes[pos]!)) pos++;
25
+ return String.fromCharCode(...bytes.subarray(start, pos));
26
+ };
27
+
28
+ const string = () => {
29
+ pos++; // (
30
+ const out: number[] = [];
31
+ for (;;) {
32
+ if (pos >= bytes.length) throw new Error('Unterminated EngineData string');
33
+ const b = bytes[pos++]!;
34
+ if (b === 0x29) break; // )
35
+ out.push(b === 0x5c ? bytes[pos++]! : b); // \ escapes the next byte
36
+ }
37
+ if (out[0] === 0xfe && out[1] === 0xff) return utf16.decode(new Uint8Array(out.slice(2)));
38
+ return String.fromCharCode(...out);
39
+ };
40
+
41
+ const value = (): EngineValue => {
42
+ skipSpace();
43
+ const b = bytes[pos];
44
+ if (b === 0x3c && bytes[pos + 1] === 0x3c) {
45
+ pos += 2;
46
+ const dict: EngineDict = {};
47
+ for (;;) {
48
+ skipSpace();
49
+ if (bytes[pos] === 0x3e && bytes[pos + 1] === 0x3e) {
50
+ pos += 2;
51
+ return dict;
52
+ }
53
+ if (bytes[pos] !== 0x2f) throw new Error(`Expected EngineData key at offset ${pos}`);
54
+ pos++;
55
+ dict[word()] = value();
56
+ }
57
+ }
58
+ if (b === 0x5b) {
59
+ pos++;
60
+ const list: EngineValue[] = [];
61
+ for (;;) {
62
+ skipSpace();
63
+ if (bytes[pos] === 0x5d) {
64
+ pos++;
65
+ return list;
66
+ }
67
+ list.push(value());
68
+ }
69
+ }
70
+ if (b === 0x28) return string();
71
+ if (b === 0x2f) {
72
+ pos++;
73
+ return word();
74
+ }
75
+ const token = word();
76
+ if (token === 'true') return true;
77
+ if (token === 'false') return false;
78
+ const n = Number(token);
79
+ if (token === '' || Number.isNaN(n)) throw new Error(`Unexpected EngineData token '${token}' at offset ${pos}`);
80
+ return n;
81
+ };
82
+
83
+ const root = value();
84
+ if (typeof root !== 'object' || Array.isArray(root)) throw new Error('EngineData root is not a dictionary');
85
+ return root;
86
+ }
package/src/image.ts ADDED
@@ -0,0 +1,338 @@
1
+ import type { ChannelInfo, Layer } from './layer.ts';
2
+ import { encodePng, inflate } from './png.ts';
3
+ import type { Header } from './psd.ts';
4
+ import type { Reader } from './reader.ts';
5
+ import type { Resources } from './resources.ts';
6
+
7
+ export interface RGBAImage {
8
+ width: number;
9
+ height: number;
10
+ /** RGBA, 4 bytes per pixel. Pass to `new ImageData(data, width, height)` in browsers. */
11
+ data: Uint8ClampedArray;
12
+ }
13
+
14
+ export interface GrayImage {
15
+ width: number;
16
+ height: number;
17
+ /** 1 byte per pixel. */
18
+ data: Uint8Array;
19
+ }
20
+
21
+ /** Writes pixel `i` as RGB at `out[o]`. It may also clear the alpha at `out[o + 3]`. */
22
+ type PixelWriter = (i: number, out: Uint8ClampedArray, o: number) => void;
23
+
24
+ /** How a color mode's channels become RGB. */
25
+ interface ColorModel {
26
+ /** Number of color channels. Any single extra channel is transparency. */
27
+ colorCount: number;
28
+ /** Binds the color planes to a pixel writer. `plane(id, fill)` returns a missing plane filled with `fill`. */
29
+ writer(plane: (id: number, fill?: number) => Uint8Array): PixelWriter;
30
+ }
31
+
32
+ /** The color model for a document. Throws for formats this library can't decode. Resources are only read for indexed images. */
33
+ function colorModel(header: Header, resources: () => Resources): ColorModel {
34
+ const { mode, depth, channels, modeName } = header;
35
+ if ((mode === 0) !== (depth === 1)) throw new Error(`Decoding ${depth}-bit ${modeName} images is not supported`);
36
+ switch (mode) {
37
+ case 0: // Bitmap, expanded to grayscale
38
+ case 1: // Grayscale
39
+ case 8: // Duotone, stored as grayscale
40
+ return {
41
+ colorCount: 1,
42
+ writer: (plane) => {
43
+ const g = plane(0);
44
+ return (i, out, o) => {
45
+ out[o] = out[o + 1] = out[o + 2] = g[i]!;
46
+ };
47
+ },
48
+ };
49
+ case 2: {
50
+ if (depth !== 8) throw new Error(`Unexpected ${depth}-bit indexed image`);
51
+ // The color mode data is the color table: 256 reds, then 256 greens, then 256 blues.
52
+ const colors = header.colorModeData;
53
+ if (colors.length < 768) throw new Error(`Indexed image color table is ${colors.length} bytes, expected 768`);
54
+ const { indexedColorCount: count = 256, transparencyIndex: transparentIndex } = resources();
55
+ return {
56
+ colorCount: 1,
57
+ writer: (plane) => {
58
+ const p = plane(0);
59
+ return (i, out, o) => {
60
+ const index = p[i]!;
61
+ out[o] = colors[index]!;
62
+ out[o + 1] = colors[256 + index]!;
63
+ out[o + 2] = colors[512 + index]!;
64
+ if (index >= count || index === transparentIndex) out[o + 3] = 0;
65
+ };
66
+ },
67
+ };
68
+ }
69
+ case 3:
70
+ return {
71
+ colorCount: 3,
72
+ writer: (plane) => {
73
+ const [r, g, b] = [plane(0), plane(1), plane(2)];
74
+ return (i, out, o) => {
75
+ out[o] = r[i]!;
76
+ out[o + 1] = g[i]!;
77
+ out[o + 2] = b[i]!;
78
+ };
79
+ },
80
+ };
81
+ case 7: // Multichannel, approximated as CMY(K) inks like Photoshop's default channel colors
82
+ if (channels !== 3 && channels !== 4) throw new Error(`Decoding ${channels}-channel multichannel images is not supported`);
83
+ // falls through
84
+ case 4:
85
+ return {
86
+ colorCount: mode === 7 ? channels : 4,
87
+ writer: (plane) => {
88
+ // Values are stored inverted, so 255 is "no ink" for a missing black channel.
89
+ const [c, m, y, k] = [plane(0), plane(1), plane(2), plane(3, 255)];
90
+ return (i, out, o) => {
91
+ const black = 255 - k[i]!;
92
+ out[o] = inkToRgb(255 - c[i]!, black);
93
+ out[o + 1] = inkToRgb(255 - m[i]!, black);
94
+ out[o + 2] = inkToRgb(255 - y[i]!, black);
95
+ };
96
+ },
97
+ };
98
+ case 9:
99
+ return {
100
+ colorCount: 3,
101
+ writer: (plane) => {
102
+ const [l, a, b] = [plane(0), plane(1), plane(2)];
103
+ return (i, out, o) => out.set(labToRgb(l[i]!, a[i]!, b[i]!), o);
104
+ },
105
+ };
106
+ default:
107
+ throw new Error(`Decoding ${modeName} images is not supported`);
108
+ }
109
+ }
110
+
111
+ /** Combines 8-bit planes (keyed by channel ID, -1 for transparency) into RGBA. */
112
+ function toRgba(model: ColorModel, planes: Map<number, Uint8Array>, pixels: number): Uint8ClampedArray {
113
+ const write = model.writer((id, fill = 0) => planes.get(id) ?? new Uint8Array(pixels).fill(fill));
114
+ const alpha = planes.get(-1);
115
+ const out = new Uint8ClampedArray(pixels * 4);
116
+ for (let i = 0, o = 0; i < pixels; i++, o += 4) {
117
+ out[o + 3] = alpha ? alpha[i]! : 255;
118
+ write(i, out, o);
119
+ }
120
+ return out;
121
+ }
122
+
123
+ const rowBytes = (width: number, depth: number) => Math.ceil((width * depth) / 8);
124
+
125
+ /** Decodes PackBits rows. */
126
+ function unpackBits(r: Reader, counts: number[], rowLength: number): Uint8Array {
127
+ const out = new Uint8Array(rowLength * counts.length);
128
+ let o = 0;
129
+ for (const count of counts) {
130
+ const end = r.pos + count;
131
+ while (r.pos < end) {
132
+ const n = r.int8();
133
+ if (n >= 0) {
134
+ out.set(r.bytesView(n + 1), o);
135
+ o += n + 1;
136
+ } else if (n !== -128) {
137
+ out.fill(r.uint8(), o, o + 1 - n);
138
+ o += 1 - n;
139
+ }
140
+ }
141
+ }
142
+ return out;
143
+ }
144
+
145
+ /** Reverses ZIP prediction: each sample is stored as the delta from the previous one in its row. */
146
+ export function unpredict(data: Uint8Array, width: number, height: number, depth: number): Uint8Array {
147
+ if (depth === 8) {
148
+ for (let y = 0; y < height; y++) {
149
+ for (let i = y * width + 1; i < (y + 1) * width; i++) data[i] = (data[i]! + data[i - 1]!) & 0xff;
150
+ }
151
+ } else if (depth === 16) {
152
+ const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
153
+ for (let y = 0; y < height; y++) {
154
+ for (let x = 1; x < width; x++) {
155
+ const i = (y * width + x) * 2;
156
+ view.setUint16(i, view.getUint16(i) + view.getUint16(i - 2));
157
+ }
158
+ }
159
+ } else {
160
+ throw new Error(`ZIP prediction is not supported for ${depth}-bit images`);
161
+ }
162
+ return data;
163
+ }
164
+
165
+ /** Reduces samples to 8 bits: keeps the high byte of 16-bit samples and expands 1-bit pixels (1 = black). */
166
+ function to8Bit(data: Uint8Array, depth: number, width: number, height: number): Uint8Array {
167
+ if (depth === 8) return data;
168
+ if (depth === 16) {
169
+ const out = new Uint8Array(data.length / 2);
170
+ for (let i = 0; i < out.length; i++) out[i] = data[i * 2]!;
171
+ return out;
172
+ }
173
+ const out = new Uint8Array(width * height);
174
+ const stride = rowBytes(width, 1);
175
+ for (let y = 0; y < height; y++) {
176
+ for (let x = 0; x < width; x++) {
177
+ out[y * width + x] = data[y * stride + (x >> 3)]! & (0x80 >> (x & 7)) ? 0 : 255;
178
+ }
179
+ }
180
+ return out;
181
+ }
182
+
183
+ /**
184
+ * Decodes `count` planes stored back to back after a single compression type, as 8-bit samples.
185
+ * The composite image is stored this way, and so is each layer channel (with a count of 1).
186
+ */
187
+ async function readPlanes(r: Reader, end: number, count: number, width: number, height: number, header: Header): Promise<Uint8Array[]> {
188
+ const { depth } = header;
189
+ if (depth !== 1 && depth !== 8 && depth !== 16) throw new Error(`Decoding ${depth}-bit images is not supported`);
190
+ const compression = r.uint16();
191
+ if (width === 0 || height === 0) return Array.from({ length: count }, () => new Uint8Array());
192
+
193
+ const stride = rowBytes(width, depth);
194
+ const planeBytes = stride * height;
195
+ let planes: Uint8Array[];
196
+ switch (compression) {
197
+ case 0:
198
+ planes = Array.from({ length: count }, () => r.bytesView(planeBytes));
199
+ break;
200
+ case 1: {
201
+ // Every row's byte count comes first, for all planes.
202
+ const counts = Array.from({ length: count * height }, () => (header.isBig ? r.uint32() : r.uint16()));
203
+ planes = Array.from({ length: count }, (_, c) => unpackBits(r, counts.slice(c * height, (c + 1) * height), stride));
204
+ break;
205
+ }
206
+ case 2:
207
+ case 3: {
208
+ const data = await inflate(r.bytesView(end - r.pos));
209
+ planes = Array.from({ length: count }, (_, c) => data.subarray(c * planeBytes, (c + 1) * planeBytes));
210
+ if (compression === 3) for (const plane of planes) unpredict(plane, width, height, depth);
211
+ break;
212
+ }
213
+ default:
214
+ throw new Error(`Unknown compression type ${compression}`);
215
+ }
216
+ return planes.map((plane) => to8Bit(plane, depth, width, height));
217
+ }
218
+
219
+ /** Decodes a single layer channel. */
220
+ const readLayerChannel = async (reader: Reader, channel: ChannelInfo, width: number, height: number, header: Header) =>
221
+ (await readPlanes(reader.at(channel.offset), channel.offset + channel.length, 1, width, height, header))[0]!;
222
+
223
+ /** Converts a cyan, magenta or yellow ink amount and the black amount to the matching RGB component. */
224
+ const inkToRgb = (ink: number, k: number) => Math.min(Math.max((65535 - (ink * (255 - k) + (k << 8))) >> 8, 0), 255);
225
+
226
+ /** Converts 8-bit encoded Lab (L 0-255 for 0-100, a and b offset by 128) to sRGB, using a D65 white point. */
227
+ export function labToRgb(l: number, a: number, b: number): [number, number, number] {
228
+ const fy = ((l * 100) / 255 + 16) / 116;
229
+ const fx = fy + (a - 128) / 500;
230
+ const fz = fy - (b - 128) / 200;
231
+ const inverse = (t: number) => (t > 6 / 29 ? t ** 3 : 3 * (6 / 29) ** 2 * (t - 4 / 29));
232
+ const [x, y, z] = [0.95047 * inverse(fx), inverse(fy), 1.08883 * inverse(fz)];
233
+ const gamma = (v: number) => {
234
+ const c = v > 0.0031308 ? 1.055 * v ** (1 / 2.4) - 0.055 : 12.92 * v;
235
+ return Math.round(Math.min(Math.max(c, 0), 1) * 255);
236
+ };
237
+ return [
238
+ gamma(3.2406 * x - 1.5372 * y - 0.4986 * z),
239
+ gamma(-0.9689 * x + 1.8758 * y + 0.0415 * z),
240
+ gamma(0.0557 * x - 0.204 * y + 1.057 * z),
241
+ ];
242
+ }
243
+
244
+ /** The flattened composite image stored at the end of the file. */
245
+ export class CompositeImage {
246
+ readonly #reader: Reader;
247
+ readonly #header: Header;
248
+ readonly #resources: () => Resources;
249
+
250
+ constructor(reader: Reader, header: Header, resources: () => Resources) {
251
+ this.#reader = reader;
252
+ this.#header = header;
253
+ this.#resources = resources;
254
+ }
255
+
256
+ get width(): number {
257
+ return this.#header.width;
258
+ }
259
+
260
+ get height(): number {
261
+ return this.#header.height;
262
+ }
263
+
264
+ /**
265
+ * Decodes the pixels. Photoshop only stores a full composite when "Maximize Compatibility"
266
+ * is enabled; otherwise this is blank. Each call decodes again and returns new pixels, which
267
+ * aren't kept, so hold on to the result if you need it more than once.
268
+ */
269
+ async decode(): Promise<RGBAImage> {
270
+ const header = this.#header;
271
+ const { width, height, channels: count } = header;
272
+ const model = colorModel(header, this.#resources);
273
+ const r = this.#reader.at(this.#reader.pos);
274
+ const planes = await readPlanes(r, r.bytes.length, count, width, height, header);
275
+
276
+ const channels = new Map(planes.slice(0, model.colorCount).entries());
277
+ // A single extra channel is transparency; more than that are saved selections and spot colors.
278
+ if (count === model.colorCount + 1) channels.set(-1, planes[model.colorCount]!);
279
+ return { width, height, data: toRgba(model, channels, width * height) };
280
+ }
281
+
282
+ async toPng(): Promise<Uint8Array> {
283
+ return encodePng(await this.decode());
284
+ }
285
+ }
286
+
287
+ /** A layer's pixels and user mask. */
288
+ export class LayerImage {
289
+ readonly #layer: Layer;
290
+ readonly #reader: Reader;
291
+ readonly #resources: () => Resources;
292
+
293
+ constructor(layer: Layer, reader: Reader, resources: () => Resources) {
294
+ this.#layer = layer;
295
+ this.#reader = reader;
296
+ this.#resources = resources;
297
+ }
298
+
299
+ get width(): number {
300
+ return this.#layer.width;
301
+ }
302
+
303
+ get height(): number {
304
+ return this.#layer.height;
305
+ }
306
+
307
+ /** Whether the layer has a user (pixel) mask. */
308
+ get hasMask(): boolean {
309
+ return this.#layer.mask !== undefined && this.#layer.channels.some((c) => c.id === -2);
310
+ }
311
+
312
+ /**
313
+ * Decodes the layer pixels. The mask is not applied; see `decodeMask()`. Like the composite,
314
+ * each call decodes again and the pixels aren't kept.
315
+ */
316
+ async decode(): Promise<RGBAImage> {
317
+ const { header, width, height } = this.#layer;
318
+ const model = colorModel(header, this.#resources);
319
+ const planes = new Map<number, Uint8Array>();
320
+ for (const channel of this.#layer.channels) {
321
+ if (channel.id < -1) continue;
322
+ planes.set(channel.id, await readLayerChannel(this.#reader, channel, width, height, header));
323
+ }
324
+ return { width, height, data: toRgba(model, planes, width * height) };
325
+ }
326
+
327
+ /** Decodes the user mask as grayscale, positioned at `layer.mask`. */
328
+ async decodeMask(): Promise<GrayImage | undefined> {
329
+ const { mask, channels, header } = this.#layer;
330
+ const channel = channels.find((c) => c.id === -2);
331
+ if (!mask || !channel) return undefined;
332
+ return { width: mask.width, height: mask.height, data: await readLayerChannel(this.#reader, channel, mask.width, mask.height, header) };
333
+ }
334
+
335
+ async toPng(): Promise<Uint8Array> {
336
+ return encodePng(await this.decode());
337
+ }
338
+ }
package/src/index.ts ADDED
@@ -0,0 +1,38 @@
1
+ export { PSD, type Header } from './psd.ts';
2
+ export { GroupNode, LayerNode, RootNode, type ChildNode, type CompRef, type Node } from './nodes.ts';
3
+ export {
4
+ Layer,
5
+ BLEND_MODES,
6
+ type BlendMode,
7
+ type BlendingRange,
8
+ type BlendingRanges,
9
+ type ChannelInfo,
10
+ type GlobalMask,
11
+ type InfoBlock,
12
+ type Mask,
13
+ } from './layer.ts';
14
+ export type { LayerInfo } from './layer-info.ts';
15
+ export { descriptorColor } from './layer-styles.ts';
16
+ export type {
17
+ Bevel,
18
+ ColorOverlay,
19
+ Glow,
20
+ Gradient,
21
+ GradientOverlay,
22
+ GradientStop,
23
+ LayerStyles,
24
+ PatternOverlay,
25
+ RGB,
26
+ Satin,
27
+ Shadow,
28
+ Stroke,
29
+ } from './layer-styles.ts';
30
+ export { TypeTool, type RGBA, type TextAlignment, type TextRun, type Transform } from './type-tool.ts';
31
+ export { CompositeImage, LayerImage, type GrayImage, type RGBAImage } from './image.ts';
32
+ export { encodePng, type Pixels } from './png.ts';
33
+ export { Resources } from './resources.ts';
34
+ export type { Bounds, Guide, LayerComp, ResolutionInfo, ResourceBlock, SavedPath, Slice, Slices } from './resources.ts';
35
+ export type { Descriptor, DescriptorClass, UnitValue } from './descriptor.ts';
36
+ export type { PathPoint, PathRecord } from './path-record.ts';
37
+ export { parseEngineData, type EngineDict, type EngineValue } from './engine-data.ts';
38
+ export type { SpaceColor } from './reader.ts';