Skip to content

Commit 1f7f7b4

Browse files
tonyfreemantonyfreeman
committed
[FIXME] Bundle header files to omit extra build args and support dev on macOS
1 parent 2f81486 commit 1f7f7b4

File tree

7 files changed

+1521
-0
lines changed

7 files changed

+1521
-0
lines changed

‎Sources/CJavaScriptCore/include/JavaScriptCore/JSBase.h‎

Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
1+
/*
2+
* Copyright (C) 2006 Apple Computer, Inc. All rights reserved.
3+
*
4+
* Redistribution and use in source and binary forms, with or without
5+
* modification, are permitted provided that the following conditions
6+
* are met:
7+
* 1. Redistributions of source code must retain the above copyright
8+
* notice, this list of conditions and the following disclaimer.
9+
* 2. Redistributions in binary form must reproduce the above copyright
10+
* notice, this list of conditions and the following disclaimer in the
11+
* documentation and/or other materials provided with the distribution.
12+
*
13+
* THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14+
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15+
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16+
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17+
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18+
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19+
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20+
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21+
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22+
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23+
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24+
*/
25+
26+
#ifndef JSBase_h
27+
#define JSBase_h
28+
29+
#ifndef __cplusplus
30+
#include <stdbool.h>
31+
#endif
32+
33+
#ifdef __OBJC__
34+
#import <Foundation/Foundation.h>
35+
#endif
36+
37+
/* JavaScript engine interface */
38+
39+
/*! @typedef JSContextGroupRef A group that associates JavaScript contexts with one another. Contexts in the same group may share and exchange JavaScript objects. */
40+
typedef const struct OpaqueJSContextGroup* JSContextGroupRef;
41+
42+
/*! @typedef JSContextRef A JavaScript execution context. Holds the global object and other execution state. */
43+
typedef const struct OpaqueJSContext* JSContextRef;
44+
45+
/*! @typedef JSGlobalContextRef A global JavaScript execution context. A JSGlobalContext is a JSContext. */
46+
typedef struct OpaqueJSContext* JSGlobalContextRef;
47+
48+
/*! @typedef JSStringRef A UTF16 character buffer. The fundamental string representation in JavaScript. */
49+
typedef struct OpaqueJSString* JSStringRef;
50+
51+
/*! @typedef JSClassRef A JavaScript class. Used with JSObjectMake to construct objects with custom behavior. */
52+
typedef struct OpaqueJSClass* JSClassRef;
53+
54+
/*! @typedef JSPropertyNameArrayRef An array of JavaScript property names. */
55+
typedef struct OpaqueJSPropertyNameArray* JSPropertyNameArrayRef;
56+
57+
/*! @typedef JSPropertyNameAccumulatorRef An ordered set used to collect the names of a JavaScript object's properties. */
58+
typedef struct OpaqueJSPropertyNameAccumulator* JSPropertyNameAccumulatorRef;
59+
60+
61+
/* JavaScript data types */
62+
63+
/*! @typedef JSValueRef A JavaScript value. The base type for all JavaScript values, and polymorphic functions on them. */
64+
typedef const struct OpaqueJSValue* JSValueRef;
65+
66+
/*! @typedef JSObjectRef A JavaScript object. A JSObject is a JSValue. */
67+
typedef struct OpaqueJSValue* JSObjectRef;
68+
69+
/* JavaScript symbol exports */
70+
/* These rules should stay the same as in WebKit2/Shared/API/c/WKBase.h */
71+
72+
#undef JS_EXPORT
73+
#if defined(JS_NO_EXPORT)
74+
#define JS_EXPORT
75+
#elif defined(__GNUC__) && !defined(__CC_ARM) && !defined(__ARMCC__)
76+
#define JS_EXPORT __attribute__((visibility("default")))
77+
#elif defined(WIN32) || defined(_WIN32) || defined(_WIN32_WCE) || defined(__CC_ARM) || defined(__ARMCC__)
78+
#if defined(BUILDING_JavaScriptCore) || defined(STATICALLY_LINKED_WITH_JavaScriptCore)
79+
#define JS_EXPORT __declspec(dllexport)
80+
#else
81+
#define JS_EXPORT __declspec(dllimport)
82+
#endif
83+
#else /* !defined(JS_NO_EXPORT) */
84+
#define JS_EXPORT
85+
#endif /* defined(JS_NO_EXPORT) */
86+
87+
/* JS tests uses WTF but has no config.h, so we need to set the export defines here. */
88+
#ifndef WTF_EXPORT_PRIVATE
89+
#define WTF_EXPORT_PRIVATE JS_EXPORT
90+
#endif
91+
92+
#ifdef __cplusplus
93+
extern "C" {
94+
#endif
95+
96+
/* Script Evaluation */
97+
98+
/*!
99+
@function JSEvaluateScript
100+
@abstract Evaluates a string of JavaScript.
101+
@param ctx The execution context to use.
102+
@param script A JSString containing the script to evaluate.
103+
@param thisObject The object to use as "this," or NULL to use the global object as "this."
104+
@param sourceURL A JSString containing a URL for the script's source file. This is only used when reporting exceptions. Pass NULL if you do not care to include source file information in exceptions.
105+
@param startingLineNumber An integer value specifying the script's starting line number in the file located at sourceURL. This is only used when reporting exceptions. The value is one-based, so the first line is line 1 and invalid values are clamped to 1.
106+
@param exception A pointer to a JSValueRef in which to store an exception, if any. Pass NULL if you do not care to store an exception.
107+
@result The JSValue that results from evaluating script, or NULL if an exception is thrown.
108+
*/
109+
JS_EXPORT JSValueRef JSEvaluateScript(JSContextRef ctx, JSStringRef script, JSObjectRef thisObject, JSStringRef sourceURL, int startingLineNumber, JSValueRef* exception);
110+
111+
/*!
112+
@function JSCheckScriptSyntax
113+
@abstract Checks for syntax errors in a string of JavaScript.
114+
@param ctx The execution context to use.
115+
@param script A JSString containing the script to check for syntax errors.
116+
@param sourceURL A JSString containing a URL for the script's source file. This is only used when reporting exceptions. Pass NULL if you do not care to include source file information in exceptions.
117+
@param startingLineNumber An integer value specifying the script's starting line number in the file located at sourceURL. This is only used when reporting exceptions. The value is one-based, so the first line is line 1 and invalid values are clamped to 1.
118+
@param exception A pointer to a JSValueRef in which to store a syntax error exception, if any. Pass NULL if you do not care to store a syntax error exception.
119+
@result true if the script is syntactically correct, otherwise false.
120+
*/
121+
JS_EXPORT bool JSCheckScriptSyntax(JSContextRef ctx, JSStringRef script, JSStringRef sourceURL, int startingLineNumber, JSValueRef* exception);
122+
123+
/*!
124+
@function JSGarbageCollect
125+
@abstract Performs a JavaScript garbage collection.
126+
@param ctx The execution context to use.
127+
@discussion JavaScript values that are on the machine stack, in a register,
128+
protected by JSValueProtect, set as the global object of an execution context,
129+
or reachable from any such value will not be collected.
130+
131+
During JavaScript execution, you are not required to call this function; the
132+
JavaScript engine will garbage collect as needed. JavaScript values created
133+
within a context group are automatically destroyed when the last reference
134+
to the context group is released.
135+
*/
136+
JS_EXPORT void JSGarbageCollect(JSContextRef ctx);
137+
138+
#ifdef __cplusplus
139+
}
140+
#endif
141+
142+
/* Enable the Objective-C API for platforms with a modern runtime. */
143+
#if !defined(JSC_OBJC_API_ENABLED)
144+
#ifndef JSC_OBJC_API_AVAILABLE_MAC_OS_X_1080
145+
#define JSC_OBJC_API_ENABLED (defined(__clang__) && defined(__APPLE__) && ((defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED >= 1090 && !defined(__i386__)) || (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE)))
146+
#else
147+
#define JSC_OBJC_API_ENABLED (defined(__clang__) && defined(__APPLE__) && ((defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED >= 1080 && !defined(__i386__)) || (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE)))
148+
#endif
149+
#endif
150+
151+
#endif /* JSBase_h */

‎Sources/CJavaScriptCore/include/JavaScriptCore/JSContextRef.h‎

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
/*
2+
* Copyright (C) 2006 Apple Computer, Inc. All rights reserved.
3+
*
4+
* Redistribution and use in source and binary forms, with or without
5+
* modification, are permitted provided that the following conditions
6+
* are met:
7+
* 1. Redistributions of source code must retain the above copyright
8+
* notice, this list of conditions and the following disclaimer.
9+
* 2. Redistributions in binary form must reproduce the above copyright
10+
* notice, this list of conditions and the following disclaimer in the
11+
* documentation and/or other materials provided with the distribution.
12+
*
13+
* THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14+
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15+
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16+
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17+
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18+
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19+
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20+
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21+
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22+
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23+
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24+
*/
25+
26+
#ifndef JSContextRef_h
27+
#define JSContextRef_h
28+
29+
#include <JavaScriptCore/JSObjectRef.h>
30+
#include <JavaScriptCore/JSValueRef.h>
31+
#include <JavaScriptCore/WebKitAvailability.h>
32+
33+
#ifndef __cplusplus
34+
#include <stdbool.h>
35+
#endif
36+
37+
#ifdef __cplusplus
38+
extern "C" {
39+
#endif
40+
41+
/*!
42+
@function
43+
@abstract Creates a JavaScript context group.
44+
@discussion A JSContextGroup associates JavaScript contexts with one another.
45+
Contexts in the same group may share and exchange JavaScript objects. Sharing and/or exchanging
46+
JavaScript objects between contexts in different groups will produce undefined behavior.
47+
When objects from the same context group are used in multiple threads, explicit
48+
synchronization is required.
49+
@result The created JSContextGroup.
50+
*/
51+
JS_EXPORT JSContextGroupRef JSContextGroupCreate() CF_AVAILABLE(10_6, 7_0);
52+
53+
/*!
54+
@function
55+
@abstract Retains a JavaScript context group.
56+
@param group The JSContextGroup to retain.
57+
@result A JSContextGroup that is the same as group.
58+
*/
59+
JS_EXPORT JSContextGroupRef JSContextGroupRetain(JSContextGroupRef group) CF_AVAILABLE(10_6, 7_0);
60+
61+
/*!
62+
@function
63+
@abstract Releases a JavaScript context group.
64+
@param group The JSContextGroup to release.
65+
*/
66+
JS_EXPORT void JSContextGroupRelease(JSContextGroupRef group) CF_AVAILABLE(10_6, 7_0);
67+
68+
/*!
69+
@function
70+
@abstract Creates a global JavaScript execution context.
71+
@discussion JSGlobalContextCreate allocates a global object and populates it with all the
72+
built-in JavaScript objects, such as Object, Function, String, and Array.
73+
74+
In WebKit version 4.0 and later, the context is created in a unique context group.
75+
Therefore, scripts may execute in it concurrently with scripts executing in other contexts.
76+
However, you may not use values created in the context in other contexts.
77+
@param globalObjectClass The class to use when creating the global object. Pass
78+
NULL to use the default object class.
79+
@result A JSGlobalContext with a global object of class globalObjectClass.
80+
*/
81+
JS_EXPORT JSGlobalContextRef JSGlobalContextCreate(JSClassRef globalObjectClass) CF_AVAILABLE(10_5, 7_0);
82+
83+
/*!
84+
@function
85+
@abstract Creates a global JavaScript execution context in the context group provided.
86+
@discussion JSGlobalContextCreateInGroup allocates a global object and populates it with
87+
all the built-in JavaScript objects, such as Object, Function, String, and Array.
88+
@param globalObjectClass The class to use when creating the global object. Pass
89+
NULL to use the default object class.
90+
@param group The context group to use. The created global context retains the group.
91+
Pass NULL to create a unique group for the context.
92+
@result A JSGlobalContext with a global object of class globalObjectClass and a context
93+
group equal to group.
94+
*/
95+
JS_EXPORT JSGlobalContextRef JSGlobalContextCreateInGroup(JSContextGroupRef group, JSClassRef globalObjectClass) CF_AVAILABLE(10_6, 7_0);
96+
97+
/*!
98+
@function
99+
@abstract Retains a global JavaScript execution context.
100+
@param ctx The JSGlobalContext to retain.
101+
@result A JSGlobalContext that is the same as ctx.
102+
*/
103+
JS_EXPORT JSGlobalContextRef JSGlobalContextRetain(JSGlobalContextRef ctx);
104+
105+
/*!
106+
@function
107+
@abstract Releases a global JavaScript execution context.
108+
@param ctx The JSGlobalContext to release.
109+
*/
110+
JS_EXPORT void JSGlobalContextRelease(JSGlobalContextRef ctx);
111+
112+
/*!
113+
@function
114+
@abstract Gets the global object of a JavaScript execution context.
115+
@param ctx The JSContext whose global object you want to get.
116+
@result ctx's global object.
117+
*/
118+
JS_EXPORT JSObjectRef JSContextGetGlobalObject(JSContextRef ctx);
119+
120+
/*!
121+
@function
122+
@abstract Gets the context group to which a JavaScript execution context belongs.
123+
@param ctx The JSContext whose group you want to get.
124+
@result ctx's group.
125+
*/
126+
JS_EXPORT JSContextGroupRef JSContextGetGroup(JSContextRef ctx) CF_AVAILABLE(10_6, 7_0);
127+
128+
/*!
129+
@function
130+
@abstract Gets the global context of a JavaScript execution context.
131+
@param ctx The JSContext whose global context you want to get.
132+
@result ctx's global context.
133+
*/
134+
JS_EXPORT JSGlobalContextRef JSContextGetGlobalContext(JSContextRef ctx) CF_AVAILABLE(10_7, 7_0);
135+
136+
/*!
137+
@function
138+
@abstract Gets a copy of the name of a context.
139+
@param ctx The JSGlobalContext whose name you want to get.
140+
@result The name for ctx.
141+
@discussion A JSGlobalContext's name is exposed for remote debugging to make it
142+
easier to identify the context you would like to attach to.
143+
*/
144+
JS_EXPORT JSStringRef JSGlobalContextCopyName(JSGlobalContextRef ctx);
145+
146+
/*!
147+
@function
148+
@abstract Sets the remote debugging name for a context.
149+
@param ctx The JSGlobalContext that you want to name.
150+
@param name The remote debugging name to set on ctx.
151+
*/
152+
JS_EXPORT void JSGlobalContextSetName(JSGlobalContextRef ctx, JSStringRef name);
153+
154+
#ifdef __cplusplus
155+
}
156+
#endif
157+
158+
#endif /* JSContextRef_h */

0 commit comments

Comments
 (0)